SA:O APIServer-authoritative models

Releases a logical model owned by the calling resource after remapping surviving elements to their native parent.

Syntax

Copy signature

bool engineFreeModel(int model)

Arguments

modelint

Active server logical model ID owned by the caller.

Returns

true when the definition was safely released; false for an unknown or foreign model.

Ownership and lifecycle

The server keeps logical IDs stable, but each client chooses its own GTA slot. When a resource stops, San Andreas Online moves surviving elements back to their parent model before freeing those slots.

Example

if isElement(vehicle) then destroyElement(vehicle) end
engineFreeModel(model)

Where this comes from

SOURCECLuaModelDefs.cppServer/mods/deathmatch/logic/luadefs/CLuaModelDefs.cpp INTRODUCED / EXTENDEDa7a20d32bRead the commit and why the change was made RELATED CATEGORY HARNESS server-model-registry-test Category-level coverage · test-resources/server-model-registry-test

RELATED SA:O APIS

Continue exploring

Read the system guide →

engineRequestModel Reserve a custom model ID for an object, vehicle, or ped so the server and all clients can use it consistently. engineGetModelParent Returns the native GTA parent of an active server-managed logical model. engineGetModelName Returns the active model's resource-qualified registry name.

← Previous in categoryengineRequestModel Next in category →engineGetModelParent

← Back to the SA:O Lua API · How Server-authoritative models works →