NEON APISA-MP maps and object streaming

Available in Neon, not standard MTA

Redistributes MTA's fixed 1000-slot object streaming budget between normal and low-LOD objects.

Syntax

Copy signature

bool engineSetObjectStreamingLimits(int maxObjects, int maxLowLodObjects)

Arguments

maxObjectsint

Maximum normal streamed objects.

maxLowLodObjectsint

Maximum low-LOD streamed objects.

Returns

true when the split is valid; invalid values raise an argument error.

Ownership and lifecycle

Parsing creates inert data. Objects, custom models, material overrides, removals, and any temporary streaming-limit split remain owned by the calling client resource and must be cleaned up when that resource stops.

Important behavior

• The combined limit cannot exceed 1000.
• The default split remains 500/500.
• Lowering a category below current usage restreams that category so the new quota takes effect.

OOP aliases

• Engine.setObjectStreamingLimits(maxObjects, maxLowLodObjects)

Example

engineSetObjectStreamingLimits(1000, 0)

Where this comes from

SOURCECLuaEngineDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaEngineDefs.cpp INTRODUCED / EXTENDEDc1d052e9dRead the commit and why the change was made TEST RESOURCE object-streaming-limits test-resources/object-streaming-limits

RELATED NEON APIS

Continue exploring

Read the system guide →

engineParseSAMPMap Parses Texture Studio / SA-MP Pawn map source into inert objects, building removals, material overrides, and diagnostics. engineGetTXDIDFromName Resolves a loaded GTA texture-dictionary name to its current TXD slot. setObjectMaterial Applies an SA-MP-style texture and/or color override to one DFF material slot on a client object.

← Previous in categoryremoveObjectMaterial Next in category →engineGetObjectStreamingLimits

← Back to the Neon Lua API · How SA-MP maps and object streaming works →