> 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/readme.md).

# README

**Scale peds, horses and props without bugs. A model scaler for FiveM and RedM.**

Pick a model, set its size in game with a live preview, and save it. The script writes a real scaled copy of the model under its own name into a streamed resource. Spawn it from any script and it stays that size, with nothing running every frame.

There are two resources, one per game, and this documentation covers both:

| Game  | Resource         | Scales                   |
| ----- | ---------------- | ------------------------ |
| FiveM | `rm_scaler`      | Peds, animals and props  |
| RedM  | `rm_scaler_redm` | Peds, horses and animals |

Where the two work differently, a page shows a **FiveM** and a **RedM** tab. [FiveM and RedM](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/differences.md) lists every difference on one page.

***

## Why a real copy

Scaling a ped with natives (a `SetEntityMatrix` loop on FiveM, a script that calls the ped scale native on RedM) only lasts as long as that script keeps doing it. On FiveM the hitbox stays full size and the ped jitters when it animates. On RedM every new ped, from your stable or any other script, spawns full size unless that script scales it too.

`rm_scaler` writes the size into the model itself:

{% tabs %}
{% tab title="FiveM" %}
The saved copy is the model file scaled: mesh, skeleton, collision, LODs and metadata. Peds get their own `peds.meta` entry, props a `.ytyp` with scaled bounds. The game treats it like any other model. The per-frame matrix is used only for the **preview** in the editor.
{% endtab %}

{% tab title="RedM" %}
RDR2 peds are built from shared body parts and have no model file of their own: a ped is an entry in the game's ped list plus an outfit file, and every outfit carries its own scale (the value Rockstar uses to make one horse coat bigger than another). A copy is a new entry under a new name plus the outfit file with every outfit's scale changed, so the game draws the whole ped at the new size.

**No game files to extract for base-game peds.** When you save a base-game ped or horse, the scaler downloads its data from fivemad, so you need no CodeX or other export tool. Addon peds are built from their own files.
{% endtab %}
{% endtabs %}

***

## Features

**Live preview.** Set the size and see it in game, next to the original if you like, with an orbit camera.

**Two ways to pick.** Point at a model in the world, or choose from the picture browser: the base-game models plus the ones your server already streams.

**One output resource.** Every saved copy goes into one output resource, which restarts itself after a save so the new model streams right away.

**Library.** Every copy you saved, with its scale and files. Spawn it, overwrite it or delete it from the same panel.

**Live player scale (optional).** `/setscale <id> <scale>` resizes a player for everyone through state bags. Handy for events and videos.

**Bridged.** Qbox, QBCore and ESX on FiveM; VORP, RSG or standalone on RedM. Notifications and text UI are one-word swaps in `cfg.bridge`. Adapters sit outside escrow.

***

## Requirements

`ox_lib` and a recent server build (the core runs on Node 22). Full list on the [Installation](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/installation.md) page.

***

## Next steps

* [Installation](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/installation.md)
* [Scaling a Model](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/scaling.md)
* [Source Files](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/source-files.md)

Model not Ready, save failing, copy not spawning? See [Troubleshooting](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/troubleshooting.md).
