Walking Marker

Reference for the walking marker class used by the POI/marker system to display interactive door icons when the player is on foot near buildings.

Module Exports

Class C - Instance Methods

Internals

• Icon Renderer: Uses a shared BeamNGWorldIconsRenderer named "markerIconRenderer" with an icon atlas
• Door Data: Each door has an OBB area (pos + x/y/z half-axes), an icon position, temporal smoothers for icon lift and alpha, and an optional screen object
• Overlap Detection: Uses overlapsOBB_OBB() between the player walking bounding box and the door's area OBB
• Icon Behavior: Icons lift upward when the player overlaps the area; alpha fades based on distance (maxVisibleDistance) and raycasting for line-of-sight
• Screen Objects: Tied to doors, shown for 5 seconds after overlap, hidden otherwise; play an audio cue on first overlap

How It Works

-- Clustering: POIs sharing the same door area+icon objects are merged
local function cluster(pois, allClusters)
  -- Groups by sorted concatenation of area+icon names
  -- Each cluster gets: doors, icon, iconLift, iconOffsetHeight, screens, elemData
end

-- Per-frame update flow:
function C:update(data)
  -- For each door:
  --   1. Check OBB overlap with player walking bbox
  --   2. Play audio on first overlap if screen exists
  --   3. Show/hide screen objects (5s timer)
  --   4. Smooth icon position (lift on overlap) and alpha (fade by distance + raycast)
  --   5. Draw connecting line when lifted
  -- Track anyOverlap for interaction state changes ("in"/"out")
end

Key Constants

See Also

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