AutoSave
Editor extension that periodically auto-saves the level scene tree and provides a restore dialog on unclean exits. Saves to `/settings/editor/autosaves/<levelName>/`.
Editor extension that periodically auto-saves the level scene tree and provides a restore dialog on unclean exits. Saves to /settings/editor/autosaves/<levelName>/.
Public Functions
| Function | Description |
|---|---|
M.onEditorInitialized() | Initializes timer and registers menu item |
M.onEditorGui(dtReal, dtSim, dtRaw) | Handles autosave countdown and restore dialog |
M.onEditorRegisterPreferences(prefsRegistry) | Registers autosave preferences |
M.onEditorPreferenceValueChanged(path, value) | Responds to preference changes |
Key Features
- Timed Auto-Save - Saves scene tree at configurable interval
- Countdown Notice - Status bar warning before save occurs
- Crash Recovery - Modal dialog on startup if previous session crashed
- Restore Selection - Browse and select from available autosaves
- Backup on Manual Save - Optional backup copy on explicit Save Level
Preferences
| Preference | Type | Default | Description |
|---|---|---|---|
files.autoSave.active | bool | false | Enable/disable auto-save |
files.autoSave.saveBackupCopy | bool | false | Backup on manual save |
files.autoSave.interval | int | 120 | Seconds between auto-saves |
files.autoSave.noticeInterval | int | 10 | Countdown warning seconds |
files.autoSave.maxAutoSaveCountPerSession | int | 3 | Max saves before overwrite |
files.autoSave.counter | int | 1 | Current autosave counter (hidden) |
Restore Workflow
- On editor start, checks
general.internal.cleanExitpreference - If unclean exit detected and autosaves exist, shows restore dialog
- User selects an autosave timestamp
- Confirmation dialog warns about scene tree overwrite
- Restores by copying autosave folder to level path and reopening level
See Also
- globals - Editor preferences system
Audio Ribbon Editor
Editor tool for placing dynamic audio emitter ribbons in the 3D world. Ribbons define spatial zones where audio events play directionally (quad emitters) or as single ambient sources. Supports surface
Barriers Editor
Editor tool for selecting and managing barrier prefabs in levels. Provides visual 3D sphere display of barrier positions, two-column selection UI, and integration with the Race Editor for assigning ba