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

# Creating an NPC

> The five-minute walkthrough: create, name, restyle, place twice and select.

In five minutes you'll have a named, modeled NPC standing in your world, and a copy of it somewhere else. You need the `nmentities.npc` permission (OP has it).

## 1. Create it

Look at the block where your NPC should stand and run:

```text theme={null}
/npc create shopkeeper
```

A villager appears on that block (or 5 blocks ahead of you), facing you, named `&fshopkeeper`. It's also **auto-selected**, so the next commands target it without any extra steps.

> NPC names must be file-safe: letters, numbers, `_` and `-`. The name is the NPC's id everywhere.

## 2. Give it a proper name

```text theme={null}
/npc display "&6Bob the Shopkeeper"
```

Quote multi-word names. `&` color codes work as usual.

## 3. Change what it is

An NPC can be any entity, or any of your loaded [models](models):

```text theme={null}
/npc type allay
/npc type my_model_name
```

Passing an **entity type** changes the base and clears any model. Passing a **model name** applies the model and keeps the base. The autocomplete lists exactly what your server has: every entity type in the runtime registry (modded ones included) plus every loaded model.

\[Image here: The same NPC before and after applying a custom model with /npc type]

## 4. Make it attentive

```text theme={null}
/npc look
```

Now it turns to face the nearest player within 8 blocks. Run it again to toggle back to a fixed gaze.

## 5. Place it somewhere else too

The same NPC can stand in many places. Walk to the second spot, look at the ground, and:

```text theme={null}
/npc spawn shopkeeper
```

That's a second **instance** of the same definition. Rename or restyle the definition and both update; each instance keeps its own position.

Fine-tune a position by standing exactly where you want it and pulling your selected instance to you:

```text theme={null}
/npc tphere
```

## 6. Selecting a different NPC later

Commands target your **selected** instance. To switch selection:

```text theme={null}
/npc select
```

Then right-click the NPC you mean within 15 seconds. It blinks its glow twice to confirm. Clicking works on the model itself, not just the base entity's hitbox.

\[Image here: An NPC glowing briefly after being selected with /npc select]

## What you've learned

* `create` makes a definition plus its first instance, `spawn` adds more instances.
* Definition commands (`display`, `type`, `look`, `rename`) change every instance at once.
* Selection (auto on create/spawn, or `/npc select` + right-click) decides which instance the instance-level commands touch.

The full command list, including removal, listing and console usage, is in [NPC Commands](npc-commands). What these commands write to disk is in [NPC Files](npc-files).