> For the complete documentation index, see [llms.txt](https://motionnpc.nemesismc.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://motionnpc.nemesismc.net/help/faq.md). # FAQ & Troubleshooting Common MotionNPC setup, model, skin, visibility, and performance questions. ### MineSkin says it is required Add a valid key under `mineskin.api-key` in `plugins/MotionNPC/config.yml`, then restart the server or run `/mnpc reload`. Create keys at [account.mineskin.org/keys](https://account.mineskin.org/keys/). ### My NPC skin is still loading Skin downloads and MineSkin profile generation run asynchronously. Wait for the console result before recreating the NPC. Generated profiles are cached under `plugins/MotionNPC/cache/mineskin-limbs/`. ### My model or animation is missing Place the `.bbmodel` in `plugins/MotionNPC/models/`, then run `/mnpc reload`. Use `/mnpc model list` to check loaded models and `/mnpc animation list` to check animation names. Animation names are case-sensitive in practice, so use the exact name shown by the command. ### The NPC is invisible Check these values in its YAML file: * `render.hidden` must be `false`. * `render.view-distance` must be large enough. * `visible-permission` must be empty or granted to the player. * The NPC world and chunk must be loaded. Run `/mnpc info ` to confirm its saved location. ### The NPC does not look at players Enable look behavior: ``` /mnpc look true 5 ``` Spectators are ignored. Players behind walls are also ignored when line-of-sight checking prevents a valid target. ### PlaceholderAPI does not replace a placeholder Install PlaceholderAPI, restart or reload MotionNPC, and confirm the placeholder works in other plugins. MotionNPC supports PlaceholderAPI in holograms and action values. ### Does MotionNPC support Folia? Yes. MotionNPC supports Folia and uses the appropriate scheduler for NPC entities. Use the same commands and NPC YAML files as Paper. ### Can I clear the skin cache? Yes. If you delete cached skin files, MotionNPC regenerates required profiles when NPC skins are loaded again. Keep your MineSkin API key configured. ### Where can I get support? Join the [MotionNPC Discord](https://discord.gg/WHBWBWWYDq) and include your server version, MotionNPC version, relevant console log, and the affected NPC YAML file. --- # 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://motionnpc.nemesismc.net/help/faq.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.