Skip to content
MTA:SA Neon Documentation

setVehicleLoadCollisionFlag

Client-side
NEON APINative story vehicle state

Available in Neon, not standard MTA

Persists GTA's mission-car collision-loading and physics-to-ghost policy independently from ordinary element collisions.

Syntax

bool setVehicleLoadCollisionFlag(vehicle theVehicle, bool loadCollision)

GTA task mapping

NATIVE GTA BEHAVIOR 0587
No CTask is created

SCM equivalent: SET_LOAD_COLLISION_FOR_CAR_FLAG

This does not create a CTask. GTA stores the inverse argument in physical flag 0x4000; mission-car AI uses it when switching between physics and ghost simulation over unloaded world collision.

Arguments

theVehiclevehicle

Vehicle whose local mission-collision policy should change.

loadCollisionbool

SCM-compatible value; false sets native physical mask 0x4000 and allows ghost physics where world collision is absent.

Returns

true when the valid vehicle accepted the policy; false for an invalid element or argument.

Ownership and lifecycle

Door-lock, tyre-burst, physical-proof, and load-collision policies live on the MTA vehicle, apply immediately when its GTA instance is streamed, and are reapplied after local native recreation. They are client-local, last-writer-wins policies rather than resource-owned leases.

Important behavior
  • The value survives stream-out and native vehicle recreation on this client.
  • There is no getter, captured prior value, or automatic resource-stop restoration. Callers remain responsible for the later vehicle lifecycle.
  • This does not disable contact collisions like setElementCollisionsEnabled.

Example

setVehicleLoadCollisionFlag(voodoo, false)

Where this comes from

SOURCECLuaVehicleDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaVehicleDefs.cpp INTRODUCED / EXTENDED2314459caRead the commit and why the change was made TEST RESOURCE native-simulation-lease-test test-resources/native-simulation-lease-test
RELATED NEON APIS

Continue exploring

Read the system guide →
setVehicleDoorLockMode Sets and persists GTA's raw native door-lock mode without reducing it to a boolean. getVehicleDoorLockMode Reads the vehicle's raw native door-lock mode, including a locally persisted streamed-out value. setVehicleTyresCanBurst Sets and persists GTA's native tyre-burst policy independently from ordinary body damage.

← Back to the Neon Lua API · How Native story vehicle state works →