How to spawn a custom ped in FiveM
Updated 2026-07-23
A custom ped works like a custom car: an addon resource registers a new model name, and anything that can spawn a ped by name can spawn yours. This guide covers installing the resource, the spawn itself, and what to check when the ped refuses to appear.
Get an addon ped resource
If you downloaded a ped, it is usually already a resource with a stream/ folder and a manifest. If you are making one:
- From a character model: the GLB to ped converter rigs a .glb to the GTA skeleton and exports a ready resource.
- From existing .ydd files: the YDD to ped packager wraps drawables into an addon ped package.
Either way the output contains the ped files plus the manifest that registers the model name.
Install it on the server
- 1Drop the resource folder into resources/ on the server.
- 2Add ensure <resource-name> to server.cfg.
- 3Restart the server (a plain restart, not just resource restart, is safest for newly streamed models).
Spawn it
- Admin menus: vMenu and similar have a ped or skin changer with a spawn-by-name field; enter the ped model name.
- Scripts: RequestModel(GetHashKey('mypedname')), wait until HasModelLoaded, then CreatePed or SetPlayerModel with that hash.
- Some frameworks expose a /skin or /ped command that takes the model name directly.
When the ped does not appear
- Model never loads (script waits forever): the resource is not ensured, or the manifest does not stream the ped files. Check the server console.
- Ped spawns as the default character: the model name is misspelled or the hash never loaded before SetPlayerModel ran.
- Ped spawns but is invisible or distorted: the model itself has a problem; re-check it in the converter preview with animations playing before re-exporting.
Once the ped works, the ped animation creator lets you build custom animations for it and play them from a script.
Frequently asked questions
- Where do I find the model name of my ped?
- It is the name the resource registers, normally the file name of the ped files in stream/. The converters let you choose it at export time.
- Can players use the ped as their character?
- Yes. SetPlayerModel with the ped hash makes it the player character; most frameworks and admin menus expose this.
- Why does the ped work for me but not other players?
- Other clients also need the resource streamed to them, which happens automatically when it is ensured server-side. If they joined before the resource was added, a reconnect refreshes their cache.