Mission Editor – Start Trigger

Editor sub-module for configuring how and where a mission starts. Supports coordinates (world-space position with radius) and league (career progress screen) trigger types.

Overview

Manages mission.startTrigger - the type, level, position, rotation, and radius that define where/how a mission is activated. Uses transformUtil for gizmo-based 3D positioning in the viewport.

Class Methods

Trigger Types

Coordinates Trigger

When type is coordinates:

• Level combo – select which level the trigger belongs to
• Transform gizmo – interactive 3D positioning via transformUtil
• Debug drawing – red sphere at trigger position, directional prism showing facing
• Fields: pos (vec3), rot (quat), radius (number)

Default Data for New Triggers

{
  coordinates = { level = 'gridmap', pos = {0,0,0}, radius = 3, rot = {0,0,0,1} },
  league      = { level = 'gridmap' },
}

Type Switching

When changing trigger type:

• Old data is cached per type in oldValues
• If switching back, cached data is restored
• Level field is preserved across type changes

Usage Example

local stTab = require('extensions/editor/missionEditor/startTrigger')(missionEditorRef)
stTab:setMission(mission)
stTab:draw()

-- Get transform for external tools
local transform = stTab:getStartTriggerTransform()
if transform then
  print(transform.pos, transform.rot, transform.scl)
end

See Also

• Mission Editor - Additional Attributes - Related reference
• Mission Editor - Career Setup - Related reference
• Mission Editor - Conditions - Related reference
• World Editor Guide - Guide