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 Recording page for the full workflow, including 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