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

Game Limits and Crashes

Learn about GTA V's clothing and tattoo related game limits and crashes

GTA V Game Engine limits

Internally the game has a fixed amount of .ymt files that can be loaded in total. This limit seems to be 80 (before mpg9ec) around 100 (since mpg9ec) .ymt files per gender in total. With every GTA: Online DLC that is pushed, R* adds new clothes and therefore takes up more .ymt files - until the limit is reached.

Additionally there is a limit of components/props that can be added per drawable/component type.

Clothes are categorized into components and props, where components are everything you wear as clothes (Shirts, Pants, Shoes etc) and props are everything you can put on top of your model (like hats, glasses, watches, ear rings etc.)

Internally we call all these types together drawable types, the game currently has 25 drawable types in total. Some of them are unused tho.

128 drawables (component / prop) per type, per gender

Durty Cloth Tool uses 128 cloth items per drawable type and gender as legacy compatibility guidance. When FiveM Resource is selected, DCT automatically accounts for FiveM's patched component range and suppresses the obsolete 128 warning for components. FiveM props retain the 128 synchronization advisory because the component patch does not cover prop synchronization. DCT still refuses to build more than 255 drawables of one type because that collection/file-format boundary is separate.

For example, you can have 128 cloth items of type PV_COMP_JBIB (Component id 11 / Shirts) for your male in one addon cloth resource. With 26 variations per cloth item, this would be 128 * 26 = 3.328 shirt variations. Going beyond 128 requires matching runtime support and careful testing.

The legacy 128 synchronization boundary does not apply to Singleplayer in the same way. Other file, loading and Durty Cloth Tool limits still apply and should not simply be ignored.

255 global prop index boundary

Older runtimes store parts of the global prop index in 8 bits. Because base-game and DLC props also use those indices, addon props beyond the global 255 boundary may fail to appear. This is not a limit of 255 items inside one custom collection.

Use a FiveM version that includes the prop-index patch. Singleplayer requires a separate limit adjuster, described below.

Bypassing the prop limits for Singleplayer

GTA5Mods users Zombieguy and William Halverd have made an ASI version of the FiveM patch for Singleplayer. It removes the affected 8-bit prop-index truncation. Treat it as a fix for invisible props past the old boundary, not as unlimited prop capacity.

This patch was tested on the game build 3095 Chop Shop Update and it will work at least the older game build / version 2372 (Los Santos Tuners).

To install it, simply drag and drop into the root folder of GTA V. You will need the latest ASI loader and ScriptHookV for it to work as intended.

Download the ASI file here: https://www.gta5-mods.com/scripts/pedprop-limit-adjuster (Credits: Zombieguy and FiveM team)

High heels at global component indices above 255

High-heel height is stored in component expression metadata. Older lookup paths could truncate the global component index used to find that expression data. This was an index-resolution issue, not a documented limit of 255 high-heel configurations.

For FiveM targets, Durty Cloth Tool accounts for the patched global prop and high-heel lookup paths automatically. The collection/file-format limits still apply. Always test the complete resource set on the GTA V and multiplayer build you use.

YMT Limit in detail

YMT limit applies to each gender seperately.

For example, if we talk about 10 additional free .ymt slots available, it means you have 10 .ymt slots for female and 10 .ymt slots for male ped.

Lets take a look at how Rockstar Games takes up the free .ymt slots every update:

  • In game version b1604 (mpchristmas2018) we had 14 additional free .ymt slots to be used

  • In game version b1737 (mpvinewood) we had 12 additional free .ymt slots to be used

  • In game version b1868 (mpheist3) we had 10 additional free .ymt slots to be used

  • In game version b2060 (mpsum) we had 8 additional free .ymt slots to be used

  • In game version b2189 (mpheist4) we had 6 additional free .ymt slots to be used

  • In game version b2372 (mptuner) we had 4 additional free .ymt slots to be used

  • In game version b2545 (mpsecurity) we have 2 additional free .ymt slots to be used

  • In game version b2612 (mpg9ec), R* seems to have increased the YMT limit, we have about 20 additional free .ymt slots to be used

  • In game version b2699 (mpsum2), we have about 16 additional free .ymt slots to be used

  • In game version b2802/b2824/b2845 (mpchristmas3), we have about 14 additional free .ymt slots to be used

  • In game version b2944 (mp2023_01), we have about 12 additional free .ymt slots to be used

  • In game version b3095 (mp2023_02), we have about 10 additional free .ymt slots to be used

  • In game version b3258 (mp2024_01), we have about 8 additional free .ymt slots to be used

  • In game version b3407 (mp2024_02), we have about 6 additional free .ymt slots to be used

  • In game version b3570 (mp2025_01), we have about 5 additional free .ymt slots to be used

  • In game version b3717 (mp2025_02), we have about 4 additional free .ymt slots to be used

  • In game version b3889 (mp2026_01), we have about 3 additional free .ymt slots to be used

