PLUGIN Commands

Jump to bottom

Eisi05 edited this page Jun 8, 2026 · 5 revisions

Commands

Core

/npc create
/npc copy <uuid>
/npc edit (toggle edit-mode)
/npc list (opens NPC list GUI)
/npc tp <uuid> [location] [rotation]
/npc tphere <uuid>
/npc reload
/npc version
/npc update (checks for a new plugin version)
/npc cancel <uuid> (cancels NPC click action)
/npc cancel all (cancels all NPC click actions)
/npc load <id> (loads NPC from storage)
/npc load <id> <location> (loads NPC at specific location)
/npc load <id> <location> <rotation> (loads NPC at specific location with rotation)
/npc execute <id> (executes NPC click action on self)
/npc execute <id> <target> (executes NPC click action on target)
/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)

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

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.