SA:O APIMarker diagnostics

Draw GTA's original red pulsing mission-area marker at a position: three cylinders automatically aligned with the ground.

Syntax

Copy signature

bool renderScriptImportantArea(Vector3 center, float radiusX, float radiusY [, int localId])

Arguments

centerVector3

Finite center position.

radiusXfloat

Positive X radius.

radiusYfloat

Positive Y radius.

localIdintoptional

Optional caller-local identity mixed with the resource identity.

Returns

true after a valid frame submission; false for invalid dimensions, missing resource context, or unavailable marker service.

Ownership and lifecycle

The important-area primitive only draws for one frame. Call it from onClientPreRender for as long as it should stay visible.

Important behavior

• This is visual only and creates no collision shape.

Example

addEventHandler("onClientPreRender", root, function()
    renderScriptImportantArea(Vector3(2100.48, -1649.14, 12.47), 4, 4, 1)
end)

Where this comes from

SOURCECLuaMarkerDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaMarkerDefs.cpp INTRODUCED / EXTENDED3dc633a89Read the commit and why the change was made RELATED CATEGORY HARNESS marker-limit-test Category-level coverage · test-resources/marker-limit-test

RELATED SA:O APIS

Continue exploring

Read the system guide →

getMarkerLimitStats Returns MTA marker-streamer usage plus GTA 3D marker, checkpoint, and direction-arrow capacities. engineGetRendererStats Returns current, session-high-water, and capacity counters for San Andreas Online's expanded renderer arrays. engineResetRendererStats Resets renderer high-water measurements without changing capacities or active objects.

← Previous in categorygetMarkerLimitStats

← Back to the SA:O Lua API · How Marker diagnostics works →