API ReferenceGE ExtensionseditorraceEditor
Race Editor - Pathnodes Tab
Sub-module for creating and editing race pathnodes (checkpoints) - supports manual and navgraph placement modes.
Sub-module for creating and editing race pathnodes (checkpoints) - supports manual and navgraph placement modes.
Overview
The primary tab for placing race checkpoints. Pathnodes can be positioned manually (Shift-drag) or linked to navgraph waypoints (Alt-click). Supports gizmo translate/rotate/scale, normal direction editing, recovery position assignment, custom fields, and simple drag mode.
Class Methods
| Method | Signature | Description |
|---|---|---|
C:init | (raceEditor) | Initializes with parent editor reference |
C:setPath | (path) | Sets the race path |
C:selected / C:unselect | () | Activates/deactivates pathnode display |
C:selectPathnode | (id) | Selects a pathnode, updates gizmo |
C:draw | (mouseInfo) | Main loop - gizmo, input, UI rendering |
C:createManualPathnode | () | Shift-drag creates manual pathnode with auto-segment |
C:selectNavgraphNode | () | Alt-click links to navgraph waypoint |
C:input | () | Input dispatcher: Alt=navgraph, Shift=manual, Click=select |
C:beginDrag / C:dragging / C:endDragging | () | Gizmo manipulation |
C:handleMouseDown / C:handleMouseHold / C:handleMouseUp | (...) | Simple drag mode handlers |
C:drawPathnodeList | () | List+detail panel with all pathnode properties |
C:drawCustomFields | (fields) | Renders custom string/number/vec3 fields |
C:autoRecoverPos | (reverse) | Auto-creates recovery start position from pathnode normal |
C:selector | (name, fieldName, clrI, tt) | Dropdown for recovery position selection |
C:mouseOverPathnodes | () | Detects mouse hovering over pathnodes for selection |
C:onEditModeActivate | () | Called when race editor pathnode mode is activated |
C:selectedPathnode | () | Returns the currently selected pathnode object |
C:updateTransform | (index) | Updates gizmo transform for pathnode at given index |
Pathnode Properties
| Property | Type | Description |
|---|---|---|
pos | vec3 | World position |
radius | float | Checkpoint radius |
normal | vec3/nil | Direction vector (nil = non-directional) |
mode | string | "manual" or "navgraph" |
visible | bool | Show checkpoint markers in time trials |
useAsSplit | bool | Use as split timing marker |
recovery | int | Forward recovery start position ID |
reverseRecovery | int | Reverse recovery start position ID |
customFields | table | User-defined string/number/vec3 fields |
Notes
- Creating a new pathnode auto-creates a segment from the last existing pathnode.
- Navgraph mode pathnodes use
navRadiusScaleinstead of absolute radius. - "Down to Terrain" button snaps the Z coordinate to terrain height.
- "Align Normal with Terrain" projects the normal tip to terrain.
- Simple drag mode uses raycast Z-snapping for smooth terrain-following movement.
- Custom fields support copy/paste between pathnodes.
See Also
- Race Editor - Pacenotes Tab - Related reference
- Race Editor - Segments Tab - Related reference
- Race Editor - Start Positions Tab - Related reference
- World Editor Guide - Guide