Copyright © 2025-2026 Candy ArtsVN Wait
The VN_Wait command pauses the Dialogue until the playback of each listed Actor's bust 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. A bust 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 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 at FPS when the media has no frames of its own.
• 0 or empty: No additional wait.
FPS
Description:
The frame rate at which f= values are counted, for media without a frame rate of its own. SpriteFrames animations count their own frames.
Values:
• Frames per second: Such as 12.
• Empty: The media's own frame rate, otherwise the default frame rate.