Mission Start Position Editor
Editor extension providing a **3D edit mode** for visually repositioning mission start trigger positions in the viewport.
Editor extension providing a 3D edit mode for visually repositioning mission start trigger positions in the viewport.
Overview
Registers an editor edit mode that renders all mission start positions as coloured spheres in the 3D viewport. Supports click-to-select, drag-to-move, Ctrl+click direct placement, and undo/redo via editor history.
Module Interface (M)
| Function | Description |
|---|---|
M.onEditorInitialized() | Registers edit mode missionStartPositionEditMode with flag icon. |
M.setSelectedMission(mission) | Programmatically selects a mission for editing. |
Edit Mode Callbacks
| Callback | Description |
|---|---|
onActivate | Clears selection and drag state. |
onDeactivate | Clears all state. |
onUpdate | Main loop: draws spheres, handles mouse interaction, drag/Ctrl+click. |
onToolbar | Shows selected mission info, position, and "Move Nearby" button. |
Sphere Rendering
| Condition | Colour | Size Modifier |
|---|---|---|
| Selected | Green (80% opacity) | +30% |
| Nearby (<10m) | Orange (80% opacity) | +20% |
| Default | Blue (50% opacity) | Normal |
Sphere size scales linearly from 1.5 at 500m to 10 at 1500m camera distance.
Interaction
| Action | Result |
|---|---|
| Click near sphere | Select mission |
| Drag selected | Move to mouse 3D position |
| Ctrl+Click | Teleport selected mission to click point |
| Release drag | Commit undo/redo action |
Toolbar
- Displays mission ID and start position coordinates
- Move Nearby Missions (10m) - moves all missions within 10m to the selected mission's position (with undo support)
Helper Functions
| Function | Description |
|---|---|
getMissionStartPosition(m) | Returns vec3 from mission.startTrigger.pos. |
setMissionStartPosition(m, pos) | Sets position table, marks mission dirty. |
findNearbyMissions(m, dist) | Finds same-level missions within distance. |
moveNearbyMissions(m, dist) | Batch-moves nearby missions with undo. |
Usage Example
-- Activate the edit mode
editor.selectEditMode(editor.editModes.missionStartPositionEditMode)
-- Programmatically select a mission
editor_missionStartPositionEditor.setSelectedMission(someMission)See Also
- Editor AI Tests - Related reference
- Editor AI Visualization - Related reference
- Editor – Assembly Spline Tool - Related reference
- World Editor Guide - Guide
Mission Playbook
Editor extension that provides a **Mission Playbook** - a scripted sequence of mission attempts used to batch-test career progression, rewards, and unlock chains.
Multi Spawn Manager (Vehicle Groups)
Editor extension for creating, editing, saving, loading, and spawning **vehicle groups**. Supports both hand-picked ("custom") and auto-generated ("generator") groups.