For the complete documentation index, see llms.txt. This page is also available as Markdown.

Interface

Overview

The ActionSequence editor can be opened by clicking the Open button that appears when hovering over an ActionSequence instance.

Multiple ActionSequences can be opened and edited simultaneously, with each one displayed in a separate tab. This allows you to quickly switch between actions and review or compare them while working.

Notes

Changes made during play testing are not applied immediately and will take effect after restarting.

UI

UI
Description

ActionSequence Toolbar

Allows you to save your work or import/export in JSON format, and configure the visibility of each panel.

Viewport

A preview screen where you can check the results of the ActionSequence. You can review animations and direction results through timeline playback.

Timeline Toolbar

Provides key functions for timeline editing. You can add tracks, set playback duration, lock editing, toggle camera possession, switch between time/frame units, and fit the timeline to the screen.

Playback Controls

Controls timeline playback and navigation. Includes scrubbing (range start/end), keyframe/section navigation, frame-by-frame movement, play/reverse playback, playback duration settings, and loop functionality.

Track List

An area for managing tracks included in the ActionSequence.

Timeline

Displays track sections and keyframes.

Scrubber

A reference line indicating the current playback position on the timeline, which can be dragged to move to a desired point.

Track Properties

An area for editing the properties of the selected track.

ActionSequence Toolbar

Button
Description

Saves the ActionSequence. (Even if the ActionSequence is saved, data may be lost if the map is not saved.)

Applies ActionSequence JSON data

Extracts ActionSequence JSON data

Control Track Gizmo Edit Modes (Select / Move / Scale / Rotate)

Displays the preset selection popup

Shows the timeline

Shows the track property panel

Learn more about Presets

Preset

Viewport

The Viewport is an area where you can preview ActionSequence direction and control the camera. You can move, rotate, and zoom in/out using the keyboard and mouse.

Control
Description

W / A / S / D

After clicking the Viewport, press W/A/S/D, or hold right mouse click and press W/A/S/D to move the camera forward/left/backward/right.

Q / E

After clicking the Viewport, press Q/E, or hold right mouse click and press Q/E to move the camera down/up.

Shift

Hold Shift together with movement keys (W, A, S, D) to change the camera movement speed.

Right Mouse Button

Hold the right mouse button and move the mouse to rotate the camera.

Mouse Wheel Up/Down

Use the mouse wheel up/down to zoom the camera in/out.

Mouse Wheel Button

Hold the mouse wheel button and move the mouse to pan the camera.

When a Control Track references an object that inherits from PVInstance (such as a Part or Model), you can select the object in the viewport and use gizmos to edit keyframes for its position, rotation, and scale.

For more information, refer to the Control Track section in the guide below.

Track Types

Timeline Toolbar

Button
Description

Adds a track (you can add multiple tracks of the same type).

Playback Duration Setting Field

Locks editing for all tracks

Record Mode (When enabled, editing an object referenced by a Control Track using gizmos will create or update keyframes.)

Switches between editor camera and character camera view (used when previewing Camera Shake, Camera FOV, and Camera Zoom tracks).

Sets the snap interval used when editing the timeline. Click the magnet icon to enable or disable snapping. The default value is 0.0333 seconds.

Adjusts the preview playback speed in the editor. This setting does not affect runtime playback.

Provides additional editing options, including whether Control Tracks inherit scale.

Switches between time and frame units

Fit the Timeline to the Playback Duration

Playback Controls

Button
Description

Move the Scrubber to the Playback Start Position

Moves to the previous keyframe or section

Moves to the previous frame

Plays in reverse or pauses

Plays or pauses

Moves to the next frame

Moves to the next keyframe or section

Move the Scrubber to the Playback End Position

Set Playback Duration to Current Scrubber Position

Toggles loop playback

Track List

Button
Description

Toggles whether the track is enabled (when disabled, it will not play in both the editor and runtime environments).

Locks track editing

Press F2 while a track is selected to rename the track.

You can right-click a track to open a menu where you can perform actions such as cut, copy, paste, duplicate, and delete.

Timeline

The Timeline is an area that visually displays keyframes, sections, and markers placed on tracks in chronological order. You can edit the timing and flow of an action by moving elements or adjusting their duration.

The direction of the section and keyframe at the scrubber position is previewed in the Viewport.

