How to optimise FiveM textures and fix oversized assets
A streamed FiveM asset gets heavy when its textures are larger than they need to be, uncompressed or missing mipmaps. RageKit's Server Doctor scans a whole server and lists every asset that needs more than 16 MB of physical or virtual memory, plus textures without mips, uncompressed or above 2048 px. The Texture optimizer in the RPF Explorer then resizes, compresses and completes the mips of every .ytd and embedded model texture in a folder, with a dry run that shows the saving before anything is written.
Before you start
- RageKit on Windows 10 or 11.
- The FiveM server folder (the one with
resources/andserver.cfg), or just the resource you want to slim down. - Premium only to write the changes. The scan, the Texture optimizer's analysis and its preview of the saving are free; applying the optimizer, or a fix from inside Server Doctor, needs Premium.
Steps
Scan the server
Open Server › Doctor, choose Choose server folder… and pick the server data folder or its resources folder, then Scan. Scanning is free and changes nothing.
Find the heavy assets
The Dashboard shows Memory by resource and a Heaviest assets table with physical and virtual memory per file. In Findings, filter by
ASSET_OVERSIZEDorTEXTURES_UNOPTIMISED.ASSET_OVERSIZEDis a streamed asset that needs more than 16 MB of physical or virtual memory. The finding names its largest textures.TEXTURES_UNOPTIMISEDcounts the textures in a file that have no mips, are uncompressed or are larger than 2048 px, with an estimate of the saving.
Open the resource in the RPF Explorer
Use Open in RPF Explorer on a finding or a resource, or choose Open folder… in the RPF Explorer and pick the resource folder yourself.
Open the Texture optimizer
Right-click the
streamfolder, a single file or a selection and choose Texture tools › Texture optimizer…. On one file the entry reads Optimize textures…. Every.ytdand every model with embedded textures below the selection is analysed.Pick the settings
The defaults are Max size 2048 px, Format Auto (recommended) and Mips Complete missing. Lower Max size, or set a size per kind (Diffuse, Normal, Specular, Detail, Other) to shrink some kinds further than others.
- Auto picks BC1 without alpha, BC3 with alpha (BC7 if you tick Use BC7) and BC5 for uncompressed normal maps, and never a bigger format.
- The Oversized, Uncompressed, Missing mips and NPOT filters show only the textures with that flag.
- The sliders button on a row overrides the format, size or mips of one texture, or leaves it as is.
Preview the saving
Choose Preview savings. It's a dry run: every file is planned without being written, and the footer shows the size before and after. Rows that can't be changed are marked Can't apply.
Apply
Choose Apply to N files and confirm with Optimize; applying needs Premium. Each file is rewritten with the new sizes, formats and mips, and textures that don't change keep their data.
Scan again
Back in Server Doctor choose Scan again. Only changed files are read again, so the second scan is quicker. Restart the resource and check the textures in game.
Fixing it from Server Doctor instead
A finding with textures to fix has an Optimise… button, and the Dashboard has Optimise all… when several files qualify. Both use fixed settings: at most 2048 px, BC-compressed (Auto) and full mip chains.
The fix is previewed first with the size of each file before and after. Apply needs Premium. Changed files are copied into ragekit-backups/ next to resources/ first, and Undo in the Backups tab puts them back.
Use the Texture optimizer when you want other settings or a different limit per texture kind. Applying it needs Premium too.
Common problems
The asset is still over 16 MB: if the finding names virtual (system) memory, the weight is in the model, not its textures. Server Doctor's advice there is to reduce its geometry or split it into several models.
A file grew slightly: adding a missing mip chain adds data. It stops distant textures shimmering and lets the game stream smaller levels.
A texture is marked Can't apply: hover the row for the reason. GTA V Enhanced files can be read but not rewritten.
Questions
What counts as an oversized asset in FiveM?
Server Doctor flags any streamed asset that needs more than 16 MB of physical (graphics) or virtual (system) memory, because above that streaming gets unreliable. Physical memory is mostly textures; virtual memory is mostly the model.
How do I reduce the size of a YTD file?
Open its folder in the RPF Explorer, right-click the .ytd and choose Texture tools › Optimize textures…. Limit the size, keep Format on Auto, choose Preview savings and then Apply.
Which texture size should I use for a FiveM vehicle or map?
The app's recommended limit is 2048 px, and anything larger is flagged. You can go lower per kind, for example a smaller limit for normal and specular maps than for diffuse textures.
Does it only work on .ytd files?
No. It also optimises textures embedded in .ydr, .ydd, .yft and .ypt files. The dry run checks what fits in an embedded dictionary.
Tools in this guide
Related guides
- How to replace textures in a YTD fileOpen a GTA V .ytd, export textures to PNG or DDS, edit them, and replace them one by one or from a folder, then optimise oversized textures.
- How to find and fix FiveM stream conflictsFind files streamed by two FiveM resources under the same name, see which copy the game uses, and remove the losing duplicates with a backup and undo.
- How to find out why FiveM crashedRead FiveM crash dumps and logs to find the likely cause and the resource behind it, then check your server for conflicts and oversized assets.
Get RageKit
Free download for Windows 10 and 11. No account needed for the free tools.
There's no Windows installer on the latest release yet. Check the changelog for when it lands.
