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

# Scaling

Type `/scaler` in game. The editor opens on the **Browse** tab.

***

## 1. Pick a model

**From the browser.**

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

| Tab    | Shows                                                    |
| ------ | -------------------------------------------------------- |
| Peds   | The base-game peds, with pictures (see **Limits** below) |
| Props  | Every base-game prop, with pictures                      |
| Server | Models your server streams, plus everything in `source/` |

Models with a green **Ready** badge have source files and can be saved.
{% endtab %}

{% tab title="RedM" %}

| Tab    | Shows                                                             |
| ------ | ----------------------------------------------------------------- |
| Server | Addon peds your server streams, plus everything in `source/`      |
| Peds   | Every base-game ped and horse, with a picture of its first outfit |

Models with a green **Ready** badge can be saved: an addon ped whose files your server has, or a base-game ped or horse (its data comes from fivemad when you save). Peds without a picture (some online characters and horses fivemad could not draw) are listed last.
{% endtab %}
{% endtabs %}

Tick *Only models with source files* to hide the rest. Anything else can still be previewed, but it needs its files in `source/` before it can be saved (see [Source Files](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/source-files.md)).

**From the world.** Press **Pick in world**, look at a model and press `E`. `Backspace` goes back to the editor.

| Game  | Can be picked                           | Cannot be picked                  |
| ----- | --------------------------------------- | --------------------------------- |
| FiveM | Peds and props                          | Vehicles                          |
| RedM  | Peds and horses (they turn see-through) | Props, vehicles, wagons and boats |

***

## 2. Scale it

The **Scale** tab:

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

* **Width / Depth / Height** sliders, with **Lock axes** to keep proportions.
* Peds always scale uniformly. A skinned body only stays correct at the same scale on every axis, so the lock is forced on for peds.
* **Side by side** puts the original next to the preview.
* Drag the view to orbit, scroll to zoom.

The preview is drawn with a per-frame matrix and is only on your screen.
{% endtab %}

{% tab title="RedM" %}

* The size slider: the game scales a ped as a whole, so the three axes move together.
* **Side by side** puts the original next to the preview.
* Drag the view to orbit, scroll to zoom.

The preview is drawn at the new size with the game's own ped scale.
{% endtab %}
{% endtabs %}

Nothing is written until you save.

***

## 3. Save

| Field                    | What it does                                             |
| ------------------------ | -------------------------------------------------------- |
| Clone name               | The new model name. Defaults to `<model>_s1`, `_s2`...   |
| Scale LOD distances      | FiveM props only. Bigger props stay visible further away |
| Overwrite existing clone | Replace a copy with the same name                        |

Press **Save to stream**. The files go into the output resource's `stream/` folder (`rm_scaler_output` or `rm_scaler_redm_output`), the output resource restarts, and **Spawn clone** puts the new model in front of you once it has streamed.

{% hint style="info" %}
The clone name must be new. It cannot be the source's own name, a base-game name, or a model another resource already streams.
{% endhint %}

{% hint style="warning" %}
FiveM, overwriting a **ped** copy: players who are already connected keep its old `peds.meta` entry until they restart their game, so the new size can look off for them until then. To try a different size during a session, save it under a new name.
{% endhint %}

***

## 4. Use the copy

The copy is an ordinary model. Use its name wherever a model name goes: ped menus, `SetPlayerModel`, NPC spawners, stable scripts, and on FiveM `CreateObject`, target scripts and map editors for props.

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

```lua
local model = `a_m_y_hipster_01_s1`
lib.requestModel(model)
local ped = CreatePed(4, model, coords.x, coords.y, coords.z, heading, true, false)
```

{% endtab %}

{% tab title="RedM" %}
As with every RDR2 ped, give a spawned one an outfit:

```lua
local model = `a_c_cat_01_s1`
lib.requestModel(model)
local ped = CreatePed(model, coords.x, coords.y, coords.z, heading, true, false, false, false)
Citizen.InvokeNative(0x283978A15512B2FE, ped, true) -- _SET_RANDOM_OUTFIT_VARIATION
```

{% endtab %}
{% endtabs %}

***

## Horses and animals (RedM)

Horses (`a_c_horse_*`) and animals are peds in RDR2, so they scale the same way: pick one, set the size, save. The size is part of the copy's outfit data, so the game draws the whole horse at that size, mane and tail included. Use the copy name in your stable or spawner like any horse model.

Saddles, bags and blankets that a stable script adds later have not been checked on a scaled copy yet. Try them on your own server before you sell a scaled horse with tack.

{% hint style="info" %}
A smaller horse can be ridden, but the rider sits as high above its back as on a full-size horse, so below about 0.8 the rider floats a little. The game sets that height, not the copy.
{% endhint %}

***

## 5. Library

The **Library** tab lists every copy with its source, scale and files:

* **Spawn** places it in front of you.
* **Delete** removes its files and restarts the output resource.

***

## Limits

Both games:

* Peds scale uniformly (same value on X, Y and Z).
* Escrow-protected files and `.rpf` archives cannot be read.

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

* Vehicles cannot be scaled.
* Cloth parts of a ped (jackets that swing, `.yld` files) are not scaled yet. Those parts are left out of the copy.
* Props packed in a drawable dictionary (one `.ydd` holding many props) cannot be scaled one by one.
* GTA V Enhanced files cannot be read.
* Some animals are not offered: the rat, deer, coyote, cow, pig, boar, mountain lion, panther, pigeon, the big dogs (shepherd, rottweiler, husky, retriever, Chop) and the newer `_02` versions of the deer, coyote, boar, mountain lion, rottweiler and Chop. Their walk animations hold the front legs at the original length, so a bigger or smaller copy would walk with legs that do not fit its body. Every other animal (cats, the pug, poodle and westie, birds, rabbits, monkeys, fish, sharks, whales) scales cleanly.
  {% endtab %}

{% tab title="RedM" %}

* Peds, horses and animals only. Props, vehicles, wagons and boats cannot be scaled.
* Still encrypted or Oodle compressed files cannot be read.
  {% endtab %}
  {% endtabs %}
