Skip to content
San Andreas Online Docs

enginePlayVehicleAudioBackfire

Client-side
SA:O APIResource-owned vehicle audio

Make an active custom-audio vehicle backfire on demand. San Andreas Online plays the configured pop and, in full/flames mode, fires a normal or stronger burst from the exhaust.

Syntax

bool enginePlayVehicleAudioBackfire(vehicle theVehicle, int mode)

Arguments

theVehiclevehicle

Streamed vehicle with an enabled audio mode, matching model definition, and acquired bank.

modeint

Backfire strength: 1 for normal or 2 for high.

Returns

true when the owning resource played the requested backfire; false for another caller, an inactive vehicle, missing audio state, or a mode other than 1 or 2.

Ownership and lifecycle

One client resource owns the global vehicle-audio lease. Reloading replaces its definitions and restarts the lazy bank state; unloading, resource shutdown, or client teardown stops active audio, restores GTA's vehicle sound, and releases the lease.

Important behavior
  • Loading the configuration alone is insufficient; the vehicle must already be active in the sound manager.
  • This is a client-side call. A resource can relay the trigger to nearby clients when every player should hear and see the same backfire.
  • The implementation emits a backfire name internally but does not register it as a built-in client event, so no public event is documented.

Where this comes from

SOURCECLuaEngineDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaEngineDefs.cpp INTRODUCED / EXTENDED0418bcea7Read the commit and why the change was made
RELATED SA:O APIS

Continue exploring

Read the system guide →
engineLoadVehicleAudioConfig Acquires the client-wide vehicle-audio lease and loads Soundize-compatible model definitions from the calling resource. engineReloadVehicleAudioConfig Reparses the current owner's definitions and schedules a clean lazy restart of the vehicle-audio banks. engineUnloadVehicleAudioConfig Stops the calling resource's custom vehicle audio, restores GTA audio, and releases the global lease.

← Back to the SA:O Lua API · How Resource-owned vehicle audio works →