> For the complete documentation index, see [llms.txt](https://docs.cheddah-development.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cheddah-development.net/plugin-documentaion/skin-statues/troubleshooting.md). # Troubleshooting ### Getting support If this page does not solve the problem, open an issue on the [SkinStatues issue tracker](https://github.com/Cheddah01/Skin-Statues/issues). Include: * Your SkinStatues version * Paper or Fabric edition * Minecraft and Java versions * Fabric Loader and Fabric API versions, if applicable * The command you ran and the scale used * The target Minecraft username * Relevant configuration and server log messages * A screenshot for appearance or placement problems Do not include passwords, private keys, tokens, or other sensitive information. ### The server will not load SkinStatues Check the basics for your edition: #### Paper * The server is running Paper `26.2` on Java `25`. * `SkinStatues.jar` is in the `plugins` folder, not the `mods` folder. * You did not install the Fabric build on Paper. #### Fabric * The SkinStatues JAR exactly matches the server's Minecraft version. * Fabric API for that same Minecraft version is installed. * Fabric Loader is `0.19.3` or a compatible newer 0.19.x release. * The server is running Java `25`. * Both JARs are in the `mods` folder. ### I cannot use `/statue` * The command must be run by an in-game player, not the console. * On Paper, grant `skinstatues.use`; operators receive it by default. * On Fabric, the player needs vanilla game-master permission level 2. * Use `/statue ` or `/statue undo`. * The scale must be a whole number from `1` through the configured maximum. ### A skin cannot be found The name must be a valid Minecraft username containing 1–16 letters, numbers, or underscores. The target does not need to be online. The server also needs outbound access to Minecraft profile and skin services. If the service is temporarily unavailable, wait at least one minute before retrying; failed lookups are briefly cached. ### The statue has the wrong skin Successful skins are cached for 60 minutes by default. If the player recently changed their skin, either wait for the cache to expire, temporarily set the cache lifetime to `0` and restart, or restart SkinStatues to clear its in-memory cache. ### The top of the statue is missing The statue reached the world's maximum build height. Blocks outside the buildable range are omitted. Move to a lower elevation or use a smaller scale. ### The statue colors are approximate SkinStatues maps skin colors to a limited palette of Minecraft blocks, so exact RGB reproduction is not possible. You can adjust eligible blocks and matching colors on the Palette customization page. ### Large statues cause lag Reduce the scale or lower `blocks-per-tick` on Paper or `blocksPerTick` on Fabric. Lower values spread construction and undo over more ticks. Very large scale limits also increase planning memory, total block changes, build time, and the size of the in-memory undo record. ### Undo says there is no statue Each player can undo only their latest completed statue. Undo history is cleared when the server stops, restarts, or SkinStatues is disabled or reloaded. A build that never completed does not become an undo target. ### Undo left some statue blocks behind SkinStatues skips positions changed after the statue was built. This protects newer builds and manual edits from being overwritten by stale undo data. Remove remaining blocks manually or restore the area from a world backup. ### Fabric configuration changes are ignored Check `config/skinstatues.json` for valid JSON syntax, including commas, quotation marks, and matching braces. A malformed file is not overwritten; SkinStatues uses built-in defaults for that startup and reports the parse problem in the server log. After fixing the file, fully restart the server. ### The Fabric client menu does not open * Confirm the matching SkinStatues Fabric JAR and Fabric API are installed on the client. * Check **Controls > Key Binds > SkinStatues** in case `[` was rebound or conflicts with another key. * The menu is optional; the normal `/statue` commands remain available when the server permits them. --- # 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, and the optional `goal` query parameter: ``` GET https://docs.cheddah-development.net/plugin-documentaion/skin-statues/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.