Native referenceRedMserver

CREATE_PED

0x389EF71 CFX

Entity CREATE_PED(int pedType, Hash modelHash, float x, float y, float z, float heading, BOOL isNetwork, BOOL bScriptHostPed);

Property	Value
Native Name	`CREATE_PED`
Hash	`0x389EF71`
Return Type	`Entity`
API Set	`server`
Parameters	`pedType` (int), `modelHash` (Hash), `x` (float), `y` (float), `z` (float), `heading` (float), `isNetwork` (BOOL), `bScriptHostPed` (BOOL)

Description: Creates a ped (biped character, pedestrian, actor) with the specified model at the specified position and heading. This ped will initially be owned by the creating script as a mission entity, and the model should be loaded already (e.g. using REQUEST_MODEL).

This is the server-side RPC native equivalent of the client native CREATE_PED.

Parameters

pedType (int) — Unused. Peds get set to CIVMALE/CIVFEMALE/etc. no matter the value specified.
modelHash (Hash) — The model of ped to spawn.
x (float) — Spawn coordinate X component.
y (float) — Spawn coordinate Y component.
z (float) — Spawn coordinate Z component.
heading (float) — Heading to face towards, in degrees.
isNetwork (BOOL) — Whether to create a network object for the ped. If false, the ped exists only locally.
bScriptHostPed (BOOL) — Whether to register the ped as pinned to the script host in the R* network model.

Back to CFX

At a glance

Game: RedM
Namespace: CFX
Returns: Entity
API set: server
Description source: cfx

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)

Many RDR3 ped model types spawn invisible with plain CreatePed — s_m_m_* shopkeeper peds require bScriptHostPed=true (7th arg), re_*/mp_re_* random-encounter peds need _EQUIP_META_PED_OUTFIT_PRESET before _UPDATE_PED_VARIATION, and mp_male/mp_female peds need base clothing applied after the preset. (see findings: learning:4, learning:8, 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)

Let your AI
read the fine print.

Native signatures, warnings, and community context. Directly in your editor.

Connect via MCP