How to Change Ped Models in FiveM (Player & NPC Models)

Changing player and NPC models is core to FiveM roleplay — from freemode character creators to story-character NPCs and custom ped models. This guide covers how to change ped models in FiveM and dress them.

Changing the player model

Swapping the player’s body uses a request-load-set pattern:

local model = GetHashKey('a_m_y_hipster_01')
RequestModel(model)
while not HasModelLoaded(model) do Wait(0) end
SetPlayerModel(PlayerId(), model)
SetModelAsNoLongerNeeded(model)

Always call SetModelAsNoLongerNeeded afterward so the game can free memory. Look up any model’s name and JOAAT hash in our ped model database (860 models).

Freemode vs story peds

mp_m_freemode_01 and mp_f_freemode_01 are the customisable GTA Online base models — they accept clothing drawables, head blends, overlays and tattoos, so they’re what you use for RP character creators. Story peds (cs_, ig_) have fixed appearances and are best for canon NPCs.

Dressing a ped

Once you have a freemode ped, clothing is applied per component slot with SetPedComponentVariation (and props with SetPedPropIndex). Component 11 is the jacket, 4 the legs, 6 the shoes, and so on. Our ped components & props tool documents every slot and generates the exact calls from your drawable/texture IDs.

Spawning NPCs

For non-player peds, use CreatePed(type, model, x, y, z, heading, networked, scriptHostPed) — request and load the model first, same as above. Type 4 is a normal human ped.

Frequently asked questions

How do I change my ped model in FiveM?

Request the model, wait for it to load, call SetPlayerModel, then SetModelAsNoLongerNeeded. Find model names and hashes in our ped database.

What’s the best ped model for a character creator?

The freemode models (mp_m_freemode_01 / mp_f_freemode_01) — they accept the full range of clothing, overlays and head blends.

How do I change a ped’s clothes in FiveM?

Use SetPedComponentVariation per component slot and SetPedPropIndex for props — our ped components tool generates the code.