creaturemetadata YMT files

Please note that adding high heels or head-prop hair expression modifiers to your pack can create an additional YMT file known as creaturemetadata, which counts towards the game-build YMT capacity. For example, gamebuild b3095 (mp2023_02) has about 10 additional free .ymt slots.

A pack with male and female clothing plus female high heels normally creates three YMT files: male clothing, female clothing, and the shared creature metadata file.

When FiveM is selected, DCT compares the YMT slots used by the current project, separately for male and female, with the selected-build guidance. DCT conservatively budgets the shared creature metadata file against both genders, although it is generated only once. Current guidance includes about 5 free slots on b3570, 4 on b3717, and 3 on b3889. DCT cannot count YMT files from other loaded resources, so server owners must still budget the complete resource set.

Effects of reaching the YMT limit

Using up more than the additional free .ymt slots for one gender in the given versions, will end up with your game crashing or other weird issues.

For example in FiveM you will end up with crashes like:

Example GTA V game crash when hitting the games cloth related YMT limit
  • b1604: oven-happy-sad || GTA5.exe!sub_1406B14FC (0xf)

  • b2189: earth-august-saturn || FiveM_b2189_GTAProcess.exe!sub_1406D21B0 (0xf)

  • b2372: yellow-stairway-december || FiveM_b2372_GTAProcess.exe!sub_14070E7A8 (0xf)

  • b2545: zebra-east-berlin || GTA5_b2545.exe!sub_140712C8C (0xf)

  • b2944: low-cola-sweet || GTA5_b2944.exe!sub_14071C644 (0xf)

  • b3095: iowa-beryllium-missouri || GTA5_b3095.exe!sub_140722454 (0xf)

While you will be receiving errors in the console similar to:

Why not put all clothes in one big .ymt file

Durty Cloth Tool uses 128 (0-127) cloth items per drawable type and gender as its conservative legacy compatibility range. Drawable types are jbib, feet, teef etc. - each type representing model parts like pants, shirts, hats. FiveM component builds automatically use the patched 0-255 range when FiveM is selected. FiveM props and other targets retain the legacy advisory, and every target stops above 255 per type.

When this compatibility range is reached, create a new .ymt file if you need to stay within 128 items per drawable type and gender.

The most simple way to avoid these issues is to keep your addon cloth packs to a minimum and count YMT files separately for each gender. The available slots depend on the game build and other loaded resources.

You will always need to keep in mind that every cloth collection created for one gender will create one .ymt file. High heels and head-prop hair expression modifiers can additionally create one shared creaturemetadata.ymt file.

Examples

Lets say we run some multiplayer mod with the GTA Online Update mptuner, which has about 4 free YMT slots per gender.

We create one basic addon cloth pack with female and male clothes, without high heels or head-prop hair modifiers. It creates one female and one male clothing YMT, using one slot for each gender.

High heels and head-prop hair expression modifiers can generate an additional creature metadata YMT that must also be included in the resource budget.

Another example would be creating two basic addon cloth packs, each having male and female clothes without those features. This creates two male and two female clothing YMTs, using two of the four slots for each gender before accounting for other resources.

Each of our basic addon cloth pack / resource will take up 2 YMTs (1x male clothes, 1x female clothes)

Lets do another one with one advanced addon cloth pack. A pack containing female and male clothes plus high heels or head-prop hair modifiers creates the two clothing YMTs and a shared creature metadata YMT. Count all generated files and test the complete resource set on the selected build.

High heels and head-prop hair expression modifiers can add the creature metadata YMT needed to make those features work.

