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

# Troubleshooting

## /scaler does nothing or says no permission

Add the ace and make sure your identifier is in that group:

```cfg
add_ace group.admin rm_scaler.use allow
```

Or be a framework admin with `cfg.access.frameworkAdmin = true`.

***

## A model is not Ready

The scaler has no data for it.

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

* **Base-game model:** extract its files into `rm_scaler/source/`. See [Source Files](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/source-files.md).
* **Addon model:** the resource that streams it must be started, and must not be in `cfg.source.ignore`.
  {% endtab %}

{% tab title="RedM" %}

* **Base-game ped or horse:** check `cfg.nui.mediaUrl` is set and the server can reach it; the scaler downloads the ped's data from there. A few peds have no data yet: export those into `source/`.
* **Addon model:** the resource that streams it must be started, and must not be in `cfg.source.ignore`.
  {% endtab %}
  {% endtabs %}

New files show up within a minute.

***

## Save errors

Both games share these messages:

| Message                                                          | Fix                                          |
| ---------------------------------------------------------------- | -------------------------------------------- |
| *A clone with this name exists*                                  | Tick **Overwrite**, or pick another name     |
| *That is a base-game model name*                                 | Clone names must be new                      |
| *Another resource already streams a model with this name*        | Pick another name                            |
| *Another clone already uses one of these file names*             | Delete that clone first, or rename           |
| *The source is an .rpf archive*                                  | Extract the model files out of the archive   |
| *cfg.output.resource names a resource the scaler did not create* | Point it at a new name, or remove the folder |
| *Another save is running*                                        | One save at a time server-wide, try again    |

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

| Message                                        | Fix                                                                                                                                                                  |
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *The source file is escrow protected*          | Encrypted streams cannot be read                                                                                                                                     |
| *The source file is a GTA V Enhanced resource* | Use the legacy (FiveM) version of the file                                                                                                                           |
| *The source file is not a readable resource*   | Re-extract with **Extract**, not Export XML                                                                                                                          |
| *The ped's .yft (skeleton) is missing*         | Copy the ped's `.yft` into `source/` as well                                                                                                                         |
| *No peds.meta entry found for this ped*        | Addon ped copied into `source/`: put its `peds.meta` next to it                                                                                                      |
| *This prop lives in a drawable dictionary*     | Not supported                                                                                                                                                        |
| *This animal cannot be scaled cleanly*         | Not supported for that animal, see **Limits** on the [scaling page](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/scaling.md#limits) |
| {% endtab %}                                   |                                                                                                                                                                      |

{% tab title="RedM" %}

| Message                                                | Fix                                                   |
| ------------------------------------------------------ | ----------------------------------------------------- |
| *The source file is still encrypted*                   | Export it again without encryption                    |
| *The source file is Oodle compressed*                  | Export it again uncompressed or with Deflate          |
| *The source file is a GTA V resource*                  | RedM needs RDR2 files                                 |
| *The source file is not a readable RDR2 resource*      | Export the binary file, not XML                       |
| *The ped's outfit file is missing*                     | Put `<ped>.ymt` into `source/`                        |
| *No CPedModelInfo entry found for this ped*            | Put `metapeds.ymt` exported **as XML** into `source/` |
| *fivemad has no clone data for this ped yet*           | Export its files into `source/`                       |
| *Could not reach the media server*                     | The server needs outbound HTTPS to `cfg.nui.mediaUrl` |
| *The ped data from the media server could not be read* | Update rm\_scaler\_redm                               |
| *The RedM scaler sizes peds and horses*                | Props are not supported, pick a ped or a horse        |
| {% endtab %}                                           |                                                       |
| {% endtabs %}                                          |                                                       |

Anything else: the full error is in the server console.

***

## Saved, but the copy does not spawn

The output resource was not restarted. Either:

* add the aces from [Installation](https://docs.rainmad.com/resources/scale-peds-props-and-horses-fivem-and-redm/installation.md#4-let-it-restart-the-output), or
* run `refresh` and `ensure rm_scaler_output` (RedM: `ensure rm_scaler_redm_output`) yourself.

The editor tells you which one applies after the save.

***

## Spawned copies disappeared

Expected. Every save or delete restarts the output resource, and models from the old files are removed. Spawn them again.

***

## The copy is invisible or looks wrong

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

* Re-extract the source with **Extract** in CodeWalker or OpenIV. Files that went through XML or "Extract Uncompressed" are not valid resources.
* For folder peds, copy the whole folder, not just a few parts.
* A ped's swinging clothes (`.yld` cloth) are not scaled yet; pick another variation for that slot.
* **I overwrote a ped copy and it still looks wrong:** a connected player keeps the old `peds.meta` entry of an overwritten ped copy until they restart their game. The mesh updates, the ped data does not. Players who start the game afterwards get the new one. While testing sizes, save each try under a new name.
  {% endtab %}

{% tab title="RedM" %}
RDR2 peds need an outfit after they are created. Call `Citizen.InvokeNative(0x283978A15512B2FE, ped, true)` (random outfit) or apply an outfit preset, as with any RDR2 ped.
{% endtab %}
{% endtabs %}

***

## /setscale does not show on other players

State bags need OneSync. Also check `cfg.playerScale.enabled`, and that the value is within `min` / `max`.

***

## Notifications or prompts are missing

Check the console on start for:

```
cfg.bridge.notification = xyz but no adapter registered
```

The name in `cfg.bridge` does not match a shipped adapter. Fix the spelling or set it back to `'builtin'`.
