NPC Commands

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>`, the steve player model.
`/npc spawn <npc> [placed_id]`	Places another instance of an existing NPC where you’re looking, auto-selected. `[placed_id]` names the new copy; without it you get the next free `<npc>-<n>`. Fails if the id is already taken.
`/npc editor`	Toggles editor mode: your inventory is stashed and swapped for NPC tools — right-click a block to name and create an NPC there in an anvil prompt, right-click an NPC to select it, and the move tool picks the selected copy up so it follows where you look. Turning it off (or quitting) hands your inventory straight back.

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.
`/npc deselect`	Clears your selection.
`/npc id`	Reports your selected NPC and instance number.

Editing the definition

These apply to every instance of the NPC, unless you have a single placed copy selected: then rename, skin and nametag set an override on that copy alone, while the rest still change the whole definition.

Command	What it does
`/npc type <type> [npc]`	Turns the NPC into any entity type (sets base, clears model), any player model (e.g. `steve`), or any regular model (keeps base). Suggestions come from the server’s runtime entity registry plus loaded models and player models, so modded servers always show exactly what’s available.
`/npc skin <player> [npc]`	Sets the skin of a player-model NPC by player name. Fails if the NPC isn’t a player model.
`/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 and file follow. The visible name above the head follows too, as long as it’s still the auto-generated `&f<id>` or was never set; a name you typed with `/npc display` is left alone (the command tells you so).
`/npc nametag [true\|false] [npc]`	Shows or hides the name above the NPC’s head. No argument toggles it. The display name is kept while hidden (dialogs still show who’s talking), and turning it back on restores it. Saved as `nametag: false` in the yaml.
`/npc addeffect <effect> [npc]`	Runs a named `Effects/` effect when the NPC is right-clicked. The NPC is the caster, the clicker is `@target`.
`/npc removeeffect <effect> [npc]`	Stops a right-click effect.
`/npc dialog <dialog\|none> [npc]`	Assigns a dialog to the NPC, so right-clicking starts a conversation. `none` clears it. Tab-completes loaded dialog ids.
`/npc look [npc]`	Toggles look-at-nearest-player. Turning it off freezes the current facing (no snap back to the stored direction).
`/npc glowing [npc]`	Toggles the glow outline.
`/npc gravity [npc]`	Toggles gravity; off floats the NPC in place.

Movement and behaviour

follow applies to the whole definition. positioning and behaviour are per placed copy — they describe how one NPC standing in one spot acts, so they take a placed id or your selected copy. Passing a draft id is rejected with a pointer to /npc select.

Command	What it does
`/npc follow [true\|false] [npc]`	Whether the NPC walks toward the nearest player. No argument toggles it.
`/npc positioning <static\|dynamic> [npc]`	`static` (the default) is immovable — walking into it cannot shift it off its spot. `dynamic` behaves like a normal entity: players, mobs and model hitboxes shove it around. Being pushed never rewrites the config, so the copy returns to its stored home whenever it respawns.
`/npc behaviour <mode> [radius] [npc]`	What the copy does on its own. `[radius]` is `1`–`64` and only applies to the modes that use one.

The behaviour modes:

Mode	What it does	Radius
`none`	The default: stands where it was placed and does nothing on its own.	—
`wandering`	Strolls to random reachable spots within its radius of home, pausing between walks.	yes, default `8`
`chaser`	Wanders, but chases any player who comes within its radius of home. The radius doubles as the leash: once the player leaves it the NPC walks home and resumes wandering, so it can’t be kited away.	yes, default `8`
`playerlike`	Acts like an idle player: wanders a small area, hops now and then, swaps what it’s holding, crouches a few times when someone comes close, and picks up nearby dropped items only to hand them back to the nearest player.	fixed at `5`

Every moving mode is driven by the same hidden pathfinding mob that backs follow, so they all get Minecraft’s real ground navigation: gravity, step-up, jumps and obstacle avoidance. See Performance for the tuning knobs if you run a lot of them.

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, active flags (look, glowing, no-gravity, no-nametag) and all instance locations.

Console usage

create, spawn, editor, select, deselect, id, tp and tphere are player-only. remove <id>, rename, type, skin, display, look, follow, positioning, behaviour, glowing, gravity, nametag, addeffect, removeeffect, dialog 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.

Getting Started

Mobs

Spawning

Commands

Effects

Models

Compatibility

NPCs

Configuration

API

Creating and placing

Selecting

Editing the definition

Movement and behaviour

Moving and removing

Inspecting

Console usage

Naming rules

​Creating and placing

​Selecting

​Editing the definition

​Movement and behaviour

​Moving and removing

​Inspecting

​Console usage

​Naming rules

Creating and placing

Selecting

Editing the definition

Movement and behaviour

Moving and removing

Inspecting

Console usage

Naming rules