TxdStore Pool Full, Size == 95500 error

Adding more YTD files than a certain limit by either putting new vehicles, new clothes, new MLOs or similar on your server, will possibly cause a game pool full error, which essentially means that you have hit the total amounts of YTD files supported by the game.

This error was previously known as pool full size == 85500

For example in FiveM you will end up with crashes like:

GTA V Texture pool full game crash

On FiveM platform its meanwhile possible to increase the YTD related pool size, this is usually not considered best practice but it is possible. Please see the FiveM Server Docs to learn how to increase the TxdStore Pool Size: https://docs.fivem.net/docs/server-manual/server-commands/#increase_pool_size-poolname-increase

RAGE Error: ERR_MEM_MULTI_ALLOC_FREE

What is ERR_MEM_MULTI_ALLOC_FREE?

This error can be related to the Ped Alternate Variations feature (pedalternatevariations.meta). This feature defines alternative models for clothing or hairstyles to prevent visual glitches when certain clothing items, like large masks or hoodies, are worn. The capacity is 128 results before GTA V build b2189, 160 from b2189 onward, and 512 on FiveM builds that include the related limit fix.

Possible Cause of the Error

On an affected legacy build, exceeding the alternate-variation working capacity can cause this error. For example, this can happen when many addon hairstyles or clothing items use the Ped Alternate Variations system. The capacity is build/runtime-dependent and the same crash name can have unrelated causes.

  • For instance, on a legacy 160-entry path, 81 existing hairstyles plus 79 custom hairstyles can fill the working set required by a large mask that alters every hairstyle.

How to Fix when caused by Alternate Variations Limit

  1. Temporary Workaround: You can delete the pedalternatevariations.meta file and its reference in the fxmanifest file. Keep in mind that this will disable some features, such as removing or cutting hair with large masks or hoods.

  2. Reduced DCT output: Durty Cloth Tool includes an option called "Disable extra alternate variation features," which generates fewer entries. This can help on legacy paths, although some features like hair cutting with masks might not work as intended.

Long-Term Solution for Alternate Variations Limit

Use a FiveM client build that includes the 512 alternate-variation fix. If the crash still occurs, report it on the FiveM GitHub with the client/server build, crash dump and a resource that reproduces the problem.

When FiveM is selected as the DCT target, DCT includes the complete supported Rockstar hair references and rejects generated metadata when more than 512 switches match the same source lookup. DCT cannot measure matching entries contributed by other loaded resources.

The 512-entry cache capacity was merged in PR #3190. PR #3195 added the related bounds guard. The same ERR_MEM_MULTI_ALLOC_FREE crash can also have unrelated causes.

There is no specific limit to the amounts of tattoos that can be added in total to the game or per tattoo collection. The total amount of tattoos that can be added is limited by the following game limits:

  • TxdStore Pool Size as tattoos are YTD based: TxdStore Pool Full, Size == 95500 error

  • Imported YTD size: Durty Cloth Tool rejects imported YTD files that are 100 MB or larger.

  • Generated tattoo files: Durty Cloth Tool creates one YTD per tattoo instead of placing every tattoo texture in one large YTD.

Durty Cloth Tool performs its normal tattoo texture optimization during the build. Optimize unusually large source textures if the resource still consumes too much texture memory.

Replacing vanilla / R* clothes

In case these limits don't satisfy your needs of adding hundreds of more modding clothes, the only case to workaround these limits is currently by overwriting clothes provided by the game itself. (So called replace mods / clothes)

Durty Cloth Tool supports this through the advanced Replace GTA DLC clothes build option. It replaces the complete selected clothing collection, not one individual model or texture. Replacing a collection can remove original items and shift later global drawable IDs, so addon clothing remains the safer default.

Pleb Masters: Forge is a useful tool to figure out texture & model file paths of clothes you want to replace, as you will need the file names and collection names for replacing them. See https://forge.plebmasters.de/clothes/

Pleb Masters: Forge Cloth details with file paths

Credits

Thanks to FumaPraQue for his contribution to researching this over at the FiveM forums: https://forum.cfx.re/t/setplayermodel-crash-when-you-have-too-much-ymts-assigned-to-a-freemode-ped-model/1934063

Laatst bijgewerkt