Find Your Error
Click the symptom. Do not start by clearing cache. Crashes: decision tree. Cause / confirm / fix: Quick Error Reference.
Difficulty: Easy · Affects: both
INFO
Search the log for: TxdStore, Pool Full, invalid fixup, ERR_MEM_MULTI_ALLOC_FREE, entitlement, YMT.
Crashes
| Crash while joining | YMT budget, TxdStore, corrupt stream, or entitlement. Disable all clothing first. | crash-on-join | |
| Crash on character load | Freemode metadata. Count YMTs for that gender — even if they wear vanilla. | crash-on-character-load | |
| Only one gender crashes | Male and female are separate pools. Do not add the two counts. | ymt-limits | |
| Broke after a game-build change | New DLC usually ate YMT slots. The pack often did not change. | crash-after-game-build-change | |
| Crash putting on one item | That YDD. Remove it and the crash should follow the file. | crash-on-specific-clothing | |
| Not sure which crash | Yes / no path. Isolate clothing, then read the log string. | crash-decision-tree |
Looks
| Invisible clothing | Naming, YMT not registered, resource never started, or Enhanced conversion. | invisible-clothing | |
| Invisible hat / glasses / watch | Props, not components. Check `p_` names and the client patch. | invisible-props | |
| Black / missing texture | Wrong or missing YTD, shader, or DDS. Letter `a` vs `b`. | black-textures | |
| Blurry clothing | Resolution, mipmaps, compression — or the 512 skin-tone cap. | black-textures | |
| Heels flat / feet in the floor | Creaturemetadata YMT missing, never loaded, or no free slot. | high-heels | |
| Hair through hat or mask | Creaturemetadata, hair weights, or ped alternate variations. | hair-clipping | |
| Outfit IDs shifted | Global index moved. Use collection natives. Lock `ensure` order. | clothing-ids-changed | |
| Pack “started”, everyone vanilla | Clothing-support policy, entitlement, or the wrong `ensure`. | pack-installation-checklist |
Log messages
| TxdStore Pool Full | Any size number. Too many texture dictionaries on the whole server. | txdstore-pool-full | |
| Invalid fixup | Named RSC file — usually a YDD. Replace that file. Do not decrypt. | invalid-fixup | |
| ERR_MEM_MULTI_ALLOC_FREE | Possible alternate-variation overflow. Also has non-clothing causes. | err-mem-multi-alloc-free | |
| You lack the required entitlement | The license-key owner does not own the escrowed asset. | entitlement-errors | |
| InvokeNative around ped spawn | Often associated with YMT exhaustion. Not unique proof. | ymt-limits | |
| Crash hash + freemode spawn | Commonly associated with YMT on that build. Never 100%. | known-crash-hashes |
Platform
| Works on Legacy, fails on Enhanced | Convert open YDD/YTD with Alchemist. Escrow is not on Enhanced yet. | legacy-vs-enhanced | |
| Works for some players only | Client channel, incomplete download, DX, or entitlement. | works-for-some-players | |
| Stutter / huge download, no crash | Size and streaming — not YMT slots. Gigabytes are not slots. | pack-size-vs-game-limits | |
| Broke after installing another pack | Often a shared budget the server was already near. Not automatic proof the pack is trash. | common-myths |
Still stuck
| Isolate which pack | Split clothing resources. Test both genders. Do not disable 40 packs one by one. | binary-search | |
| Open a ticket | Fill the checklist. Include the crash string. Never a license key. | before-opening-a-ticket |