API ReferenceGE ExtensionsscenarioraceMarkers
None Marker
A no-op race marker implementation. All methods exist but do nothing, making checkpoints completely invisible. Used when no visual marker is desired.
A no-op race marker implementation. All methods exist but do nothing, making checkpoints completely invisible. Used when no visual marker is desired.
Class API (OOP via metatable)
| Method | Signature | Description |
|---|---|---|
C:init | (id) | No-op constructor |
C:update | () | No-op per-frame update (has commented-out debug line) |
C:setToCheckpoint | (wp, mode) | No-op - ignores waypoint data |
C:setMode | (mode) | No-op - ignores mode changes |
C:setVisibility | (v) | No-op - ignores visibility flag |
C:hide | () | Calls setVisibility(false) (still no-op) |
C:show | () | Calls setVisibility(true) (still no-op) |
C:createMarkers | () | No-op - creates nothing |
C:clearMarkers | () | No-op - clears nothing |
How It Works
- The file returns a factory function that creates a new instance via
setmetatable(o, C) - Every method is intentionally empty - this marker produces no visual output
- It satisfies the race marker interface so the marker system can use it without special-casing
- Contains a commented-out
debugDrawer:drawLineinupdate()for development use
Factory Pattern
-- noneMarker uses the standard marker factory pattern:
return function(...)
local o = {}
setmetatable(o, C)
C.__index = C
o:init(...)
return o
endUsage Example
-- In scenario JSON, set marker to "none" to hide all checkpoints:
-- { "track": { "customMarker": "noneMarker" } }
-- Or create programmatically:
local createMarker = require("scenario/raceMarkers/noneMarker")
local marker = createMarker(1)
marker:createMarkers() -- does nothing
marker:setToCheckpoint(wp) -- does nothing
marker:setMode('default') -- does nothingKey Notes
- Implements the full marker interface with all methods as stubs
- Useful for scenarios that use waypoints for logic but don't want visible markers
- No TSStatic objects are created, so zero rendering overhead
See Also
- Race Marker: Attention - Floating Arrow Checkpoint Marker - Related reference
- Race Marker: Crawl Marker - Arrow + Flag + Column Checkpoint - Related reference
- Race Marker: Cylinder - Base + Cylinder Checkpoint Marker - Related reference
- Scenario System Guide - Guide
Cylinder Marker
A classic race checkpoint marker consisting of a ground base ring and a tall transparent cylinder. Color-coded by checkpoint type with distance-based alpha fading.
Overhead Marker
A race checkpoint marker that displays a single floating arrow shape above the waypoint position. The arrow faces the camera, bobs up and down, and color-lerps between modes.