Copyright © 2025-2026 Candy ArtsVN Effect Wait
The VN_Effect_Wait command pauses the Dialogue until each listed bust effect has played for the duration set by its Wait_Loops and Wait_Time, or has stopped. It waits for playback that was started without a wait, a few Lines later for example. An effect that isn't playing doesn't delay the Dialogue. It is accepted even on a VN Scene that another Engine owns or holds, since it doesn't control the scene: it only delays this Dialogue.
Keys
Every key also accepts a ¢ expression instead of a fixed value, unless its description says otherwise. See CandyRef Expressions.
Actors
Description:
The Actors the command acts on, each on a bust of the VN Scene. Each key is an Actor, and its value is a Dictionary of settings for that Actor (see below), or an empty Dictionary for none. List every Actor by name: there is no shorthand for all Actors. The Engine reports an entry it can't find and skips it, without affecting the others.
Values:
• Actor Reference: A key of the actors dictionary, such as Alice.
• °role: The Actor currently assigned to that Role, such as °guard.
Actor Settings
Each Actor in Actors lists its effects under the following key.
Effects
Description:
The effects the command acts on, for this Actor. Each key is the name of the animation the effect plays, and its value is a Dictionary of settings for that effect (see below), or an empty Dictionary for none.
Values:
• Animation name: An animation of the AnimationLibrary set in Library, such as Shake.
• Library/Name: When Library is empty, an animation already available on one of the Actor's AnimationPlayers.
Effect Settings
Each effect in Effects accepts the following keys.
Wait_Loops
Description:
The number of completed loops the Dialogue waits for before resuming. The Dialogue resumes after Wait_Loops loops plus Wait_Time into the following loop, or earlier if playback ends or is stopped. When several entries of the Line set a wait, the Dialogue resumes once every one of them has reached its wait.
Values:
• 0: Don't wait for any loops. If Wait_Time is also 0, the Dialogue doesn't wait at all.
• Positive number: The number of loops to wait for.
Wait_Time
Description:
The additional time the Dialogue waits after Wait_Loops, measured into the following loop. A time longer than the media carries over into additional loops.
Values:
• Number of seconds: Such as 2.5.
• Timestamp: In the format SS.xx, MM:SS.xx or HH:MM:SS.xx, such as 01:30.5.
• f=N: N frames, counted on the animation's own frames, otherwise at FPS.
• 0 or empty: No additional wait.
FPS
Description:
The frame rate at which f= values are counted in animations that have no frames of their own. An animation's frames are the keys of its most-keyed discrete track, or its step value.
Values:
• Frames per second: Such as 12.
• Empty: The default frame rate, default_effect_fps.
Library
Description:
Only required to distinguish two effects with the same name on one Actor. When empty, the effect's name matches the Actor's effect of that name, whichever library it comes from.
Values:
• Library name: The library containing the effect's animation.
• Empty: The Actor's effect with that name.