Skip to content
MTA:SA Neon Documentation

engineFreeModel

Server-side
NEON APIServer-authoritative models

Available in Neon, not standard MTA

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

Syntax

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, Neon 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 NEON APIS

Continue exploring

Read the system guide →
engineRequestModel Allocates a stable, resource-owned logical model for an object, vehicle, or ped. engineGetModelParent Returns the native GTA parent of an active server-managed logical model. engineGetModelName Returns the active model's resource-qualified registry name.

← Back to the Neon Lua API · How Server-authoritative models works →