SA:O APIServer-authoritative models

Enumerates active server-managed logical model IDs, optionally filtered by type.

Syntax

Copy signature

table|false engineGetModels([string type])

Arguments

typestringoptional

Optional object, vehicle, or ped filter.

Returns

An array of logical model IDs, or false for an invalid filter.

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.

Where this comes from

SOURCECLuaModelDefs.cppServer/mods/deathmatch/logic/luadefs/CLuaModelDefs.cpp INTRODUCED / EXTENDEDdc25a615cRead 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. engineFreeModel Releases a logical model owned by the calling resource after remapping surviving elements to their native parent. engineGetModelParent Returns the native GTA parent of an active server-managed logical model.

← Previous in categoryengineGetModelIDFromName Next in category →engineIsModelAllocated

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