Copyright © 2025-2026 Candy ArtsEngine Language
The Engine_Language command changes the language the Engine displays its Dialogue in: which language Variation of each Spoken Line is displayed, and the language of its choice menus and Input scenes. It also changes the language of the Engine's voice files, when the voice language differs from the text's. The changes apply from the next Line and, by default, are reverted when the Dialogue ends.
Keys
Every key also accepts a ¢ expression instead of a fixed value, unless its description says otherwise. See CandyRef Expressions.
Language
Description:
The Engine's language (engine_language).
Values:
• Language name: Such as French, as written in Variation names.
• Empty: Follow candy_de.language again.
• Reset (case-insensitive): Restore the value the Engine started with.
• null: Not set; the setting retains its current value.
Voice_Language
Description:
The language of the Engine's voice files (voice_language), when it differs from the language of the text. The voice file of each Spoken Line is looked up in this language, with the tags of the Variation displayed. See Voice.
Values:
• Language name: Such as Japanese, as written in Variation names, or Default for the original language.
• Empty: Follow candy_de.voice_language again, or the language of the text when that is empty too.
• 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.