The orange-highlighted area behind the scrubber represents a single frame. When you zoom in on the timeline, the time scale expands, but this area always represents one frame. The scrubber indicates the current position within that frame.

To quickly focus on a specific section in the timeline, hold down the Ctrl key and drag with the left mouse button over the time axis. The area between the drag start and end points becomes a selected range, allowing you to work within or review that segment. This is especially useful when you want to concentrate on a particular ActionSequence within a long timeline, and you can locate your target more efficiently by starting with a broad selection and gradually narrowing it down.

Click and drag on an empty area of the timeline to display a selection box. When the drag ends, all sections, keyframes, markers, and other elements within the selection box are selected at once.

Section

A section cannot be added like keyframes or markers, and each track has a fixed single section.

You can drag the center area of the section to move it, and drag the edges to adjust its length.

For animation and sound tracks, the Blend In/Out or Fade In/Out values can be adjusted by dragging the left and right triangular handles that appear at the top of the section when the mouse cursor hovers over it. The position of each handle determines the duration of the blending or fading interval.

Drag the start or end of a section to adjust its length. If the section is shortened beyond the source asset's length, the trimmed portion is cropped. If it is extended beyond the source asset's length, the additional portion is looped.

Sections with an Asset ID are displayed differently depending on the length of the source asset and the current section length. This visualization makes it easy to identify cropped or extended portions of the source asset.

  • 1️⃣ : Sections that match the length of the source asset are displayed without any additional indicators.

  • 2️⃣ : If the beginning of the source asset is cropped, the cropped area is darkened to indicate the excluded portion.

  • 3️⃣ : If the end of the source asset is cropped, the cropped area is darkened to indicate the excluded portion.

  • 4️⃣ : If the section is longer than the source asset, vertical lines are displayed at each point where the source asset loops, indicating the repeated sections.

Keyframe

In tracks that support keyframes, you can add a keyframe by clicking the mouse wheel button or pressing Ctrl + left click on the timeline.

You can drag keyframes to change their position.

A keyframe provides a key bar area that allows you to adjust the time between adjacent keyframes. By dragging the key bar, you can intuitively adjust the positions and spacing of neighboring keyframes.

Marker

In event tracks or collision tracks, you can add a marker by clicking the mouse wheel button or pressing Ctrl + left click on the timeline.

You can drag markers to change their position.

Each added marker has a unique key value, which is used to trigger actions at specific points by connecting to script events.

Layer Bar

When keyframes or markers exist, a layer bar is displayed. The layer bar is generated based on the start and end of all keyframes or markers within the layer, visually representing the overall range and duration.

You can drag the center area of the layer bar to move it, and drag the edges to adjust its length.

Track Property

Track Property is an area where you can view and edit the properties of the selected element.

The displayed information varies depending on the selected object. Selecting a track shows track settings, while selecting a keyframe shows the properties of that keyframe. (Selecting a section is treated the same as selecting the track.)

Shortcuts

Shortcut
Function

Ctrl + S

Save

Ctrl + Z

Undo

Ctrl + Y

Redo

Ctrl + 1

Select Tool (Control Track Gizmo Edit Modes)

Ctrl + 2

Move Tool (Control Track Gizmo Edit Modes)

Ctrl + 3

Scale Tool (Control Track Gizmo Edit Modes)

Ctrl + 4

Rotate Tool (Control Track Gizmo Edit Modes)

Spacebar

Play / Pause

(In Timeline) Ctrl + Mouse Wheel Up/Down

Zoom in/out timeline

(In Timeline) Right Mouse Drag

Move timeline horizontally

(On the timeline time axis) Ctrl + Left-click drag

The timeline zooms in based on the range between the drag start and end points.

F

Fit Timeline to Playback Duration

(With track selected) Ctrl + X

Cut track

(With track selected) Ctrl + C

Copy track

Ctrl + V

Paste track

(With track selected) Ctrl + D

Duplicate track

(With a track selected) F2

Rename track name

(After selecting track or keyframe) Delete

Delete

(On keyframe/marker-type tracks) Mouse Wheel Click or Ctrl + Left Click

Add keyframe on timeline

(When a keyframe/marker-type track is selected) Enter

Add a keyframe at the scrubber position

(Shift or Ctrl) + (Click keyframe or section)

Multi-select keyframes or sections on timeline

(Shift or Ctrl) + (Click track)

Multi-select tracks

Last updated