Invisible Trigger

Invisible sphere-based trigger marker. Has no visual representation but detects when the player vehicle enters or exits a radius, firing onEnter and onInside callbacks. Used for gameplay triggers without visible markers.

Class Methods

Module Functions

Internals

Trigger Detection

Runs in interactWhileMoving (called every frame while driving, not just at parking speed):

if vehPos:squaredDistance(self.pos) <= self.radius * self.radius then
  if not self._inside then
    self.onEnter(interactData)    -- fires once on entry
  end
  self.onInside(interactData)     -- fires every frame while inside
  self._inside = true
else
  if self._inside then
    self.onExit(interactData)     -- fires once on exit (only via hide())
  end
  self._inside = false
end

• Walking mode is excluded (if interactData.isWalking then return end)
• onEnter fires once when transitioning from outside to inside
• onInside fires every frame while the vehicle is within radius
• Exit is detected when distance exceeds radius

Cluster Data

{
  id = 'invisibleTrigger#'..poi.id,
  pos = vec3,
  radius = number,
  onEnter = function(interactData),
  onInside = function(interactData),
  visibilityPos = pos,
  visibilityRadius = 0,
}

How It Works

1. POI system defines trigger positions with radius and callback functions
2. Each frame while driving: squared-distance check against radius
3. State transitions fire onEnter (once) or track onInside (continuous)
4. No visual rendering - purely logic-driven

See Also

• Big Map Marker - Related reference
• Crawl Marker - Related reference
• Drift Line Marker - Related reference
• Gameplay Systems Guide - Guide