Copyright © 2025-2026 Candy ArtsWhile
The While command runs a Command repeatedly as long as its condition is true, evaluating it before each iteration. As a safeguard against infinite loops, it stops after while_safety_break iterations, set in Candy_Properties.gd (0 disables the limit).
Keys
Every key also accepts a ¢ expression instead of a fixed value, unless its description says otherwise. See CandyRef Expressions.
Condition
Description:
The test evaluated before each iteration; Commands runs as long as it is true. It must start with ¢: plain text is rejected as an error, so that a missing symbol can't silently pass the test. A condition that fails to evaluate is reported, and ends the loop as a false condition would.
Values:
• ¢ expression: Such as ¢globals.tries < 3.
Type
Description:
The name of the Command contained in Commands. Candy Dialogue Creator reads it to select the Command to edit; Candy Dialogue Engine only prints it in debug messages.
Values:
• Command name: Such as Set.
Commands
Description:
The Command to run on each iteration, as a Dictionary with the Command's name as key and its keys as value, such as {"Set": {...}}. A Dictionary can only contain each Command name once, so to run several Commands, place them in a Block and Bridge to it. This key isn't evaluated.
Values:
• Command: Any Command, with its own keys.