> For the complete documentation index, see [llms.txt](https://docs.samscreations.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.samscreations.eu/samshead/guides/frequently-asked-questions.md).

# Frequently Asked Questions

## Frequently Asked Questions <a href="#frequently-asked-questions" id="frequently-asked-questions"></a>

Find answers to common questions..

***

<details>

<summary>Does this work with cracked/offline servers?</summary>

Yes! If you have **SkinsRestorer** installed, SamsHead will automatically detect it. It supports both premium and cracked skins, ensuring everyone has an avatar.

</details>

<details>

<summary>Why do I see weird squares or characters?</summary>

This means the resource pack isn't loaded. Players must accept the server resource pack. If you use ItemsAdder or Nexo, ensure you have reloaded their respective packs after installing SamsHead.

</details>

<details>

<summary>How do I force a skin refresh?</summary>

You can use `/sh clearcache` to wipe the database and memory, or simply wait for the `cache.duration` to expire. If using SkinsRestorer, the plugin refreshes automatically when a skin is changed.

</details>

<details>

<summary>Can I use this in my own plugin?</summary>

Absolutely. Check the [Developer API](https://kdr-202605-obdbla19.kodari.wiki/api-reference) section for instructions on hooking into our rendering engine.

</details>

<details>

<summary>What happens if Mojang's API is down?</summary>

SamsHead will use the persistent SQLite cache for any player who has joined before. For new players, it will fall back to a procedurally generated Steve or Alex face based on their name.

</details>

<details>

<summary>The bust placeholders are cutting off?</summary>

Minecraft has length limits for certain text fields (like scoreboards). Player busts are extremely long strings of colored characters. Only use busts in Chat, Holograms, or GUI Lore where long strings are supported.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://docs.samscreations.eu/samshead/guides/frequently-asked-questions.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.