API ReferenceGE Extensionseditor
Editor Preferences
Main preferences window - manages all editor preference categories with search, import/export, and reset.
Main preferences window - manages all editor preference categories with search, import/export, and reset.
Overview
Renders the Preferences window with a left-side category list, search/filter, per-category import/export/reset, and value editing via valueInspector. Also registers core preference categories: general, camera, and ui.
Public Functions
| Function | Signature | Description |
|---|---|---|
M.onEditorGui | () | Renders the full preferences window with page list, filter, and value editors |
M.onExtensionLoaded | () | No-op placeholder |
M.onEditorInitialized | () | Registers the window, sets up valueInspector, creates page sorting |
M.onSerialize | (state) | Saves current category name |
M.onDeserialized | (state) | Restores current category name |
M.onEditorRegisterPreferences | (prefsRegistry) | Registers general, camera, ui categories with all their preferences |
M.onEditorPreferenceValueChanged | (path, value) | Applies UI scale, camera speed, and smoothness changes in real-time |
M.onEditorDeactivated | () | Resets UI scale to 1, optionally switches to game camera |
M.onEditorActivated | () | Applies the editor UI scale |
Core Preference Categories
general.internal (hidden)
| Preference | Type | Default | Description |
|---|---|---|---|
cleanExit | bool | true | Tracks if game exited properly |
lastLevel | string | "" | Last edited level |
ui.general
| Preference | Type | Default | Description |
|---|---|---|---|
scale | float | 0.92 | Global UI scale (0.4–3) |
dpiAware | bool | false | Multiply scale by system DPI |
iconButtonSize | float | 28 | Toolbar icon button size |
enableVehicleControls | bool | true | Allow driving while editor is active |
useSlidersInInspector | bool | false | Use sliders instead of +/- buttons |
camera.general
| Preference | Type | Default | Description |
|---|---|---|---|
freeCameraMoveSpeed | float | 30 | Camera move speed (1–100) |
smoothCameraMove | bool | true | Newtonian camera movement damping |
freeCameraMoveSmoothness | float | 0.3 | Move smoothness (0–1) |
Features
- Search/Filter: Real-time text filter across all preference items
- Import/Export: Per-category JSON file import/export
- Reset: Per-category and global reset-to-defaults with confirmation
- "All" page: Shows every category on one page
- Copy Preference Path: Right-click context menu copies the pref path to clipboard
Notes
editor.showPreferences(categoryName)opens preferences to a specific category.editor.updatePreferencePages()refreshes the page list after new categories are registered.- UI scale changes are applied via
imguiUtils.changeUIScale().
See Also
- Editor AI Tests - Related reference
- Editor AI Visualization - Related reference
- Editor – Assembly Spline Tool - Related reference
- World Editor Guide - Guide
Prefab Instance Editor
Inspector header extension for PrefabInstance objects - shows template match status and apply/override controls.
Race / Path Editor
Main editor tool for creating and editing race paths - manages pathnodes, segments, start positions, track layout, time trial metadata, and testing.