TGDirector

Save a scene. Restore it perfectly. Film another take. TGDirector captures complete game state snapshots — every actor's position, inventory, health, look direction, every entity, every vehicle, the weather, the time of day — and restores them to pixel-perfect accuracy. Built for Rust machinima production.

No more manually repositioning actors, refilling inventories, or waiting for the right lighting. Save your scene, film your shot, restore, do it again. Every take starts from the exact same state.

Why This Exists

Filming in Rust means wrangling volunteers. Getting 10 people back to their exact positions, re-equipping their inventories, resetting the time of day, and re-staging every entity between takes is painful. TGDirector does all of it in one command.

• Pixel-perfect restoration — uses Rust's native protobuf serialization. Entities are restored byte-for-byte, not approximated.
• Full actor state — position, rotation, look direction, health, wounded state, inventory (including weapon mods and ammo), active held item, vehicle mount, crouching posture. Everything.
• Environment capture — time of day, weather (fog, rain, wind) saved and restored. Consistent lighting across every take.
• Undo system — every restore auto-creates a pre-restore snapshot. Changed your mind? Undo back to before the restore.
• Zero dependencies — drop it in and go.

What Gets Saved

Actors

Entities

• Buildings — all building blocks, doors, locks, code locks
• Containers — boxes, vending machines, furnaces — full inventory preserved
• Deployables — sleeping bags, turrets, workbenches, signs, decor
• Vehicles — cars, boats, helicopters — fuel, seat state, momentum
• Fire & smoke — optional capture with -fire flag

Environment

• Time of day
• Fog, rain, and wind intensity

Smart Restore

• Diff-based — compares current entity state to saved state. Unchanged entities are skipped entirely — only recreates what actually changed.
• Three-phase cleanup — kills changed entities, then sweeps debris and loot bags, then cleans up any gibs spawned during recreation. Zero junk after restore.
• Selective restore — restore only actors, only entities, or a specific actor by name.
• Building-aware — captures entire buildings even if parts extend outside the save radius.

Crew System

Grant players the tgdirector.crew permission and they become invisible to the save system. Camera operators, spectators, and crew are never captured or restored — only actors are.

Scene Visualization

• Preview — cyan wireframe sphere showing capture radius with entity/player count
• Show — visualize a saved scene in-world: yellow radius sphere, colored dots for actors (green/orange/red for alive/wounded/dead), name labels, cyan arrows showing look direction
• Compare — diff report showing what changed since save: unchanged entities, modified entities, destroyed entities, new debris, actor movement

Admin Panel

• Scene browser — scrollable list of all saved scenes, sortable by name or date
• Detail view — scene metadata, actor roster, entity count, environment snapshot
• One-click actions — restore, teleport to scene, or delete with confirmation modal
• Quick save — name and radius inputs with live actor roster showing who's in range

Permissions

Commands

All commands work as chat commands or F1 console commands (use director instead of /director in console).

Configuration

Support

• For all questions and feedback, dm me (1928tommygun) on my discord at discord.fragmod.com

License

TOMMYGUN'S EULA – BY USING THIS PLUGIN YOU AGREE TO THE FOLLOWING!

• Code contained in this file is not licensed to be copied, shared, resold, or modified in any way.
• You may copy the plugin freely to each server instance that your organization owns.
• Do not share this plugin with other server organizations — they must purchase their own licenses.