Collection Marker (Flowgraph Node)

Overview

• Node Name: Collection Marker
• Category: repeat_instant
• Author: BeamNG
• File: extensions/flowgraph/nodes/scene/collectionMarker.lua

Creates a floating, rotating, colorable BeamNG-themed collectible token in the 3D scene. The marker bobs up and down and spins continuously.

Pin Schema

Input Pins

Output Pins

Behavior

• work() - Each frame while flow is active:
  1. On first frame, creates a TSStatic object using art/shapes/collectible/s_collect_BNG.dae at scale 2x, plus a PointLight.
  2. Updates position with a sinusoidal vertical bob (sin(time * 1.5) * 0.15).
  3. Applies continuous Y-axis rotation (time * 1.75 radians).
  4. Applies color: if a number (0-1), maps through rainbowColor for an orange-to-green gradient. If an RGBA table, applies directly.
  5. Updates the point light to match the marker color with radius 3.
• hideMarker() - Deletes both the TSStatic marker and the PointLight.
• _executionStopped() / destroy() / onClientEndMission() - All call hideMarker() for cleanup.

Internals

• self.marker - The TSStatic collectible mesh object
• self.light - The PointLight that illuminates the marker
• Uses self.mgr.modules.timer.globalTime.real for animation timing
• Color number mapping uses rainbowColor(36, (0.8 - 0.75*clr) * 12, 1)

Key Dependencies

• createObject('TSStatic') - Creates the 3D mesh object
• worldEditorCppApi.createObject("PointLight") - Creates the light
• rainbowColor() - Color gradient utility
• quatFromEuler() - Rotation from euler angles

How It Works

The node manages a collectible-style 3D token that hovers and spins at a given position. It's designed for collectathon gameplay - the marker uses the BeamNG collectible mesh and glows with a configurable color. The sinusoidal bob and constant spin create an eye-catching floating effect. Cleanup is thorough, with deletion on stop, destroy, and mission end.

Example Usage

-- Place collectible tokens around a map
-- Wire pos from scene objects or hardcoded positions
-- Use color number 0.0 (orange) through 1.0 (green) for difficulty/value indication
-- Wire reset impulse to remove the marker when collected

Additional Methods

C:init(mgr, ...)

Initializes the node, setting up pins and default properties.

Parameters:

• mgr
• ...

See Also

• Custom Lua Command (Flowgraph Node) - Related reference
• Get Object Field (Flowgraph Node) - Related reference
• Get Player Vehicle ID (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide