_CREATE_WEAPON_OBJECT · RedM

Property	Value
Native Name	`_CREATE_WEAPON_OBJECT`
Hash	`0x9888652B8BA77F73`
Return Type	`Object`
Build	`1207`
Parameters	`weaponHash` (Hash), `ammoCount` (int), `x` (float), `y` (float), `z` (float), `showWorldModel` (BOOL), `scale` (float)

Parameters

weaponHash (Hash)
ammoCount (int)
x (float)
y (float)
z (float)
showWorldModel (BOOL)
scale (float)

Usage

Lua (Direct):

local result = CreateWeaponObject(weaponHash, ammoCount, x, y, z, showWorldModel, scale)

Lua (Hash):

local result = Citizen.InvokeNative(0x9888652B8BA77F73, weaponHash, ammoCount, x, y, z, showWorldModel, scale)

Before you call

Entity-creating native — the returned handle can come back 0, or as an exists-but-broken entity (e.g. an invisible ped), on failure, so validate it before use (check ~= 0 and/or DoesEntityExist); note CREATE_PED returns 0 silently when called with the wrong arg shape. (see findings: learning:44, learning:84 — fetch via get_document)

Spawned entities consume finite client-side pool slots shared with the game world and every other resource — pool exhaustion makes CREATE_* return 0 or crashes the client with a pool-full error. Budget spawns and delete what you create; a server owner can only raise a pool with `increase_pool_size` up to the Cfx-published cap — get_document({ path: "guides/pool_size_limits.md" }) lists the RedM pools and their limits. (see findings: learning:123 — fetch via get_document)