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

# Player scale

`/setscale` resizes a player on the spot, for everyone around them. Good for events, admin fun and videos. It is optional and can be turned off.

```
/setscale <id> <scale>          uniform, e.g. /setscale 12 0.5
/setscale <id> <x> <y> <z>      per axis, FiveM only, e.g. /setscale 12 1 1 1.4
/setscale <id> reset            back to normal
```

Same permission as the editor, and it works from the server console.

***

## How it works

The scale is stored in the player's state bag, so it syncs to every client and to players who join later.

{% tabs %}
{% tab title="FiveM" %}
Each client draws scaled players near it with `SetEntityMatrix`, only while someone in range is actually scaled. Nothing runs when nobody is.

{% hint style="warning" %}
This is **visual only**. The hitbox, collision and camera keep their normal size, and some animations can flicker. For a model that really is a different size, save a copy in the [editor](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/scaling.md) and set it as the player's model.
{% endhint %}

Vehicles and ragdolling players are skipped. The scale is cleared when the player drops.
{% endtab %}

{% tab title="RedM" %}
Each client applies the game's own ped scale to the scaled players it has streamed in, and again after a respawn or a model change. Nothing runs every frame.

RDR2 scales a ped as a whole, so the scale is one value: three different values for X, Y and Z are refused.

{% hint style="info" %}
For a ped model that is always a different size (an NPC, a horse, a pet), save a copy in the [editor](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/scaling.md) instead: the size is then part of the model and every script that spawns it gets it.
{% endhint %}
{% endtab %}
{% endtabs %}

***

## Config

```lua
cfg.playerScale = {
    enabled = true,
    command = 'setscale',
    min     = 0.3,
    max     = 3.0,
}
```

Values outside `min` / `max` are refused. `enabled = false` removes the command.
