Copyright © 2025-2026 Candy ArtsDialogue Mode
The Dialogue_Mode command changes how the Engine displays Spoken Lines: in the dialogue box, as subtitles, in the chat, in speech bubbles, and so on. The change applies from the next Line and, by default, is reverted when the Dialogue ends; a mode set on an Actor or a Line still takes precedence. Whatever the previous mode displayed is cleared when the next Spoken Line appears.
Keys
Every key also accepts a ¢ expression instead of a fixed value, unless its description says otherwise. See CandyRef Expressions.
Mode
Description:
The Engine's Dialogue mode (dialogue_mode). See Dialogue Modes.
Values:
• Box: The dialogue box.
• Subtitles: The subtitles.
• Chat: The chat.
• Bubbles: The speaker's speech bubble, or the bubble of their VN bust when the Engine is in VN mode.
• VN_Bubbles: The speech bubble of the speaker's VN bust. Don't assign it yourself: the Engine switches Bubbles Lines to it in VN mode (see VN Bubbles Mode).
• Barks: A bark, which is displayed without pausing the Dialogue.
• Voice: Voice playback only, without displaying any text.
• Custom mode name: The name of a script in Candy_DE/Scripts/Dialogue_Modes, for a mode of your own.
• Reset (case-insensitive): Restore the value the Engine started with.
• null: Not set; the setting retains its current value.
Bubbles_Exempt_Mode
Description:
The mode applied to speakers without a speech bubble while the Dialogue mode is Bubbles (bubbles_exempt_mode).
Values:
• Box: The dialogue box.
• Subtitles: The subtitles.
• Chat: The chat.
• Bubbles: The speaker's speech bubble, or the bubble of their VN bust when the Engine is in VN mode.
• VN_Bubbles: The speech bubble of the speaker's VN bust. Don't assign it yourself: the Engine switches Bubbles Lines to it in VN mode (see VN Bubbles Mode).
• Barks: A bark, which is displayed without pausing the Dialogue.
• Voice: Voice playback only, without displaying any text.
• Custom mode name: The name of a script in Candy_DE/Scripts/Dialogue_Modes, for a mode of your own.
• Reset (case-insensitive): Restore the value the Engine started with.
• null: Not set; the setting retains its current value.
Revert
Description:
Whether the Command's changes are reverted when the Dialogue ends, so that the next Dialogue starts with the Engine's original settings. They are reverted at the very end of the Dialogue, whatever ended it; a Jump doesn't end the Dialogue.
Values:
• 1 or true: Revert the change when the Dialogue ends, restoring the value from before the Dialogue first changed that setting.
• 0 or false: Retain the change after the Dialogue ends, until something else changes the setting. This also cancels the reverting of any earlier change to the same setting in this Dialogue.
• null: Not set; the Engine's revert_engine_settings applies when its enable_revert_engine_settings is on, otherwise revert_engine_settings in Candy_Properties.gd, which is on by default.