> 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/index.md).

# MotionNPC

MotionNPC creates animated player-style NPCs with display entities and compatible Blockbench `.bbmodel` files. NPCs can use player skins or PNG skin URLs, play animations, look at nearby players, run click actions, show holograms, hold items, and be managed in groups.

MotionNPC supports Paper and Folia on Minecraft 1.21+ with Java 21.

### Start here

* [Installation](/getting-started/installation.md)
* [Creating Your First NPC](/getting-started/creating-your-first-npc.md)
* [NPC Configuration](/configuration/npc-configuration.md)
* [Commands & Permissions](/reference/commands-and-permissions.md)

### Main features

* Blockbench player-limb animations with smooth interpolation.
* Player name, UUID, or direct PNG URL skins through MineSkin.
* NPC look behavior, proximity triggers, click actions, sounds, and holograms.
* Main-hand and off-hand items with Custom Model Data support.
* NPC groups for batch movement, visibility, animations, and skins.
* Per-NPC view distance and optional behind-camera animation culling.

### Links

* [Discord Support](https://discord.gg/WHBWBWWYDq)
* BuiltByBit


---

# 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/index.md?ask=<question>&goal=<endgoal>
```

`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.