The Editor
A tour of every panel in the cinematics editor. Open the editor with /cinematics after you've been granted the ACE permission.
Projects
The left rail lists saved projects. Every project stores its own timeline, recordings, world settings, interpolation mode, and scene entities.
New Project
Creates a fresh timeline. Choose a name and whether to enable the interactive tutorial. Saved to projects/<slug>.json on disk.
Autosave
Autosaves every 30 seconds (configurable). The header shows 'saving…' → 'saved' so you always know where you stand.
Export JSON
Exports the current project as a portable JSON blob. Import the blob on another server to share templates.
Delete
Removes the project file and its recording data from disk. Confirmation required — no undo.
World & Scenery
Overrides the game world while your project is active. Every setting is session-scoped — stop the editor and the world returns to the server's default.
| Setting | What It Does |
|---|---|
| Time of Day | Sets the in-game clock. Freeze holds it constant mid-shot. |
| Weather | Override with Extra Sunny, Clear, Clouds, Smog, Foggy, Overcast, Rain, Thunder, Clearing, Neutral, Snow, Blizzard, Snow Light. |
| Override server weather | Forces your weather to stick even if a weather-sync resource is running. |
| Rain Level | Manually dial rain intensity 0-1 independent of weather. |
| Lighting | Toggle city lights and force artificial lights on (useful for night shoots). |
WARNING
If a weather-sync resource is running, the panel shows a yellow "Weather/time sync resource detected" warning. Stop that resource before recording or your overrides will be fought every tick.
Interpolation
Controls how the camera moves between keyframes.
GTA Native
Engine-smooth blending. Per-keyframe easing still applies. Shadows may lag behind fast camera motion.
Eased
Linear path between keyframes with per-keyframe ease curves. Most predictable — no overshoot. Set keyframes to Ease In-Out for smooth transitions.
Cinematic (Spline)
Hermite spline through every keyframe. Organic, fluid arcs. Tension tunes snap vs. flow; Spring adds overshoot for bouncy energy.
Cinematic-only controls:
| Control | Range | Meaning |
|---|---|---|
| Tension | 0 → 1 | 0 = natural Catmull-Rom speed · 1 = eases in and out of every keyframe |
| Spring | 0 → 1 | 0 = safe, no overshoot · 1 = full spring (may clip underground on steep paths) |
Per-keyframe easing (set in the Keyframe Properties panel):
Linear · Ease In · Ease Out · Ease In-Out · Cut (Hard Jump)
Recording
The in-editor motion recorder. Captures vehicle and ped state to JSON, replays them as puppets on the timeline.
Recording Targets
Vehicles — captures model, plate, position, rotation, velocity, steering, RPM, horn, handbrake per frame. Peds — captures model, position, heading, velocity, weapon, aim/shoot/jump/climb/ragdoll state.
Radius-Based
Only entities within Config.RecordRadius of the player at the moment of scan are captured. Enter/exit radius during recording and they pop in/out.
Player Included
The recording player is captured too — drive a chase car through the shot, then step out and frame yourself as the subject.
Replay Options
Motion blur toggle on replay entities. Click a replay entity to swap its vehicle model — same motion, different car.
See the Exporting Video page for the full workflow, including Core Recorder setup and OBS capture settings.
3D Text
Place animated text into the world as a keyframeable billboard.
| Setting | Description |
|---|---|
| Text Content | Any string. Edit inline; click to re-edit. |
| Font | 50+ fonts — system fonts and Google Fonts loaded automatically. |
| Color | Hex picker. |
| Size | Scale multiplier. |
| Shadow / Glow | Additive text effects. |
| Anim In / Out | Fade Slide, Scale Up, Scale Down, Rise, Letter Pop, Typewriter, Wave, Scatter. |
| Timing | Start frame · End frame on the timeline. |
| Placement | Click Place in World → free-fly → Enter to drop it. Re-place to move. |
TIP
Typewriter + Bebas Neue + glow is the go-to for title cards. Letter Pop + Impact works for intro bumpers. Add a Color Filter (Cinematic/Desaturated) on the same frame range for a polished look.
Scene Editor
Spawn custom actors and dress the set. Everything here is independent of recorded entities — spawn a ped to stand idle while your recorded chase zips past.
Spawn
| Target | Picker |
|---|---|
| Ped | Browse by category (Ambient Male/Female, Law Enforcement, Emergency, Service Workers, Gang Members, Story Characters) or type a model hash. |
| Vehicle | Browse by class (Super, Sports, Sports Classics, Sedan, SUV, Pickup, Military, Motorcycle, Helicopter, Plane, Boat) or type a model. |
| Prop | Type any prop model name. |
Place in World drops you into free-fly placement mode — position and Enter to confirm. Re-place to move an existing entity.
Ped Options
Animation
Pick from 18 predefined animations (Lean Wall, Smoke, Phone Call, Push-ups, Guard Stand, Wave, Salute, Fishing) or enter any dict/anim pair with loop toggle.
Weapon
Give from common weapons dropdown or enter a weapon hash. Weapon is visible during playback.
Scenario
Phone, Smoking, Drinking, Coffee, Clipboard, Guard, Cop Idle, Hang Out, Lean Wall, Cheering, Janitor, Welding, Yoga.
Follow
Ped walks/runs/sprints toward a target entity. Distance clamp keeps them at a set range.
Combat AI
Ability (Poor/Average/Professional), Movement (Stationary/Defensive/Offensive/Suicidal), Range (Near/Medium/Far), Accuracy.
Health & State
Health / Armor sliders · Invincible / Ragdoll / Flee / On Fire toggles. Mix for battle scenes.
Relationship Groups
Click Relationship Matrix to set Neutral / Friendly / Hostile between every group you create. "Director" always exists (that's you). Assign peds to groups to drive combat behavior between them.
Vehicle Options
- Engine on/off
- Siren on/off
- Lights — OFF / LOW / HIGH / INT (interior)
- Doors — FL / FR / RL / RR / HOOD / TRUNK open-close
- Windows per door
- Indicators — LEFT / RIGHT / HAZARD
- Primary / Secondary Color — hex picker
- Dirt level 0-15
- Plate — custom text
- Neon — enable per-zone + color picker
Vehicle Follow
Make a spawned vehicle drive after a target. Controls:
- Target — any spawned/recorded entity
- Speed — Slow · Normal · Fast · Very Fast · Max
- Drive — Normal · Rushed · Ignore Lights · Careful
- Distance — how close to approach
Scene Controls
- Start combat / Stop combat — fires all "hostile" relationships simultaneously
- Reset scene — teleports every spawned entity back to its placement coords and restores idle state
- Delete entity — remove individually
Keyframe Properties
Click a keyframe on the timeline to reveal its property panel.
Position
Exact X/Y/Z coords and pitch/roll/yaw. Click Position Camera to go into free-fly and re-frame, or edit numbers directly.
FOV
Per-keyframe FOV 5° to 120°. Interpolates between keyframes for zoom effects.
Easing
How motion enters/exits this keyframe. Ease In-Out is the safe cinematic default.
Camera Shake
12 GTA shake presets (Hand, Small/Medium/Large Explosion, Jolt, Vibrate, Drunk, Skydiving, Drug Trip, Death Fail, Road Vibration, Motorbike) + amplitude.
Depth of Field
Near Focus, Far Focus, F-Number, Strength. Proper cinematic DoF — blur everything that's not the subject.
Motion Blur
Per-keyframe motion blur strength. Heavier blur sells fast camera moves.
Time Scale
0.1 = extreme slow-mo · 1.0 = normal · 2.0 = fast-forward. Interpolate between keyframes for ramp effects.
Color Filter
23 timecycle presets — Cinematic, Sepia, Black & White, Warm, Cold, Night Vision, Security Cam, Drug Trip, Underwater, and more.
Fade
Black or white fade-in/out with configurable duration. Perfect for intro and outro.
Letterbox
2.39:1 Anamorphic · 2.76:1 Ultra Wide · 1.85:1 Theatrical · 4:3 Classic. Hard cinema bars for instant trailer feel.
Vignette & Grain
Subtle dark edges + film grain. Dial both up for that 35mm mood.
Time Override
Override the world clock at this exact keyframe — tween from day to night across a shot.
Timeline Controls
| Control | Action |
|---|---|
| Space | Play / Stop |
| Playhead drag | Scrub through the timeline |
| Add Keyframe | Insert a keyframe at the current playhead time |
| In / Out points | Constrain playback to a sub-range (great for A/B comparing edits) |
| Ctrl+C / Ctrl+V | Copy / Paste keyframe (with all properties) |
| Ctrl+D | Duplicate keyframe to current playhead |
| Ctrl+Z / Ctrl+Y | Undo / Redo |
| Go to Start / End | First frame / last frame |
| Step forward / back | Frame-by-frame scrubbing |
| Share Camera Path | Broadcast your camera keyframes to other players' screens for collaborative framing |
Tracks
The timeline shows four tracks stacked:
- Camera — keyframes
- FX — screen effects (shake, DoF, filter, fade, letterbox, vignette, grain)
- 3D Text — each text object's in/out range
- Recording — recorded vehicles/peds, clip-trimmable