# FiveM peds: find, install and make custom addon peds

URL: https://rivo.tools/guides/fivem-peds

By Rivo Team · Published 2026-11-20 · Updated 2026-11-20

> FiveM peds are the character models players and NPCs use. Here is how to find ped model names, install addon peds, switch to them with code and make your own.

FiveM peds are the character models in GTA V: every player, NPC and animal is a ped with a model name such as mp_m_freemode_01 or s_m_y_cop_01. You can use any base game ped by its model name, or add new ones as addon peds, streamed from a resource with their model files and a peds.meta entry.

If you want a custom character rather than a download, the [FiveM addon ped creator](https://rivo.tools/app/clothing?mode=peds) builds one from a description, a picture or your own 3D model, fits it to the GTA skeleton and gives you a ready addon ped resource. The rest of this guide covers finding ped names, installing addon peds, setting them with code and fixing common problems.

![FiveM addon ped creator on Rivo Tools](https://cdn.rivo.software/6052b563-7192-4ed2-868c-bd93309c58a2)

### Base game peds: the list and model names

GTA V ships with hundreds of peds, and every one is available on a FiveM server without streaming anything. The official reference list with model names and preview images is on the FiveM docs: [ped models](https://docs.fivem.net/docs/game-references/ped-models/).

The model name is the "code" people ask about. Scripts usually use it as a string and convert it to a hash with GetHashKey. Names follow a pattern that tells you what the ped is:

- a_ for ambient peds, the pedestrians walking the streets (a_m_y_hipster_01).
- s_ for service peds such as police, paramedics and workers (s_m_y_cop_01, s_m_m_paramedic_01).
- g_ for gang members (g_m_y_ballaorig_01).
- u_ and cs_ / csb_ for unique and cutscene characters.
- ig_ for in-game story characters (ig_lestercrest).
- mp_m_freemode_01 and mp_f_freemode_01 for the male and female freemode peds that character creators and clothing use.
- a_c_ for animals (a_c_husky).

The m or f after the prefix is the gender, and y, m or o is young, middle-aged or old. Most roleplay frameworks put players on the two freemode peds, because those are the only ones that take the full clothing, hair and face customisation. Other peds are fixed characters that only have their own built-in variations.

### Addon peds vs replacement peds

There are two ways to get a new character into FiveM:

- Addon peds get their own new model name. They need the model files in a stream folder and a peds.meta entry declared in fxmanifest.lua. Nothing in the base game changes.
- Replacement peds stream files with the same name as an existing ped, so that ped looks different for everyone. No peds.meta is needed, but every NPC using that model changes too.

Addon peds are the cleaner choice for servers. You keep every base ped working, and you can give a staff member, a gang leader or a mascot a model of their own.

### Free, Tebex and downloaded peds

Peds come from three places: free mods, paid releases on Tebex stores, and models you make yourself. Use only peds you have the rights to. Paid peds are licensed to the buyer, and leaked copies put your server at risk with Cfx.re as well as the creator.

Many free peds are made for singleplayer and come as a folder for OpenIV rather than a FiveM resource. The [GTA 5 mod to FiveM converter](https://rivo.tools/app/converter) sorts the model files and meta into a server-ready resource with a correct fxmanifest.lua. The [GTA 5 mods converter guide](https://rivo.tools/guides/gta-5-mods-converter) walks through that process. If a download includes Lua or JavaScript, run it through the [backdoor and malware scanner](https://rivo.tools/app/server-health) before it touches your server.

### How to install an addon ped in FiveM

An addon ped resource has the model files in a stream folder, a peds.meta, and a manifest that declares the meta. A typical layout looks like this:

```text
resources/[peds]/my_ped/
  fxmanifest.lua
  peds.meta
  stream/
    my_ped.yft
    my_ped.ymt
    (the .ydd and .ytd files for the ped's parts and textures)
```

1. Create a folder for the resource inside your resources directory, for example resources/[peds]/my_ped.
2. Put every model file (.yft, .ymt, .ydd, .ytd) in a folder named stream. Keep the file names exactly as the ped came, because the game finds the parts by name.
3. Put peds.meta in the resource root. Check that the Name inside the entry matches the model file name, since that is the name you will spawn it with.
4. Add an fxmanifest.lua that declares peds.meta as a data file (example below).
5. Add ensure my_ped to server.cfg and restart the server, or refresh and start it from the console.

```lua
fx_version 'cerulean'
game 'gta5'

files {
    'peds.meta'
}

data_file 'PED_METADATA_FILE' 'peds.meta'
```

Files in the stream folder are streamed automatically, so they do not need to be listed. If you are unsure your manifest matches the folder, the [fxmanifest.lua checker](https://rivo.tools/app/server-health?mode=manifest) compares it against the real files and flags data files that are never declared. To start from scratch, the [fxmanifest.lua generator](https://rivo.tools/app/server-health?mode=fxmanifest) writes one from the folder.

### Switching to a ped with code

Once the ped is streamed, any script can set it on a player. The model has to be requested and loaded first, then applied with SetPlayerModel. This client-side command is handy for testing:

```lua
RegisterCommand('setped', function(source, args)
    local model = GetHashKey(args[1] or 'mp_m_freemode_01')

    if not IsModelInCdimage(model) or not IsModelValid(model) then
        print('Unknown ped model')
        return
    end

    RequestModel(model)
    while not HasModelLoaded(model) do
        Wait(0)
    end

    SetPlayerModel(PlayerId(), model)
    SetPedDefaultComponentVariation(PlayerPedId())
    SetModelAsNoLongerNeeded(model)
end, false)
```

Type /setped my_ped in game to try it. Remove the command or gate it behind your admin system before the server goes live, since anyone could otherwise change their model. For NPCs, the same request and load steps apply before CreatePed.

#### Peds and frameworks

ESX, QBCore and similar frameworks usually set the player's model from their saved skin when they spawn. If your addon ped flips back to the freemode ped after a relog, that is the skin or appearance resource reapplying the saved model. Most appearance menus have a config list of allowed ped models where you can add your addon ped's name, so it is saved like any other skin.

### How to make a custom FiveM ped

Making a ped by hand means modelling the character, rigging it to the GTA V skeleton, splitting it into parts and exporting game files. A ped that is not fitted to the skeleton properly will deform badly or fail to play animations. The addon ped creator handles the fitting in the browser:

1. Describe a character, upload a picture of one, or drop your own 3D model.
2. Fit it to the GTA skeleton and test it with walks and emotes, so you can see it move before it reaches your server.
3. Download the addon ped resource, put it in your resources folder and add ensure to server.cfg.

Because the ped sits on the GTA skeleton, it plays every game animation, including the stock emotes your server already uses. If you want new moves for it, the [FiveM animation creator guide](https://rivo.tools/guides/fivem-animation-creator) shows how to make your own .ycd emotes. You can read more about what the ped tool covers on the [addon ped creator page](https://rivo.tools/fivem/addon-ped-creator).

### Keeping peds light and conflict free

Peds stream like any other asset, so a pile of heavy peds adds to join times and texture loss. A few checks keep them in shape:

- Run your resources through the [server load checker](https://rivo.tools/app/server-health?mode=stream) to see which files are the largest.
- Cap oversized texture dictionaries with the [texture optimizer](https://rivo.tools/app/optimize), which drops mip levels instead of recompressing.
- Shrink textures embedded in .ydd files with the [clothing optimizer](https://rivo.tools/app/optimize?mode=clothing), which leaves the geometry untouched.
- Use the [asset conflict finder](https://rivo.tools/app/server-health?mode=assets) to catch two resources streaming files with the same name, which is how an addon ped can end up overwriting another.

### Troubleshooting addon peds

- The model is invalid or nothing happens: the resource is not started, peds.meta is not declared with PED_METADATA_FILE, or the Name in peds.meta does not match the file names.
- The ped is invisible or has missing parts: a .ydd or .ytd is missing from the stream folder or was renamed.
- The ped loads with the wrong textures: another resource streams files with the same names. Check for clashes and rename one.
- The ped will not animate properly: the model was not rigged to the GTA V skeleton. Rebuild it on the correct skeleton.
- The ped resets on spawn: your framework's appearance resource is reapplying the saved skin. Add the ped to its allowed models.

With the model name, a stream folder, a declared peds.meta and an ensure line, any ped will load. For other custom assets, the [FiveM props guide](https://rivo.tools/guides/fivem-props) follows the same streaming pattern for objects.
