Koja Scripts
Cloth Tool

Common Errors

A field guide to the clothing problems you'll actually run into.

Common Errors

A field guide to the clothing problems you'll actually run into. Most are caught by the Cloth Doctor before you build — run it first.

Clothing doesn't appear in‑game

Likely causes:

  • You went past the 128 drawable limit for that slot in the collection. → See Game Limits. Split the pack across collections.
  • The .ymt / shop.meta didn't generate (the build warned about it). Without them the files stream but nothing appears in the menu. Rebuild and check the warnings.
  • Naming / collection mismatch — hand‑edited files, or the wrong gender ped. → Rebuild from the tool so names and metadata are generated correctly. See Naming Conventions.
  • The resource isn't started, or stream/ files didn't copy. → Check server.cfg and the built stream/ folder.

Garment shows up but has no texture (flat / grey / purple)

Likely causes:

  • The .ydd model has no UV coordinates — there's nothing for the texture to map onto. This is a model problem; it must be re‑exported with UVs.
  • The .ytd is in a compression format the game or the model doesn't handle, or the diffuse map isn't referenced.
  • There's no diffuse texture at all — neither embedded nor external.

The tool tells you which of these it hit when you attach a texture in the preview.

Fix: attach a correctly‑named diffuse .ytd, and Optimize it so it's in a supported BCn format. If the model has no UVs, it has to be fixed in your 3D tool.

"Texture is not power of two"

The texture's width or height isn't a power of two (256/512/1024/2048…). Fix: right‑click → Optimize (it resizes to the nearest power‑of‑two automatically).

"No mipmap levels"

The texture ships without mipmaps, causing shimmering at distance. Fix: Optimize generates mipmaps for you.

Texture is huge / pack is enormous

Uncompressed or oversized textures (e.g. a 4K skin) bloat the pack and hurt performance. Fix: Optimize everything — recompresses to BCn and caps sizes. Remember skin/raced textures only need 512×512.

"Invalid slice pitch" / DDS conversion errors

Some source DDS files (especially BC7 with a DX10 header) don't decode with older tooling. The Cloth Tool handles BC7 and the common BCn formats directly, so re‑importing and optimizing through the tool usually resolves it. If a specific file still fails, re‑export it as a standard DXT5/BC7 DDS and try again.

Server crashes when clothing loads

Usual suspects:

  • .ymt overflow — too many component‑variation .ymt files across all your resources. → Reduce feature‑heavy items or disable extra .ymt generation. See Game Limits.
  • Corrupt / badly compressed .ymt — don't hand‑edit; let the tool generate it.
  • Invalid shader names in a drawable break the clothing and can crash. Re‑export the model with a valid GTA clothing shader.

Embedded texture problems

  • Illegal characters in an embedded texture name → it silently stops working. Use the embedded‑texture editor's Rename (or re‑optimize) to clean it.
  • Wrongly named embedded textures → the model can't find them; the tool attempts an auto‑fix on optimize.

High heels don't work

High heels rely on the extra .ymt metadata. If you disabled extra .ymt generation (e.g. to stay under the file ceiling), heel support is turned off with it. Re‑enable it for items that need heels, and mind the overall .ymt count.

  • FAQ — Yes — for the 3D preview.
  • Limits — GTA V doesn't warn you when you go over a limit — it just fails to load the clothing, shows the wrong item, or crashes.
  • Naming — GTA V matches clothing files by their name, not their contents.
  • Information and Errors — back to the section overview