> For the complete documentation index, see [llms.txt](https://docs.rainmad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/source-files.md).

# Source files

To build a scaled copy, the scaler needs the model's original data. It looks in these places:

1. The `stream/` folder of every started resource: your **addon** models. Nothing to do.
2. The `source/` folder inside the scaler (`rm_scaler/source/` or `rm_scaler_redm/source/`): files you put there yourself.
3. RedM only: fivemad, for **base-game** peds and horses. Nothing to do.

Files are picked up within a minute, no restart. The model then shows **Ready** in the browser. `source/README.txt` in the resource has the same guide.

Once a copy is saved it no longer needs its source. You can delete the files from `source/`.

{% tabs %}
{% tab title="FiveM" %}

## Base-game models on FiveM

The server cannot read the game's archives, so you copy a base-game model's files into `rm_scaler/source/` once.

### Ped files

Everything that carries the ped's name. For `a_m_y_hipster_01`:

| File                     |          | What it is                    |
| ------------------------ | -------- | ----------------------------- |
| `a_m_y_hipster_01.yft`   | required | Skeleton                      |
| `a_m_y_hipster_01.ydd`   | required | Body parts                    |
| `a_m_y_hipster_01.ytd`   | required | Textures                      |
| `a_m_y_hipster_01.ymt`   | required | Clothing variations           |
| `a_m_y_hipster_01_p.ydd` | optional | Hats, glasses and other props |
| `a_m_y_hipster_01_p.ytd` | optional | Their textures                |

Some peds (most animals, the story characters `player_zero`, `player_one`, `player_two`) keep each body part in its own file, inside a folder named after the ped. Copy the `.yft` and `.ymt` plus the **whole folder**:

```
source/
  a_c_chop.yft
  a_c_chop.ymt
  a_c_chop/
    head_000_r.ydd
    head_diff_000_a_uni.ytd
    ...
```

Files named the FiveM way (`a_c_chop^head_000_r.ydd`) work too.

{% hint style="info" %}
Every part is scaled, props (`p_head`, `p_eyes`...) included, so a hat still fits the smaller head. Folder peds carry their whole wardrobe: a story character is several hundred files and the copy is about the same size.
{% endhint %}

### Prop files

One of these, named after the prop:

| File               | When                                                        |
| ------------------ | ----------------------------------------------------------- |
| `prop_bin_01a.ydr` | A normal prop                                               |
| `prop_bin_01a.yft` | A breakable prop (fragment)                                 |
| `prop_bin_01a.ytd` | Only if the prop has a texture dictionary with its own name |

No `.ytyp` is needed for base-game props: size, flags and LOD distance come from the game's own data, which ships with the script.

### Where to find them

Open the game folder in **CodeWalker** (RPF Explorer) or **OpenIV** and search the model name.

| Type  | Where                                                                                   |
| ----- | --------------------------------------------------------------------------------------- |
| Peds  | `x64v.rpf` / `x64e.rpf` > `models/cdimages/componentpeds_*.rpf` or `streamedpeds_*.rpf` |
| Props | `x64i.rpf` > `levels/gta5/props/...`                                                    |
| Newer | `update/x64/dlcpacks/<pack>/dlc.rpf/x64/...`                                            |

If a name shows up more than once, take the newest pack under `update/x64/dlcpacks`. That is the one the game loads.

### How to extract

| Tool       | Use                       | Not                              |
| ---------- | ------------------------- | -------------------------------- |
| CodeWalker | Right click > **Extract** | Extract Uncompressed, Export XML |
| OpenIV     | **Extract** / Copy to     | Export to openFormats            |

The file has to stay a binary resource. Opened in a text editor, it starts with `RSC7`.

{% hint style="warning" %}
Not usable: escrow-protected files, GTA V Enhanced (gen9) files, `.rpf` archives (extract the files first), vehicles.
{% endhint %}
{% endtab %}

{% tab title="RedM" %}

## Base-game peds on RedM

**Base-game peds and horses need nothing.** When you save one, the scaler downloads that ped's data from fivemad (`cfg.nui.mediaUrl`, about 15 KB) and writes the files itself. This covers 1,973 of the game's 1,982 peds and horses; the server needs outbound HTTPS. `mediaUrl = false` turns it off.

The files below are only needed for a ped fivemad has no data for (the editor says so), or when you want to build from your own export. RDR2's archives are encrypted and the server cannot read them, so you export those files into `rm_scaler_redm/source/` once.

### Ped files

| File             |          | What it is                                                   |
| ---------------- | -------- | ------------------------------------------------------------ |
| `a_c_cat_01.ymt` | required | The ped's outfit file                                        |
| `metapeds.ymt`   | required | The ped list, **exported as XML**; one file covers every ped |

Where they are in the game:

| File           | Where                                                                                                                         |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| outfit `.ymt`  | `update_4.rpf > x64/packs/base/data/metapeds/metapeds.rpf` (newest), or `packs_0.rpf > packs/base/data/metapeds/metapeds.rpf` |
| `metapeds.ymt` | `update_4.rpf > x64/packs/base/data/metapeds.ymt`                                                                             |

Any `.ymt`, `.meta` or `.xml` in `source/` that holds a `CPedModelInfo__InitDataList` is read, so the XML can keep any name.

### How to export

Open the game folder in **CodeX** (or another RDR2 tool) and search the name.

| File           | Export as                             |
| -------------- | ------------------------------------- |
| outfit `.ymt`  | The file itself (binary), **not** XML |
| `metapeds.ymt` | **XML**                               |

{% hint style="warning" %}
Not usable: files still encrypted (the game's own copies; export them first), GTA V files, escrow-protected files, `.rpf` archives, props and vehicles.
{% endhint %}
{% endtab %}
{% endtabs %}
