> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nmentities.net/llms.txt
> Use this file to discover all available pages before exploring further.

# NPC Commands

> The full /npc reference: creating, selecting, editing, moving, removing.

The full `/npc` reference. Every command also works as `/nme npc ...`, both roots share the single permission `nmentities.npc` (included in `nmentities.*`).

Commands act on either the **definition** (every instance of the NPC at once) or your **selected instance**. Selection happens automatically on `create` and `spawn`, or manually with `select`. Pass an explicit `[npc]` id on any command to override the selection.

## Creating and placing

| Command              | What it does                                                                                                                                                    |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/npc create <name>` | New NPC plus its first instance on the block you're looking at (or 5 blocks ahead), facing you, auto-selected. Defaults: `base: villager`, `display: &f<name>`. |
| `/npc spawn <npc>`   | Places **another instance** of an existing NPC where you're looking, auto-selected.                                                                             |

## Selecting

| Command       | What it does                                                                                                                                                                      |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/npc select` | Arms click-selection: right-click an NPC within 15 seconds to select it. It blinks its glow twice to confirm. Clicking works on the model too, not just the base entity's hitbox. |

## Editing the definition

These apply to **every instance** of the NPC:

| Command                        | What it does                                                                                                                                                                                                                                  |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/npc type <type> [npc]`       | Turns the NPC into any **entity type** (sets base, clears model) or any **loaded model** (keeps base). Suggestions come from the server's runtime entity registry plus loaded models, so modded servers always show exactly what's available. |
| `/npc display <text> [npc]`    | Sets the floating name. Quote multi-word names: `/npc display "&6Bob the Guard"`.                                                                                                                                                             |
| `/npc rename <new_name> [npc]` | Renames the NPC id. The config key, file and auto display name follow.                                                                                                                                                                        |
| `/npc look [npc]`              | Toggles look-at-nearest-player.                                                                                                                                                                                                               |

## Moving and removing

| Command             | What it does                                                                                                                                    |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `/npc tp [npc]`     | Teleports **you** to your selected instance (or the id's first instance).                                                                       |
| `/npc tphere`       | Teleports your selected **instance** to you and saves its new home.                                                                             |
| `/npc remove [npc]` | Without an id: removes your **selected instance**, the definition stays. With an id: removes the **whole NPC**, every instance plus its config. |

## Inspecting

| Command     | What it does                                                          |
| ----------- | --------------------------------------------------------------------- |
| `/npc list` | Every NPC with its base, model, look flag and all instance locations. |

## Console usage

`create`, `spawn`, `select`, `tp` and `tphere` are player-only. `remove <id>`, `rename`, `type`, `display`, `look` and `list` also work from console, always with an explicit id, since console has no selection.

## Naming rules

NPC names must be file-safe: letters, numbers, `_` and `-`. Duplicate names are rejected.