Dynamic Decals Load/Save
Editor module providing Save and Load functionality for Dynamic Decals projects. Exports/imports the layer stack as `.dyndecals.json` files with overwrite or append loading modes.
Editor module providing Save and Load functionality for Dynamic Decals projects. Exports/imports the layer stack as .dyndecals.json files with overwrite or append loading modes.
Module Info
| Key | Value |
|---|---|
| File | extensions/editor/dynamicDecals/loadSave.lua |
| logTag | editor_dynamicDecals_loadSave |
| Dependencies | editor_api_dynamicDecals, editor_dynamicDecals_notification, editor_dynamicDecals_docs |
Public API
| Function | Signature | Description |
|---|---|---|
M.getCurrentPorjectFilePath | () → string | Returns the last used project file path (note: typo in original) |
M.loadFileDialog | () | Opens file dialog to load a .dyndecals.json project |
M.saveAsFileDialog | () | Opens file dialog to save project as a new file |
M.onSerialize | () → table | Serializes lastProjectFilePath for session persistence |
M.onDeserialized | (data) | Restores last project file path from serialized data |
M.registerEditorPreferences | (prefsRegistry) | Stub |
M.editorPreferenceValueChanged | (path, value) | Stub |
M.setup | (tool_in) | Registers "Load/Save" section (priority 20) with docs link |
Loading Modes
| Mode | Key | Description |
|---|---|---|
| Overwrite | 0 | Wipes existing layer stack, replaces with loaded layers |
| Append | 1 | Adds loaded layers to the existing stack |
Modes are populated from api.loadingModes.
GUI Features
- Save as... - Opens save file dialog
- Save - Overwrites the last opened project file (disabled if no file loaded)
- Load from file - Opens load dialog with loading mode combo
Usage Example
local loadSave = extensions.editor_dynamicDecals_loadSave
-- Open load dialog
loadSave.loadFileDialog()
-- Open save-as dialog
loadSave.saveAsFileDialog()
-- Check current file
local path = loadSave.getCurrentPorjectFilePath()See Also
- Dynamic Decals - Browser - Related reference
- Dynamic Decals - Brushes - Related reference
- Dynamic Decals - Camera - Related reference
- World Editor Guide - Guide
Dynamic Decals Layer Stack
Editor module providing the Layer Stack panel for the Dynamic Decals tool. Renders the full layer hierarchy with drag-and-drop reordering, visibility toggling, layer masks, duplication, mirroring, and
Dynamic Decals Meshes
Editor module for managing the vehicle shape/mesh path in the Dynamic Decals tool. Provides a section GUI (currently commented out) for selecting a DAE shape file. Marked as experimental.