For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 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:

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.

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.


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 page.


Next steps

Model not Ready, save failing, copy not spawning? See Troubleshooting.