Skip to content
MTA:SA Neon Documentation

engineCreateCullZone

Client-side
NEON APINative CULL zones

Available in Neon, not standard MTA

Creates a resource-owned native CULL zone and returns its stable ID.

Syntax

int|false engineCreateCullZone(string type, float x, float y, float z, float width, float depth, float height, int flags [, float rotation = 0, float mirrorV = 0, float normalX = 0, float normalY = 0, float normalZ = 1])

Arguments

typestring

attribute, tunnel, or mirror.

x, y, zfloat

Zone center; GTA stores signed 16-bit whole units.

width, depth, heightfloat

Positive zone dimensions.

flagsint

Native flags from 0 through 65535.

rotationfloatoptional · default 0

Rotation in degrees.

mirrorVfloatoptional · default 0

Mirror-plane V term.

normalX, normalY, normalZfloatoptional · default 0, 0, 1

Mirror plane normal.

Returns

A non-zero stable zone ID, or false when validation or capacity checks fail.

Ownership and lifecycle

When the owner stops, Neon deletes its custom zones and restores any vanilla zones it claimed.

Important behavior
  • Fractional positions are truncated to GTA's whole-unit representation.

Where this comes from

SOURCECLuaEngineDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaEngineDefs.cpp INTRODUCED / EXTENDED89558e874Read the commit and why the change was made RELATED CATEGORY HARNESS cull-zone-test Category-level coverage · test-resources/cull-zone-test
RELATED NEON APIS

Continue exploring

Read the system guide →
engineGetCullZones Lists adopted vanilla and custom CULL zones, optionally filtered by zone type. engineSetCullZone Replaces an owned or claimed zone definition while retaining its stable ID. engineSetCullZoneEnabled Enables or disables a custom zone or a vanilla zone claimed by the caller.

← Back to the Neon Lua API · How Native CULL zones works →