Skip to main content
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:
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

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:
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

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:
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:

​
6. Selecting a different NPC later

Commands target your selected instance. To switch selection:
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. What these commands write to disk is in NPC Files.