# Troubleshooting

If something feels off, start here

<details>

<summary>Cosmetics Don't Show</summary>

* run `/cosmetics reload`
* check `features` in `config.json`
* make sure the player has access

</details>

<details>

<summary>Models Do Not Show</summary>

* run `/cosmetics reload pack`
* check `pack.paths.source_root`
* check `pack.layout`
* make sure the model and texture paths match

</details>

<details>

<summary>Shop Unlocks But Nothing Equips</summary>

That part is normal

Shop unlocks the cosmetic

Players still equip from the cosmetics menu

</details>

<details>

<summary>Wardrobe Does Not Open</summary>

* make sure the wardrobe has `view_location`
* make sure it has `leave_location`
* make sure it has `npc_location`
* run `/cosmetics cleanup` if preview entities got stuck

</details>

<details>

<summary>Sprays Do Not Place</summary>

* make sure a spray is selected
* check `sprays.allowed_hosts` if you use URL sprays
* check `max_upload_size`, `connect_timeout`, and `read_timeout`
* make sure the target surface has room

</details>

<details>

<summary>Item Skin Does Not Apply</summary>

* make sure the held item is listed in `materials`
* check the custom model data value
* make sure your pack files match the skin entry

</details>

<details>

<summary>Polymer Looks Wrong</summary>

* make sure `pack.mode` is `polymer`
* make sure Polymer mod is installed
* check the chosen layout
* read [Pack Layouts And Assets](broken://pages/8b852341d1d4cf1a8438b04db3e463b4c6fd9c2e)

</details>

<details>

<summary>Backpack Hides While Riding</summary>

That may be intended

Check `features.hideBackpackWhileRiding` in `config.json`

Default is `true`

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dawnshade.gitbook.io/dawnshade-docs/docs/dawn-cosmetics/summary/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.