Presets & Logic
Root and Child Settings
How root usage settings, child UI logic, and presets control generated behavior.
What presets save
Presets allow users to store import behavior for a project or a specific UI style.
| Saved area | Examples |
|---|---|
| Root usage settings | Import, detach, visibility, modal/blur, close key, show-after-close, pause game, play music, music asset path. |
| Output settings | Main package name, export path, Add To Level selection, input mode, wrappers, delete-existing-generated-items option, and saved preset path. |
| Child UI logic | Click SFX, hover SFX, sliders, save text, clear text on focus, toggle behavior, load level buttons. |
| Text/font settings | Global font scale, text size-to-content, regular/RTL font handling. |
Loading a preset performs a silent hard reset first, then applies the preset. This avoids stale dropdown and package-name state from previous presets.
The preset manager can save the preset path. This helps users keep presets in a shared project folder and reuse the same preset location during future imports.
Element-level behavior options
Select a child element in the wizard to add optional behavior.
| Element type | Options |
|---|---|
| Buttons | Add click SFX, add hover SFX, close parent screen, enable/visible another widget, load level on click, toggle SFX, and button-child text hover behavior. |
| Sliders | Master volume slider, SFX volume slider, music volume slider. |
| Checkbox / toggle | Save checked state, toggle SFX, checkbox group behavior. For CHKG_ groups the first item starts checked and text labels under the group are set to remove hit test. |
| Editable text | Save text, clear text on focus. |
| Images | Fade in / fade out / blinking effect options where supported. |
| Progress bar / ScrollBox | Progress fill events and auto-scroll events where supported. |
Text children under a button can use Use flipped color on hover, Center scale on hover, and Move to Right on hover. These settings are stored in presets and generated in the button hover graph. The color flip keeps hue and uses the current HSV/SV-based hover contrast logic instead of only black/white inversion.
Root ownership and detached widgets
When a root is detached, the importer routes its related child screens into the detached WBP instead of leaving them inside the host WBP.
Loading → host WBP
MainMenu → detached WBP_MainMenu
CharacterSelect
Settings
QuitButtons like BTN_Quit can route related roots such as GRP_Quit or CAN_QuitWindow into the detached owner when names are close enough.