Copyright © 2025-2026 Candy ArtsExport
The Export command saves variables to a file, each stored under its own name, so they can be restored later with Import. It can also write a Dialogue file.
Keys
Every key also accepts a ¢ expression instead of a fixed value, unless its description says otherwise. See CandyRef Expressions.
Data
Description:
The variables to save, each stored under its own name. Commas inside brackets or quotes don't separate entries.
Values:
• Variable paths: A comma-separated list, written without ¢, such as globals.gold, globals.hp.
Format
Description:
The file format. The value is case-insensitive, and a leading dot is ignored.
Values:
• json
• txt
• csv
• cfg or ini
• bin
• b64 or base64
• tres or res
• dialogue: A Dialogue file. Data must contain exactly one Dictionary.
• Empty: Not valid. An error is reported, and nothing is written.
File
Description:
The file name, without extension. Characters that aren't valid in file names are replaced with _.
Values:
• File name
• Empty: Don't leave it empty. The file would be saved with no name, only its extension.
Path
Description:
The folder to write to, which is created if it doesn't exist.
Values:
• Folder path: A res:// or user:// path.
• Empty: export_folder (Candy_Properties.gd).
Method
Description:
The action taken when the file already exists. The value is case-sensitive.
Values:
• Overwrite: Replace the file.
• Skip: Don't write anything.
• Duplicate: Write to File(1) instead.
• Timestamp: Write to File_<date-time> instead.
• Empty: Not valid when the file already exists. An error is reported, and nothing is written.