NEON APIManaged fire

Available in Neon, not standard MTA

Attaches a managed fire to an element so it follows wherever that element goes.

Syntax

Copy signature

bool setFireTarget(fire theFire, element target)

Arguments

theFirefire

Managed fire element.

targetelement

Element to follow, or nil to leave the fire where it is.

Returns

true when applied; false for an invalid element.

Ownership and lifecycle

A managed fire is an element owned by the resource that created it, so stopping that resource extinguishes its fires. Server-created fires are synchronized to every client, and lifetime is tracked as relative remaining time so a client joining mid-burn receives what is left.

Important behavior

• This is what separates a managed fire from a native one: the same fire keeps its identity and can be retargeted while burning, instead of being extinguished and recreated.

Where this comes from

SOURCECLuaFireDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaFireDefs.cpp and Server/mods/deathmatch/logic/luadefs/CLuaFireDefs.cpp INTRODUCED / EXTENDEDd82ce28aaRead the commit and why the change was made TEST RESOURCE fire-test test-resources/fire-test

RELATED NEON APIS

Continue exploring

Read the system guide →

createFire Creates a managed fire element when given an options table, or the original native GTA fire otherwise. extinguishFire Destroys one managed fire element, in addition to the standard radius and no-argument forms. getFireStrength Returns the strength multiplier of a managed fire.

← Previous in categorygetFireTarget

← Back to the Neon Lua API · How Managed fire works →