Actions Reference

Actions are commands you insert into a node's sequence (via the Sequence Editor) or attach to a node directly (via the Properties Panel). They control characters, audio, camera, backgrounds, and game logic during an interaction.

Each action runs in order — the next action starts only after the current one finishes. Use Delay to add pauses between actions.

Character Actions

Character Enter

Brings a character onto the VN stage with a fade-in animation.

Parameter Description Default
Character The actor to place on stage (required)
Standing Image Override the character's default standing image Actor's vnStanding image
Position Where to place the character: Left, Center, Right, or Custom Center
Custom X / Y Manual position as % of stage width/height (only shown when Position is Custom) 50% / 0%
Scale Character size multiplier 1.0 (range: 0.3 - 3.0)
Display Name Override the character's name shown in dialogue Actor name
Skip Cut-in Skip the entrance cut-in animation if one is configured Off

When Position is set to Custom, you can drag the character directly on stage while the Sequence Editor is open to set the coordinates visually.

Character Move

Repositions a character that is already on stage. The character animates smoothly from its current position to the new one.

Parameter Description Default
Character The actor to move (required)
X / Y Target position as % of stage width/height Current position
Scale New size multiplier Current scale
Expression Optionally change expression during the move No change

Set position by dragging the character on stage during editing. The editor shows the current coordinates as read-only labels.

Character Exit

Removes a character from the VN stage with a fade-out animation (600ms).

Parameter Description
Character The actor to remove (required)

Expression

Changes a character's displayed expression (portrait/sprite swap).

Parameter Description
Character The actor whose expression to change
Expression Select from the actor's expression grid

The expression grid shows all expressions from the actor's current expression group. If no expressions are configured for the actor, this action has no effect.

Audio Actions