> 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/reference/commands-and-permissions.md).

# Commands & Permissions

Manage MotionNPC NPCs, animations, groups, and temporary off-hand tuning.

The main command is `/mnpc`. `/motionnpc` is available as an alias.

`motionnpc.admin` grants every MotionNPC command permission. Individual permissions default to OP.

### NPC management

| Command                     | Description                                              | Permission                                |
| --------------------------- | -------------------------------------------------------- | ----------------------------------------- |
| `/mnpc create <id> <skin>`  | Creates an NPC at your location using the default model. | `motionnpc.command.create`                |
| `/mnpc remove <id>`         | Removes an NPC and its YAML file.                        | `motionnpc.command.remove`                |
| `/mnpc rename <id> <newId>` | Renames an NPC and its YAML file.                        | `motionnpc.command.rename`                |
| `/mnpc list`                | Lists loaded NPCs.                                       | `motionnpc.command.list`                  |
| `/mnpc info <id>`           | Shows NPC details.                                       | `motionnpc.command.info`                  |
| `/mnpc tp <id>`             | Teleports you to an NPC.                                 | `motionnpc.command.tp`                    |
| `/mnpc movehere <id>`       | Moves an NPC to your location.                           | `motionnpc.command.move`                  |
| `/mnpc rotate <id>`         | Uses your current yaw and pitch as the resting rotation. | `motionnpc.command.rotate`                |
| `/mnpc skin <id> <skin>`    | Changes the skin source.                                 | `motionnpc.command.skin`                  |
| \`/mnpc look \<true         | false> \[distance]\`                                     | Enables or disables player look behavior. |
| `/mnpc near [radius]`       | Lists NPCs near you.                                     | `motionnpc.command.near`                  |

### Models and animations

| Command                       | Description                         | Permission                                 |
| ----------------------------- | ----------------------------------- | ------------------------------------------ |
| `/mnpc model list`            | Lists loaded `.bbmodel` files.      | `motionnpc.command.model`                  |
| `/mnpc animation list`        | Lists loaded animation names.       | `motionnpc.command.animation`              |
| \`/mnpc animation play \[once | loop]\`                             | Plays an animation. `loop` is the default. |
| `/mnpc animation <id> stop`   | Stops the current manual animation. | `motionnpc.command.animation`              |

### Groups

| Command                            | Description                                               |
| ---------------------------------- | --------------------------------------------------------- |
| `/mnpc group create <id>`          | Creates an empty group.                                   |
| `/mnpc group delete <id>`          | Deletes a group.                                          |
| `/mnpc group list [id]`            | Lists groups or a group's NPCs.                           |
| `/mnpc group add <group> <npc>`    | Adds an NPC to a group.                                   |
| `/mnpc group remove <group> <npc>` | Removes an NPC from a group.                              |
| `/mnpc group movehere <group>`     | Moves all members while keeping their relative positions. |
| \`/mnpc group hide \<true          | false>\`                                                  |
| \`/mnpc group animation \[once     | loop]\`                                                   |
| `/mnpc group skin <group> <skin>`  | Changes skins sequentially for the group.                 |

Groups use `motionnpc.command.group`.

### Reload

```
/mnpc reload
```

Reloads `config.yml`, models, groups, and NPC files. Permission: `motionnpc.command.reload`.


---

# 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/reference/commands-and-permissions.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.