# 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](/cloth-tool/information-and-errors/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](/cloth-tool/information-and-errors/naming).
* 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](/cloth-tool/information-and-errors/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.

***

:::hint{type="success"}
**One habit prevents most of this:** import → **Optimize** → run the **Cloth Doctor** → clear the reds → **Build**. Do that every time and the list above rarely applies.
:::

## Related pages

- [FAQ](/cloth-tool/information-and-errors/faq) — Yes — for the 3D preview.
- [Limits](/cloth-tool/information-and-errors/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](/cloth-tool/information-and-errors/naming) — GTA V matches clothing files by their name, not their contents.
- [Information and Errors](/cloth-tool/information-and-errors) — back to the section overview