PLUGIN Commands

Commands

Core

• /npc create [tags...]
• /npc copy <npc>
• /npc edit (toggle edit-mode)
• /npc edit <npc> (edit specific NPC)
• /npc edit <npc> <key> <value> (edit specific NPC option)
• /npc delete <npc> [force] (delete specific NPC)
• /npc list (opens NPC list GUI)
• /npc tp <npc> [location] [rotation]
• /npc tphere <npc>
• /npc reload [npc]
• /npc version
• /npc update (checks for a new plugin version)
• /npc cancel <npc> (cancels NPC click action)
• /npc cancel all (cancels all NPC click actions)
• /npc load <npc> (loads NPC from storage)
• /npc load <npc> <location> (loads NPC at specific location)
• /npc load <npc> <location> <rotation> (loads NPC at specific location with rotation)
• /npc click <npc> (executes NPC click action on self)
• /npc click <npc> <target> (executes NPC click action on target)
• /npc move <npc> turn <degree> (rotates NPC by relative degrees)
• /npc move <npc> <flag> [steps] [speed] (moves NPC using direction flags)
• /npc help (shows help message)
• /npc issue (shows issue tracker link)
• /npc wiki (shows wiki link)
• /npc message <player> <message> (Can be used in command actions to send a message which also allows '&' color codes)
• /npc tag <npc> add <tag> (adds a tag to an NPC)
• /npc tag <npc> remove <tag> (removes a tag from an NPC)
• /npc tag <npc> list (lists all tags of an NPC)

Config

• /npc config reload
• /npc config debug [true|false]
• /npc config avoid-command-check [true|false]
• /npc config look-at-update-interval [ticks]
• /npc config input-time [seconds]
• /npc config auto-update [true|false]
• /npc config placeholder-timer [ticks]
• /npc config check-valid-path [true|false]
• /npc config walking-viewer-distance [distance]
• /npc config precise-sleeping-hitbox [true|false]
• /npc config load-chunks-on-path [true|false]
• /npc config name-display
• /npc config list

Exceptions (startup load failures)

• /npc exceptions [page]
• /npc exceptions show <name>
• /npc exceptions delete <name>

Paths

All path commands are under:

• /npc path ...

Main subcommands:

• point add [index] [location] [rotation]
• point remove [index|location]
• point list [page]
• point clear
• create [name] [maxIterations] [allowDiagonalMovement]
• delete <name>
• list [page]
• visualize [name]
• visualize points
• record start|stop
• test <name> [speed]
• edit <name>

Movement

All movement commands are under:

• /npc movement ...

Main subcommands:

• record start [player] (starts recording movement)
• record stop [player] <name> [overwrite] (stops recording and saves)
• record stop <name> [overwrite] (stops recording and saves for self)
• record (gives recording item)
• list [page] (lists all movement recordings with pagination)
• details <name> (shows detailed information about a recording)
• delete <name> (deletes a movement recording)
• play <name> [speed] (plays a recording on self)
• play <name> <target> [speed] (plays a recording on target)

Execute Context (Paper only)

Execution modifiers allowing dynamic target selection and context redirection for NPC subcommands:

• /npc execute as <selector> run <command> (executes targeted NPC command as the selected NPC context)
• /npc execute at <selector> run <command> (executes targeting location and orientation of selected NPC)
• /npc execute positioned as <selector> run <command> (executes at the position of selected NPC)
• /npc execute rotated as <selector> run <command> (executes with the rotation angles of selected NPC)

---

NPC Selector System (Paper only)

The target selector system (NpcSelector) parses entity target syntax matching standard Minecraft target selectors to query registered NPCs:

• Target Specifiers:
  • @a – Matches all loaded/registered NPCs.
  • @s – Matches the self-referential NPC currently targeted inside an active /npc execute context.
  • @n / @p – Targets the single nearest NPC relative to the command source origin.
  • @r – Selects a random NPC candidate.
  • <name|uuid> – Directly queries an NPC by display name or unique ID.
• Filter Arguments ([...]):
  • tag=<value> / tag=!<value> – Filters NPCs possessing (or missing) specific assigned tags.
  • nbt={<key>:<value>} – Evaluates target options against specific internal NpcOption states or custom stored data.
  • distance=<min>..<max> – Constrains candidates based on Euclidean distance boundaries from the execution origin.
  • limit=<count> – Restricts maximum return results.

Wait trigger

Used with the Wait click action (command mode):

• /npc wait <player> <name> [values...]

Variables

Manage server-wide global variables via commands:

• /npc variable list - List all global variables
• /npc variable get <name> - Get a variable's value
• /npc variable set <name> <expression> - Set a variable (supports expressions)
• /npc variable delete <name> - Delete a variable

Variables can also be managed via the SetVariable click action and used in expressions throughout the plugin.