> 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/getting-started/creating-your-first-npc.md). # Creating Your First NPC Create, skin, rotate, and animate your first MotionNPC. MotionNPC includes a default player model, so you can create your first NPC immediately after installation. ### 1. Create the NPC Stand where the NPC should appear and run: ``` /mnpc create guide Notch ``` The first argument is the NPC id. The second argument is the skin source. It can be a player name, a UUID, or a direct PNG skin URL. ``` /mnpc create guide https://example.com/skin.png ``` MotionNPC downloads or generates the required skin profiles in the background. The NPC file is saved as: ``` plugins/MotionNPC/NPC/guide.yml ``` ### 2. Set the resting direction Look in the direction where the NPC should face, then run: ``` /mnpc rotate guide ``` `rotate` stores both your current yaw and pitch as the NPC's resting rotation. ### 3. Check available animations ``` /mnpc animation list ``` Play an animation once: ``` /mnpc animation guide play wave once ``` Or loop it: ``` /mnpc animation guide play idle loop ``` Use `/mnpc animation guide stop` to stop the current manual animation. ### 4. Change the skin later ``` /mnpc skin guide Dream ``` ### 5. Reload after manual file changes If you edit an NPC YAML file or add a `.bbmodel`, run: ``` /mnpc reload ``` This reloads the plugin configuration, models, groups, and NPC files. Do not use it while actively editing the same 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/getting-started/creating-your-first-npc.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.