Commands: Difference between revisions

From Citizens Wiki

← Older edit
 
(27 intermediate revisions by the same user not shown)
Line 18: Line 18:
<br>To see information on a specific command, you can use <code>/npc help create</code> in-game. Change the "create" to any other command name (the example will show help for the <code>/npc create</code> command).
<br>To see information on a specific command, you can use <code>/npc help create</code> in-game. Change the "create" to any other command name (the example will show help for the <code>/npc create</code> command).
<br>
<br>
<br>Some commands have documentation elsewhere. Such as:
<br>Some commands have documentation elsewhere:
* npc skin has documentation here: [[Skins]]
* /npc skin - [[Skins]]
<br>
<br>
<br>There are also many commands that are added by other traits. see [[Characters]]
<br>There are also many commands that are added by other traits. see [[Characters]]
Line 65: Line 65:
== NPC Commands ==
== NPC Commands ==
General commands used for all NPCs.
General commands used for all NPCs.
'''{{color|red|white|NOTE: '/npc trait' has been replaced, there is a new set of commands for adding, removing and copying traits. }}
:'''<code> /trait {traitname] </code> is now used to add traits and characters.
The following command list is copied from <code>/npc help</code>


{| class="wikitable collapsible" style="text-align: center; width: 100%"
{| class="wikitable collapsible" style="text-align: center; width: 100%"
Line 78: Line 72:
! style="width: 200px;" | Command !! style="width: 400px;" | Arguments !! Description
! style="width: 200px;" | Command !! style="width: 400px;" | Arguments !! Description
{{#!:
{{#!:
| /npc  || <code></code> || None
|-
|-
| /npc activationrange || <code>[range]</code> || Sets the activation range
| /npc  || <code>None</code>  || None
|-
| /npc activationrange || <code>[range]</code> || Sets the activation range
|-
| /npc age || <code>[age] (-l(ock))</code>  || Can only be used on entities that can become babies. Use the '''-l''' flag to lock age over time (note: relogs may be required to see this).
|-
| /npc aggressive || <code>[true&#124;false] (-t(emporary))</code>  || Sets the aggressive status of the entity
|-
| /npc ai || <code>(true&#124;false)</code>  || Sets whether the NPC should use vanilla AI
|-
| /npc allay || <code>(-d(ancing))</code>  || Sets allay modifiers
|-
| /npc anchor || <code>(--save [name]&#124;--assume [name]&#124;--remove [name]) (-a) (-c)</code>  || Manages the NPC&#39;s location anchor(s)
|-
| /npc areaeffectcloud || <code>--color [color] --duration [duration] --radius [radius] --radius_per_tick [radius] --particle [particle]</code>  || None
|-
|-
| /npc age || <code>[age] (-l(ock))</code> || Can only be used on entities that can become babies. Use the [[-l]] flag to lock age over time (note: relogs may be required to see this).
| /npc armadillo || <code>--state [state]</code> || None
|-
|-
| /npc aggressive || <code>[true&amp;#124;false]</code> || Sets the aggressive status of the entity
| /npc armorstand || <code>--visible [visible] --small [small] --marker [marker] --gravity [gravity] --arms [arms] --baseplate [baseplate] --(head&#124;body&#124;leftarm&#124;leftleg&#124;rightarm&#124;rightleg)pose [angle x,y,z]</code> || Edit armorstand properties
|-
|-
| /npc ai || <code>(true&amp;#124;false)</code> || Sets whether the NPC should use vanilla AI
| /npc attribute || <code>[attribute] [value]</code> || Set various NPC attributes
|-
|-
| /npc allay || <code>(-d(ancing))</code> || Sets allay modifiers
| /npc axolotl || <code>(-d) (--variant variant)</code> || Sets axolotl modifiers
|-
|-
| /npc anchor || <code>(--save [name]&amp;#124;--assume [name]&amp;#124;--remove [name]) (-a) (-c)</code> || Manages the NPC&#39;s location anchor(s)
| /npc bat || <code>--awake [awake]</code> || Set bat modifiers
|-
|-
| /npc armadillo || <code>--state [state]</code> || None
| /npc bee || <code>(-s/-n) --anger anger</code> || Sets bee modifiers
|-
|-
| /npc armorstand || <code>--visible [visible] --small [small] --marker [marker] --gravity [gravity] --arms [arms] --baseplate [baseplate] --(head&amp;#124;body&amp;#124;leftarm&amp;#124;leftleg&amp;#124;rightarm&amp;#124;rightleg)pose [angle x,y,z]</code> || Edit armorstand properties
| /npc behavior || <code>[file.yml]</code> || Manages behavior trees
|-
|-
| /npc attribute || <code>[attribute] [value]</code> || Set various NPC attributes
| /npc boat || <code>--type [type]</code> || Sets boat modifiers
|-
|-
| /npc axolotl || <code>(-d) (--variant variant)</code> || Sets axolotl modifiers
| /npc bossbar || <code>--style [style] --color [color] --title [title] --visible [visible] --viewpermission [permission] --flags [flags] --track [health &#124; placeholder] --range [range]</code> || Edit bossbar properties
|-
|-
| /npc bee || <code>(-s/-n) --anger anger</code> || Sets bee modifiers
| /npc breakblock || <code>--location [x,y,z] --radius [radius]</code> || None
|-
|-
| /npc boat || <code>--type [type]</code> || Sets boat modifiers
| /npc camel || <code>(--pose pose)</code> || Sets camel modifiers
|-
|-
| /npc bossbar || <code>--style [style] --color [color] --title [title] --visible [visible] --viewpermission [permission] --flags [flags] --track [health &amp;#124; placeholder] --range [range]</code> || Edit bossbar properties
| /npc cat || <code>(-s/-n/-l) --type type --ccolor collar color</code> || Sets cat modifiers
|-
|-
| /npc breakblock || <code>--location [x,y,z] --radius [radius]</code> || None
| /npc chicken || <code>(--variant variant)</code> || Manage chicken modifiers
|-
|-
| /npc camel || <code>(--pose pose)</code> || Sets camel modifiers
| /npc chunkload || <code>(-t(emporary))</code> || Toggle the NPC forcing chunks to stay loaded
|-
|-
| /npc cat || <code>(-s/-n/-l) --type type --ccolor collar color</code> || Sets cat modifiers
| /npc collidable || <code>--fluids [true&#124;false]</code> || Toggles an NPC&#39;s collidability
|-
|-
| /npc chunkload || <code>(-t(emporary))</code> || Toggle the NPC forcing chunks to stay loaded
| /npc command || <code>(add [command] &#124; execute [player UUID] [hand] &#124; remove [id&#124;all] &#124; permissions [permissions] (duration) &#124; sequential &#124; cycle &#124; random &#124; forgetplayer (uuid) &#124; clearerror [type] (name&#124;uuid) &#124; errormsg [type] [msg] &#124; persistsequence [true&#124;false] &#124; cost [cost] (id) &#124; expcost [cost] (id) &#124; itemcost (id)) (-s(hift)) (-l[eft]/-r[ight]) (-p[layer] -o[p]), --cooldown --gcooldown [seconds] --delay [ticks] --permissions [perms] --n [max # of uses] --gn [max # of global uses]</code> ||  
Use the '''-l''' flag to make the command run on left click, '''-r''' on right click (default).
'''execute''' triggers assigned commands as if a player clicked the npc.
Set the per-player cooldown before the command can be used again using '''--cooldown''' (in '''seconds''').
Set the server-wide cooldown in seconds using '''--gcooldown'''.
'''--delay''' will wait the specified amount in '''ticks''' before executing the command.
'''--permissions''' will set the command to require specific permissions (separate multiple with commas).
'''--n''' will only let the player run the command that number of times.
Use '''-o''' to temporarily execute the command as an op and '''-p''' to run the command as the clicking player instead of the server.
Use '''-n''' to run the command as the NPC instead of the clicking player. Must be a player type NPC.
To give the player temporary permissions instead of op, use '''/npc command permissions'''.
Set the cost of each click with '''/npc command cost/expcost/itemcost'''.
Commands can be executed one by one instead of all at once by using '''/npc command sequential''' or '''/npc command cycle'''.
|-
|-
| /npc collidable || <code>collidable</code> || Toggles an NPC&#39;s collidability
| /npc configgui || <code>None</code> || Display NPC configuration GUI
|-
|-
| /npc command || <code>(add [command] &amp;#124; remove [id&amp;#124;all] &amp;#124; permissions [permissions] &amp;#124; sequential &amp;#124; cycle &amp;#124; random &amp;#124; forgetplayer (uuid) &amp;#124; clearerror [type] (name&amp;#124;uuid) &amp;#124; errormsg [type] [msg] &amp;#124; persistsequence [true&amp;#124;false] &amp;#124; cost [cost] (id) &amp;#124; expcost [cost] (id) &amp;#124; itemcost (id)) (-s(hift)) (-l[eft]/-r[ight]) (-p[layer] -o[p]), --cooldown --gcooldown [seconds] --delay [ticks] --permissions [perms] --n [max # of uses]</code> ||  
| /npc controllable || <code>(-m(ount),-o(wner required)) (--controls [controls]) (--enabled [true&#124;false])</code> || Toggles whether the NPC can be ridden and controlled
Use the [[-l]] flag to make the command run on left click, [[-r]] on right click (default).
Set the per-player cooldown before the command can be used again using [[--cooldown]] (in [[seconds]]).
Set the server-wide cooldown in seconds using [[--gcooldown]].
[[--delay]] will wait the specified amount in [[ticks]] before executing the command.
[[--permissions]] will set the command to require specific permissions (separate multiple with commas).
[[--n]] will only let the player run the command that number of times.
Use [[-o]] to temporarily execute the command as an op and [[-p]] to run the command as the clicking player instead of the server.
To give the player temporary permissions instead of op, use [[/npc command permissions]].
Set the cost of each click with [[/npc command cost/expcost/itemcost]].
Commands can be executed one by one instead of all at once by using [[/npc command sequential]] or [[/npc command cycle]].
|-
|-
| /npc configgui || <code>configgui</code> || Display NPC configuration GUI
| /npc copier || <code>None</code> || Toggle the NPC copier
|-
|-
| /npc controllable || <code>(-m(ount),-y,-n,-o(wner required))</code> || Toggles whether the NPC can be ridden and controlled
| /npc coppergolem || <code>(--weatherstate state) (--weatheringtick tick)</code> || Controls copper golem modifiers
|-
|-
| /npc copier || <code>copier</code> || Toggle the NPC copier
| /npc copy || <code>(--name newname)</code> || Copies an NPC
|-
|-
| /npc copy || <code>(--name newname)</code> || Copies an NPC
| /npc cow || <code>(--variant variant)</code> || Manage cow modifiers
|-
|-
| /npc create || <code>[name] ((-b(aby),u(nspawned),s(ilent),t(emporary),c(enter),p(acket)) --at [x,y,z,world] --type [type] --item (item) --trait [&#39;trait1, trait2...&#39;] --model [model name] --nameplate [true&amp;#124;false&amp;#124;hover] --temporaryticks [ticks] --registry [registry name]</code> || Create a new NPC
| /npc create || <code>[name] ((-b(aby),u(nspawned),s(ilent),t(emporary),c(enter),p(acket)) --at [x,y,z,world] --type [type] --item (item) --trait [&#39;trait1, trait2...&#39;] --model [model name] --nameplate [true&#124;false&#124;hover] --temporaryduration [duration] --registry [registry name]</code> || Create a new NPC
|-
|-
| /npc debug || <code>-p(aths) -n(avigation)</code> || Display debugging information
| /npc debug || <code>-p(aths) -n(avigation) -i(tem in hand)</code> || Display debugging information
|-
|-
| /npc deselect || <code>deselect</code> || Deselect currently selected NPC
| /npc deselect || <code>None</code> || Deselect currently selected NPC
|-
|-
| /npc despawn || <code>(id)</code> || Despawn a NPC
| /npc despawn || <code>(id)</code> || Despawn a NPC
|-
|-
| /npc drops || <code>drops</code> || Edit an NPC&#39;s drops
| /npc disguise || <code>--type [type]</code> || Manages entity disguises
|-
|-
| /npc endercrystal || <code>-b(ottom)</code> || Edit endercrystal modifiers
| /npc display || <code>--billboard [billboard] --brightness [blockLight,skyLight] --interpolationdelay [delay] --interpolationduration [duration] --height [height] --width [width] --scale [x,y,z] --viewrange [range] --leftrotation [x,y,z,w] --rightrotation [x,y,z,w] --offset [x,y,z]</code> || Set various display entity modifiers
|-
|-
| /npc enderdragon || <code>--phase [phase] --destroywalls [true&amp;#124;false]</code> || Sets enderdragon modifiers
| /npc drops || <code>None</code> || Edit an NPC&#39;s drops
|-
|-
| /npc enderman || <code>-a(ngry)</code> || Set enderman modifiers
| /npc endercrystal || <code>-b(ottom)</code> || Edit endercrystal modifiers
|-
|-
| /npc equip || <code>equip</code> || Toggle the equipment editor
| /npc enderdragon || <code>--phase [phase] --destroywalls [true&#124;false]</code> || Sets enderdragon modifiers
|-
|-
| /npc flyable || <code>(true&amp;#124;false)</code> || Toggles or sets an NPC&#39;s flyable status
| /npc enderman || <code>-a(ngry)</code> || Set enderman modifiers
|-
|-
| /npc follow || <code>(player name&amp;#124;NPC id) (-p[rotect]) (--margin [margin]) (--enable [boolean])</code> || Toggles NPC following you
| /npc entitypose || <code>[pose]</code> || Control entity pose
|-
|-
| /npc fox || <code>--type type --sleeping [true&amp;#124;false] --sitting [true&amp;#124;false] --crouching [true&amp;#124;false] --interested [true&amp;#124;false] --pouncing [true&amp;#124;false] --faceplanted [true&amp;#124;false]</code> || Sets fox modifiers
| /npc equip || <code>None</code> || Toggle the equipment editor
|-
|-
| /npc frog || <code>(--variant variant)</code> || Sets frog modifiers
| /npc eval || <code>[expression]</code> || None
|-
|-
| /npc gamemode || <code>[gamemode]</code> || Changes the gamemode
| /npc flyable || <code>(true&#124;false)</code> || Toggles or sets an NPC&#39;s flyable status
|-
|-
| /npc glowing || <code>--color [minecraft chat color]</code> || Toggles an NPC&#39;s glowing status
| /npc follow || <code>(player name&#124;NPC id) (-p[rotect]) (--margin [margin]) (--enable [boolean])</code> || Toggles NPC following you
|-
|-
| /npc goat || <code>-l(eft) -r(ight) -n(either) -b(oth) horn</code> || Sets goat modifiers
| /npc forcefield || <code>--width [width] --height [height] --strength [strength] --vertical-strength [vertical strength]</code> || Creates a forcefield which pushes players close to the NPC away
|-
|-
| /npc gravity || <code>gravity</code> || Toggles gravity
| /npc fox || <code>--type type --sleeping [true&#124;false] --sitting [true&#124;false] --crouching [true&#124;false] --interested [true&#124;false] --pouncing [true&#124;false] --faceplanted [true&#124;false]</code> || Sets fox modifiers
|-
|-
| /npc hitbox || <code>--scale [scale] --width/height [value]</code> || Sets the NPC hitbox
| /npc frog || <code>(--variant variant)</code> || Sets frog modifiers
|-
|-
| /npc hologram || <code>add [text] &amp;#124; set [line #] [text] &amp;#124; remove [line #] &amp;#124; clear &amp;#124; lineheight [height] &amp;#124; viewrange [range] &amp;#124; margintop [line #] [margin] &amp;#124; marginbottom [line #] [margin]</code> || Controls NPC hologram text
| /npc gamemode || <code>[gamemode]</code> || Changes the gamemode
|-
|-
| /npc home || <code>--location [loc] --delay [delay] --distance [distance] -h(ere) -p(athfind) -t(eleport)</code> || Controls home location
| /npc glowing || <code>--color [minecraft chat color]</code> || Toggles an NPC&#39;s glowing status
|-
|-
| /npc horse || <code>(--color color) (--type type) (--style style) (-cb)</code> || Use the -c flag to make the NPC have a chest, or the -b flag to stop them from having a chest.
| /npc goat || <code>-l(eft) -r(ight) -n(either) -b(oth) horn</code> || Sets goat modifiers
|-
|-
| /npc hurt || <code>[damage]</code> || Damages the NPC
| /npc gravity || <code>None</code> || Toggles gravity
|-
|-
| /npc id || <code>id</code> || Sends the selected NPC&#39;s ID to the sender
| /npc hitbox || <code>--scale [scale] --width/height [value] --offset [x,y,z]</code> || Sets the NPC hitbox
|-
|-
| /npc inventory || <code>inventory</code> || Show&#39;s an NPC&#39;s inventory
| /npc hologram || <code>add [text] (--duration [duration]) &#124; insert [line #] [text] &#124; set [line #] [text] &#124; remove [line #] &#124; edit_npc [template &#124; name &#124; line #] &#124; clear &#124; lineheight [height] &#124; viewrange [range] &#124; margintop [line #] [margin] &#124; marginbottom [line #] [margin]</code> || Controls NPC hologram text
|-
|-
| /npc item || <code>(item) (metadata) (-h(and))</code> || Sets the NPC&#39;s item
| /npc home || <code>--location [loc] --delay [delay] --distance [distance] -h(ere) -p(athfind) -t(eleport)</code> || Controls home location
|-
|-
| /npc itemframe || <code>--visible [true&amp;#124;false] --fixed [true&amp;#124;false] --rotation [rotation] --item [item]</code> || Sets itemframe modifiers
| /npc horse || <code>(--color color) (--type type) (--style style) (-cbt)</code> || Use the -c flag to make the NPC have a chest, or the -b flag to stop them from having a chest.
|-
|-
| /npc jump || <code>jump</code> || Makes the NPC jump
| /npc hurt || <code>[damage]</code> || Damages the NPC
|-
|-
| /npc knockback || <code>(--explicit true&amp;#124;false)</code> || Toggle NPC knockback
| /npc id || <code>None</code> || Sends the selected NPC&#39;s ID to the sender
|-
|-
| /npc leashable || <code>leashable</code> || Toggles leashability
| /npc inventory || <code>(player name/uuid)</code> || Show&#39;s an NPC&#39;s inventory
|-
|-
| /npc list || <code>(page) ((-a) --owner (owner) --type (type) --char (char) --registry (name))</code> || List NPCs
| /npc item || <code>[item] (-h(and))</code> || Sets the NPC&#39;s item
|-
|-
| /npc llama || <code>(--color color) (--strength strength)</code> || Sets llama modifiers
| /npc itemdisplay || <code>--transform [transform]</code> || None
|-
|-
| /npc lookclose || <code>--range [range] -r[ealistic looking] --randomlook [true&amp;#124;false] --perplayer [true&amp;#124;false] --randomswitchtargets [true&amp;#124;false] --randompitchrange [min,max] --randomyawrange [min,max] --disablewhennavigating [true&amp;#124;false] --targetnpcs [true&amp;#124;false]</code> || Toggle whether a NPC will look when a player is near
| /npc itemframe || <code>--visible [true&#124;false] --fixed [true&#124;false] --rotation [rotation] --item [item] --face [face]</code> || Sets itemframe modifiers
|-
|-
| /npc metadata || <code>set&amp;#124;get&amp;#124;remove [key] (value) (-t(emporary))</code> || Manages NPC metadata
| /npc jump || <code>None</code> || Makes the NPC jump
|-
|-
| /npc minecart || <code>(--item item_name(:data)) (--offset offset)</code> || Sets minecart item
| /npc knockback || <code>(--explicit true&#124;false)</code> || Toggle NPC knockback
|-
|-
| /npc mirror || <code>--name [true&amp;#124;false]</code> || Controls mirroring of NPC skins and more
| /npc leashable || <code>None</code> || Toggles leashability
|-
|-
| /npc model || <code>[name]</code> || None
| /npc list || <code>(page) ((-a) --owner (owner) --type (type) --char (char) --registry (name))</code> || List NPCs
|-
|-
| /npc modelanimate || <code>[start&amp;#124;stop&amp;#124;clear] (name) (speed)</code> || None
| /npc llama || <code>(--color color) (--strength strength)</code> || Sets llama modifiers
|-
|-
| /npc mount || <code>(--onnpc &lt;npc id&amp;#124;uuid&gt;) (-c(ancel))</code> || Mounts a controllable NPC
| /npc lookclose || <code>--range [range] --filter [filter] -r[ealistic looking] --randomlook [true&#124;false] --perplayer [true&#124;false] --randomswitchtargets [true&#124;false] --randompitchrange [min,max] --randomyawrange [min,max] --disablewhennavigating [true&#124;false] --targetnpcs [true&#124;false]</code> || Toggle whether a NPC will look when a player is near
|-
|-
| /npc moveto || <code>x:y:z:world &amp;#124; x y z world</code> || Teleports a NPC to a given location
| /npc mannequin || <code>--hide_description [true&#124;false] --immovable [true&#124;false] --description [description] --main_hand [LEFT&#124;RIGHT] --skin_patch_type [type] --skin_patch_body [location] --skin_patch_cape [location] --skin_patch_elytra [location]</code> || None
|-
|-
| /npc mushroomcow || <code>(--variant [variant])</code> || Sets mushroom cow modifiers
| /npc metadata || <code>set&#124;get&#124;remove [key] (value) (-t(emporary))</code> || Manages NPC metadata
|-
|-
| /npc name || <code>(-h(over))</code> || Toggle nameplate visibility, or only show names on hover
| /npc minecart || <code>(--offset offset)</code> || Sets minecart item
|-
|-
| /npc ocelot || <code>(--type type) (-s(itting), -n(ot sitting))</code> || Set the ocelot type of an NPC and whether it is sitting
| /npc mirror || <code>--name [true&#124;false] --equipment [true&#124;false]</code> || Controls mirroring of NPC skins and more
|-
|-
| /npc owner || <code>[uuid&amp;#124;SERVER]</code> || Set the owner of an NPC
| /npc model || <code>[name]</code> || None
|-
|-
| /npc packet || <code>--enabled [true&amp;#124;false]</code> || Controls packet NPC settings
| /npc modelanimate || <code>[start&#124;stop&#124;clear] (name) (speed)</code> || None
|-
|-
| /npc painting || <code>(--art art)</code> || Set painting modifiers
| /npc mount || <code>(--onnpc &lt;npc id&#124;uuid&gt;) (-d(ismount)) (-c(ancel))</code> || Mounts a controllable NPC
|-
|-
| /npc panda || <code>--gene (main gene) --hiddengene (hidden gene) -e(ating) -s(itting) -n (sneezing) -r(olling)</code> || Sets panda modifiers
| /npc moveto || <code>x:y:z:world &#124; x y z world</code> || Teleports a NPC to a given location
|-
|-
| /npc panimate || <code>[animation]</code> || Plays a player animation
| /npc mushroomcow || <code>(--variant [variant])</code> || Sets mushroom cow modifiers
|-
|-
| /npc parrot || <code>(--variant variant)</code> || Sets parrot modifiers
| /npc name || <code>(-h(over))</code> || Toggle nameplate visibility, or only show names on hover
|-
|-
| /npc passive || <code>(--set [true&amp;#124;false])</code> || Sets whether an NPC damages other entities or not
| /npc ocelot || <code>(--type type) (-s(itting), -n(ot sitting))</code> || Set the ocelot type of an NPC and whether it is sitting
|-
|-
| /npc path || <code>path</code> || Toggle the waypoint editor
| /npc owner || <code>[uuid&#124;SERVER]</code> || Set the owner of an NPC
|-
|-
| /npc pathopt || <code>--avoid-water&amp;#124;aw [true&amp;#124;false] --open-doors [true&amp;#124;false] --path-range [range] --stationary-ticks [ticks] --attack-range [range] --distance-margin [margin] --path-distance-margin [margin] --use-new-finder [true&amp;#124;false] --falling-distance [distance]</code> || Sets an NPC&#39;s pathfinding options
| /npc packet || <code>--enabled [true&#124;false]</code> || Controls packet NPC settings
|-
|-
| /npc pathto || <code>me &amp;#124; here &amp;#124; cursor &amp;#124; [x] [y] [z] (--margin [distance margin]) (-s[traight line])</code> || Starts pathfinding to a certain location
| /npc painting || <code>(--art art)</code> || Set painting modifiers
|-
|-
| /npc pausepathfinding || <code>--onrightclick [true&amp;#124;false] --when-player-within [range in blocks] --pauseticks [ticks]</code> || Sets pathfinding pause
| /npc panda || <code>--gene (main gene) --hiddengene (hidden gene) -e(ating) -s(itting) -n (sneezing) -r(olling)</code> || Sets panda modifiers
|-
|-
| /npc phantom || <code>(--size size)</code> || Sets phantom modifiers
| /npc panimate || <code>[animation]</code> || Plays a player animation
|-
|-
| /npc pickupitems || <code>(--set [true&amp;#124;false])</code> || Allow NPC to pick up items
| /npc parrot || <code>(--variant variant)</code> || Sets parrot modifiers
|-
|-
| /npc piglin || <code>(--dancing [true&amp;#124;false])</code> || Sets piglin modifiers
| /npc passive || <code>(--set [true&#124;false])</code> || Sets whether an NPC damages other entities or not
|-
|-
| /npc playerfilter || <code>-a(llowlist) -e(mpty) -d(enylist) --add [uuid] --remove [uuid] --addgroup [group] --removegroup [group] -c(lear) --applywithin [blocks range]</code> || Manages the NPC&#39;s player filter
| /npc path || <code>None</code> || Toggle the waypoint editor
|-
|-
| /npc playerlist || <code>(-a(dd),r(emove))</code> || Sets whether the NPC is put in the playerlist
| /npc pathopt || <code>--avoid-teleporting [true&#124;false] --avoid-water [true&#124;false] --attack-delay-duration [duration] --destination-teleport-margin [margin] --open-doors [true&#124;false] --path-range [range] --stationary-ticks [ticks] --attack-range [range] --distance-margin [margin] --path-distance-margin [margin] --pathfinder-type [CITIZENS&#124;MINECRAFT] --falling-distance [distance]</code> || Sets an NPC&#39;s pathfinding options
|-
|-
| /npc playsound || <code>[sound] (volume) (pitch) (--at x:y:z:world)</code> || Plays a sound at the NPC&#39;s location
| /npc pathto || <code>me &#124; here &#124; cursor &#124; [x] [y] [z] (--margin [distance margin]) (-s[traight line])</code> || Starts pathfinding to a certain location
|-
|-
| /npc polarbear || <code>(-r)</code> || Sets polarbear modifiers
| /npc pausepathfinding || <code>--onrightclick [true&#124;false] --when-player-within [range in blocks] --pauseduration [duration] --lockoutduration [duration]</code> || Sets pathfinding pause
|-
|-
| /npc pose || <code>(--save [name] (-d) &amp;#124; --mirror [name] (-d) &amp;#124; --assume [name] &amp;#124; --remove [name] &amp;#124; --default [name]) (--yaw yaw) (--pitch pitch) (-a)</code> || Manage NPC poses
| /npc phantom || <code>(--size size)</code> || Sets phantom modifiers
|-
|-
| /npc powered || <code>(--set true&amp;#124;false)</code> || Toggle a creeper NPC as powered
| /npc pickupitems || <code>(--set [true&#124;false])</code> || Allow NPC to pick up items
|-
|-
| /npc profession || <code>[profession]</code> || Set a NPC&#39;s profession
| /npc pig || <code>(--variant variant)</code> || Manage pig modifiers
|-
|-
| /npc pufferfish || <code>(--state state)</code> || Sets pufferfish modifiers
| /npc piglin || <code>(--dancing [true&#124;false])</code> || Sets piglin modifiers
|-
|-
| /npc rabbittype || <code>[type]</code> || Set the NPC&#39;s rabbit type
| /npc playerfilter || <code>-a(llowlist) -e(mpty) -d(enylist) --add [uuid] --remove [uuid] --addpermission [permission] --removepermission [permission] --addgroup [group] --removegroup [group] -c(lear) --applywithin [blocks range]</code> || Manages the NPC&#39;s player filter
|-
|-
| /npc remove || <code>(all&amp;#124;id&amp;#124;name&amp;#124; --owner [owner] &amp;#124; --eid [entity uuid] &amp;#124; --world [world])</code> || Remove a NPC
| /npc playerlist || <code>(-a(dd),r(emove))</code> || Sets whether the NPC is put in the playerlist
|-
|-
| /npc rename || <code>[name]</code> || Rename a NPC
| /npc playsound || <code>[sound] (category) (volume) (pitch) (--to [player]) (--at x:y:z:world)</code> || Plays a sound at the NPC&#39;s location
|-
|-
| /npc respawn || <code>[delay]</code> || Sets an NPC&#39;s respawn delay
| /npc polarbear || <code>(-r)</code> || Sets polarbear modifiers
|-
|-
| /npc rotate || <code>(--towards [x,y,z]) (--body [yaw]) (--head [yaw]) (--pitch [pitch]) (-s(mooth))</code> || Rotate NPC
| /npc pose || <code>(--save [name] (-d) &#124; --mirror [name] (-d) &#124; --assume [name] &#124; --remove [name] &#124; --default [name]) (--yaw yaw) (--pitch pitch) (-a)</code> || Manage NPC poses
|-
|-
| /npc select || <code>[id&amp;#124;name] (--range range) (--registry [name])</code> || Select a NPC with the given ID or name
| /npc potioneffect || <code>[add&#124;remove&#124;list] (--name [name] or -t for temporary) (--type [type]) (--duration [duration]) (--amplifier [amplifier]) (--icon [icon])</code> || None
|-
|-
| /npc setequipment || <code>[slot] [item]</code> || Sets equipment via commands
| /npc powered || <code>(--set true&#124;false)</code> || Toggle a creeper NPC as powered
|-
|-
| /npc sheep || <code>(--color [color]) (--sheared [sheared])</code> || Sets sheep modifiers
| /npc pufferfish || <code>(--state state)</code> || Sets pufferfish modifiers
|-
|-
| /npc shop || <code>(edit&amp;#124;show&amp;#124;delete) (name)</code> || NPC shop edit/show
| /npc rabbittype || <code>[type]</code> || Set the NPC&#39;s rabbit type
|-
|-
| /npc shulker || <code>(--peek [peek] --color [color])</code> || Sets shulker modifiers
| /npc remove || <code>(all&#124;id&#124;name&#124; --owner [owner] &#124; --eid [entity uuid] &#124; --world [world])</code> || Remove a NPC
|-
|-
| /npc sitting || <code>(--explicit [true&amp;#124;false]) (--at [at])</code> || Sets the NPC sitting
| /npc rename || <code>[name]</code> || Rename a NPC
|-
|-
| /npc size || <code>[size]</code> || Sets the NPC&#39;s size
| /npc respawn || <code>[delay]</code> || Sets an NPC&#39;s respawn delay
|-
|-
| /npc skin || <code>(-e(xport) -c(lear) -l(atest) -s(kull)) [name] (or --url [url] --file [file] (-s(lim)) or -t [uuid/name] [data] [signature])</code> || Sets an NPC&#39;s skin name. Use -l to set the skin to always update to the latest
| /npc rotate || <code>(--towards [x,y,z]) (--toentity [name&#124;uuid&#124;me]) (--body [yaw]) (--head [yaw]) (--pitch [pitch]) (-s(mooth))</code> || Rotate NPC
|-
|-
| /npc skinlayers || <code>(--cape [true&amp;#124;false]) (--hat [true&amp;#124;false]) (--jacket [true&amp;#124;false]) (--sleeves [true&amp;#124;false]) (--pants [true&amp;#124;false])</code> || Sets an NPC&#39;s skin layers visibility
| /npc rotationsettings || <code>[linear&#124;immediate] (--link_body) (--head_only) (--max_pitch_per_tick) (--max_yaw_per_tick) (--pitch_range) (--yaw_range)</code> || Controls various head and body rotation settings for the NPC.
Currently NPCs look using simple Minecraft-style rotation where the head/body move a certain amount of degrees per tick towards the target
Accepts the following flags:
'''--link_body''': whether the head and body rotation should be linked directly
'''--head_only''': whether only the head should
'''--max_yaw_per_tick''': how many degrees to change yaw per tick (defaults to 40)
'''--max_pitch_per_tick''': how many degrees to change pitch per tick (defaults to 10)
'''--pitch_range''': the range of possible pitches to take (defaults to -180,180)
'''--yaw_range''': the range of possible yaws to take (defaults to -180,180)
|-
|-
| /npc sniffer || <code>(--state [state])</code> || Sets sniffer modifiers
| /npc scaledmaxhealth || <code>[health]</code> || Controls the max health of an NPC, can use large numbers.
|-
|-
| /npc snowman || <code>(-d[erp]) (-f[orm snow])</code> || Sets snowman modifiers
| /npc select || <code>[id&#124;name] (--range range) (--registry [name])</code> || Select a NPC with the given ID or name
|-
|-
| /npc sound || <code>(--death [death sound&amp;#124;d]) (--ambient [ambient sound&amp;#124;d]) (--hurt [hurt sound&amp;#124;d]) (-n(one)/-s(ilent)) (-d(efault))</code> || Sets an NPC&#39;s played sounds
| /npc setequipment || <code>(-c(osmetic)) [slot] [item]</code> || Sets equipment via commands
|-
|-
| /npc spawn || <code>(id&amp;#124;name) -l(oad chunks)</code> || Spawn an existing NPC
| /npc sheep || <code>(--color [color]) (--sheared [sheared])</code> || Sets sheep modifiers
|-
|-
| /npc speak || <code>[message] --bubble [duration] --target [npcid&amp;#124;player name] --range (range to look for entities to speak to in blocks)</code> || Says a message from the NPC
| /npc shop || <code>(edit&#124;show&#124;delete&#124;copyfrom) (name) (new_name)</code> || NPC shop edit/show
|-
|-
| /npc speed || <code>[speed]</code> || Sets the movement speed of an NPC as a percentage
| /npc showshop || <code>(name)</code> || NPC shop show
|-
|-
| /npc spellcaster || <code>(--spell spell)</code> || Sets spellcaster modifiers
| /npc shulker || <code>(--peek [peek] --color [color])</code> || Sets shulker modifiers
|-
|-
| /npc swim || <code>(--set [true&amp;#124;false])</code> || Sets an NPC to swim or not
| /npc sitting || <code>(--explicit [true&#124;false]) (--at [at])</code> || Sets the NPC sitting
|-
|-
| /npc target || <code>[name&amp;#124;UUID] (-a[ggressive]) (-c[ancel])</code> || Target a given entity
| /npc skin || <code>(-e(xport) -c(lear) -l(atest) -s(kull) -b(edrock)) [name] (or --url [url] --file [file] (-s(lim)) or -t [uuid/name] [data] [signature])</code> || Sets an NPC&#39;s skin name. Use -l to set the skin to always update to the latest
|-
|-
| /npc targetable || <code>(-t(emporary))</code> || Toggles an NPC&#39;s targetability
| /npc skinlayers || <code>(--cape [true&#124;false]) (--hat [true&#124;false]) (--jacket [true&#124;false]) (--sleeves [true&#124;false]) (--pants [true&#124;false])</code> || Sets an NPC&#39;s skin layers visibility
|-
|-
| /npc text || <code>text</code> || Toggle the text editor
| /npc slimesize || <code>[size]</code> || None
|-
|-
| /npc tp || <code>(-e(xact))</code> || Teleport in front of an NPC
| /npc sniffer || <code>(--state [state])</code> || Sets sniffer modifiers
|-
|-
| /npc tphere || <code>(cursor) -c(enter) -f(ront)</code> || Teleport a NPC to your location
| /npc snowman || <code>(-d[erp]) (-f[orm snow])</code> || Sets snowman modifiers
|-
|-
| /npc tpto || <code>[player name&amp;#124;npc id] [player name&amp;#124;npc id]</code> || Teleport an NPC or player to another NPC or player
| /npc sound || <code>(--death [death sound&#124;d]) (--ambient [ambient sound&#124;d]) (--hurt [hurt sound&#124;d]) (-n(one)/-s(ilent)) (-d(efault))</code> || Sets an NPC&#39;s played sounds
|-
|-
| /npc trackingrange || <code>[range]</code> || Sets the tracking range
| /npc spawn || <code>(id&#124;name) -l(oad chunks)</code> || Spawn an existing NPC
|-
|-
| /npc tropicalfish || <code>(--body color) (--pattern pattern) (--patterncolor color)</code> || Sets tropical fish modifiers
| /npc speak || <code>[message] --bubble [duration] --target [npcid&#124;player name] --range (range to look for entities to speak to in blocks)</code> || Says a message from the NPC
|-
|-
| /npc type || <code>[type]</code> || Sets an NPC&#39;s entity type
| /npc spectate || <code>(-r(eset))</code> || None
|-
|-
| /npc undo || <code>(all)</code> || Undoes the last action (currently only create/remove supported)
| /npc speed || <code>[speed]</code> || Sets the movement speed of an NPC as a percentage
|-
|-
| /npc useitem || <code>(-o(ffhand))</code> || Sets an NPC to  be using their held items
| /npc spellcaster || <code>(--spell spell)</code> || Sets spellcaster modifiers
|-
|-
| /npc villager || <code>(--level level) (--type type) (--profession profession) -s(hake head)</code> || Sets villager modifiers
| /npc swim || <code>(--set [true&#124;false])</code> || Sets an NPC to swim or not
|-
|-
| /npc vulnerable || <code>(-t(emporary))</code> || Toggles an NPC&#39;s vulnerability
| /npc target || <code>[name&#124;UUID] (-a[ggressive]) (-c[ancel])</code> || Target a given entity
|-
|-
| /npc wander || <code>wander</code> || Sets the NPC to wander around
| /npc targetable || <code>None</code> || Toggles an NPC&#39;s targetability
|-
|-
| /npc warden || <code>dig&amp;#124;emerge&amp;#124;roar&amp;#124;anger [entity uuid/player name] [anger]</code> || Sets warden modifiers
| /npc text || <code>None</code> || Toggle the text editor
|-
|-
| /npc wither || <code>(--invulnerable [true&amp;#124;false]) (--invulnerable-ticks [ticks]) (--arrow-shield [true&amp;#124;false])</code> || Sets wither modifiers
| /npc textdisplay || <code>--shadowed [true&#124;false] --seethrough [true&#124;false] --line_width [width] --text [text]</code> || None
|-
|-
| /npc wolf || <code>(-s(itting) a(ngry) t(amed) i(nterested)) --collar [hex rgb color&amp;#124;name] --variant [variant]</code> || Sets wolf modifiers
| /npc tp || <code>(-e(xact))</code>  || Teleport in front of an NPC
|-
| /npc tphere || <code>(cursor) -c(enter) -f(ront)</code>  || Teleport a NPC to your location
|-
| /npc tpto || <code>[player name&#124;npc id] [player name&#124;npc id]</code>  || Teleport an NPC or player to another NPC or player
|-
| /npc trackingrange || <code>[range]</code>  || Sets the tracking range
|-
| /npc tropicalfish || <code>(--body color) (--pattern pattern) (--patterncolor color)</code>  || Sets tropical fish modifiers
|-
| /npc type || <code>[type]</code>  || Sets an NPC&#39;s entity type
|-
| /npc undo || <code>(all)</code>  || Undoes the last action (currently only create/remove supported)
|-
| /npc useitem || <code>(-o(ffhand))</code>  || Sets an NPC to  be using their held items
|-
| /npc vex || <code>(--charging [charging])</code>  || Set vex modifiers
|-
| /npc villager || <code>(--level level) (--type type) (--profession profession) -s(hake head)</code>  || Sets villager modifiers
|-
| /npc vulnerable || <code>(-t(emporary))</code>  || Toggles an NPC&#39;s vulnerability
|-
| /npc wander || <code>(add x y z world) &#124; (worldguardregion [region]) &#124; (xyrange [xrange] [yrange])</code>  || Sets the NPC to wander around
|-
| /npc warden || <code>dig&#124;emerge&#124;roar&#124;anger [entity uuid/player name] [anger]</code>  || Sets warden modifiers
|-
| /npc wither || <code>(--invulnerable [true&#124;false]) (--invulnerable-ticks [ticks]) (--arrow-shield [true&#124;false])</code>  || Sets wither modifiers
|-
| /npc wolf || <code>(-s(itting) a(ngry) t(amed) i(nterested)) --collar [hex rgb color&#124;name] --variant [variant]</code> || Sets wolf modifiers
|-
|-
|/trait || <code>[trait1] [trait2] ... [traitN]</code> - A list of [[Characters|Traits]] to apply || Adds the [[Characters|trait type]] to the NPC. NPCs can have multiple traits. Example: <code> /trait sentinel</code>
|/trait || <code>[trait1] [trait2] ... [traitN]</code> - A list of [[Characters|Traits]] to apply || Adds the [[Characters|trait type]] to the NPC. NPCs can have multiple traits. Example: <code> /trait sentinel</code>
Line 402: Line 447:
! style="width: 200px;" | Command !! style="width: 400px;" | Arguments !! Description
! style="width: 200px;" | Command !! style="width: 400px;" | Arguments !! Description
|-
|-
| /waypoints disableteleport || None || Stops NPCs from automatically teleporting the end of their path if they get stuck (NOTE: might be removed at some point).
| /waypoints add || <code>[x] [y] [z] (world) (--index idx)</code>  || Adds a waypoint at a point
|-
| /waypoints disableteleport || <code>disableteleport</code>  || Disables teleportation when stuck
|-
| /waypoints hpa || <code>hpa</code>  || None
|-
| /waypoints provider || <code>[provider name]</code>  || Sets the current waypoint provider
|-
|-
| /waypoints provider || <code>[provider name] (-a)</code> - provider name is the provider to use (currently linear, guided and wander), use -a to get a list of all providers || Sets the waypoint provider to use when using the waypoint editor.
| /waypoints remove || <code>(x y z world) (--index idx)</code> || Adds a waypoint at a point
|-
|-
| /waypoint add || <code>[x] [y] [z] (world) (--index idx)</code> || Adds a waypoint at a point
|}
|}


Latest revision as of 16:43, 9 April 2026

Read below for detailed command documentation. For more info on per-type commands and permissions, see its corresponding page.

[] - Mandatory
() - Optional

Command - command's syntax
Args Description - description of the command's arguments
Require Selected - whether the command requires an NPC to be selected
Require Ownership - whether the commands requires you to be the owner of the NPC
Require Mob Types - whether the command requires an NPC to be a certain mob type(s)
Permission - command's permission node
Description - short description of the command

Commands not listed here

There are quite a few commands that are not listed here, mainly for reasons of maintenance order (the wiki isn't updated all that often, but the actual commands list is updated regularly.)
To see the list of commands on your current version of Citizens, simply type /npc help in-game. You can use /npc help 2 to view page 2, and so on (switch 2 to any page number).
To see information on a specific command, you can use /npc help create in-game. Change the "create" to any other command name (the example will show help for the /npc create command).

Some commands have documentation elsewhere:



There are also many commands that are added by other traits. see Characters

Adding Click Commands

If you're looking for a way to add automatically ran commands when you click an NPC, that's explained at NPC_Commands.

Admin Commands

Commands used for administration of Citizens.

Admin Commands
Command Permission Description
/citizens citizens.admin Show basic plugin information
/citizens reload citizens.admin Reload Citizens
/citizens save citizens.admin Save NPCs and configuration

Help Commands

Commands used in-game to show the help screen.

Help Commands
Command Arguments Permission Description
/citizens help (Page) - Page number to display citizens.help Show Citizens help menu
/npc help (Page) - Page number to display citizens.npc.help Show NPC help menu
/trait help (Page) - Page number to display citizens.trait.help Show trait help menu
/template help (Page) - Page number to display citizens.templates.help Show template help menu
/waypoints help (Page) - Page number to display citizens.waypoints.help Show waypoints help menu

NPC Commands

General commands used for all NPCs.

NPC Commands
Command Arguments Description
/npc None None
/npc activationrange [range] Sets the activation range
/npc age [age] (-l(ock)) Can only be used on entities that can become babies. Use the -l flag to lock age over time (note: relogs may be required to see this).
/npc aggressive [true|false] (-t(emporary)) Sets the aggressive status of the entity
/npc ai (true|false) Sets whether the NPC should use vanilla AI
/npc allay (-d(ancing)) Sets allay modifiers
/npc anchor (--save [name]|--assume [name]|--remove [name]) (-a) (-c) Manages the NPC's location anchor(s)
/npc areaeffectcloud --color [color] --duration [duration] --radius [radius] --radius_per_tick [radius] --particle [particle] None
/npc armadillo --state [state] None
/npc armorstand --visible [visible] --small [small] --marker [marker] --gravity [gravity] --arms [arms] --baseplate [baseplate] --(head|body|leftarm|leftleg|rightarm|rightleg)pose [angle x,y,z] Edit armorstand properties
/npc attribute [attribute] [value] Set various NPC attributes
/npc axolotl (-d) (--variant variant) Sets axolotl modifiers
/npc bat --awake [awake] Set bat modifiers
/npc bee (-s/-n) --anger anger Sets bee modifiers
/npc behavior [file.yml] Manages behavior trees
/npc boat --type [type] Sets boat modifiers
/npc bossbar --style [style] --color [color] --title [title] --visible [visible] --viewpermission [permission] --flags [flags] --track [health | placeholder] --range [range] Edit bossbar properties
/npc breakblock --location [x,y,z] --radius [radius] None
/npc camel (--pose pose) Sets camel modifiers
/npc cat (-s/-n/-l) --type type --ccolor collar color Sets cat modifiers
/npc chicken (--variant variant) Manage chicken modifiers
/npc chunkload (-t(emporary)) Toggle the NPC forcing chunks to stay loaded
/npc collidable --fluids [true|false] Toggles an NPC's collidability
/npc command (add [command] | execute [player UUID] [hand] | remove [id|all] | permissions [permissions] (duration) | sequential | cycle | random | forgetplayer (uuid) | clearerror [type] (name|uuid) | errormsg [type] [msg] | persistsequence [true|false] | cost [cost] (id) | expcost [cost] (id) | itemcost (id)) (-s(hift)) (-l[eft]/-r[ight]) (-p[layer] -o[p]), --cooldown --gcooldown [seconds] --delay [ticks] --permissions [perms] --n [max # of uses] --gn [max # of global uses]

Use the -l flag to make the command run on left click, -r on right click (default). execute triggers assigned commands as if a player clicked the npc. Set the per-player cooldown before the command can be used again using --cooldown (in seconds). Set the server-wide cooldown in seconds using --gcooldown. --delay will wait the specified amount in ticks before executing the command. --permissions will set the command to require specific permissions (separate multiple with commas). --n will only let the player run the command that number of times. Use -o to temporarily execute the command as an op and -p to run the command as the clicking player instead of the server. Use -n to run the command as the NPC instead of the clicking player. Must be a player type NPC. To give the player temporary permissions instead of op, use /npc command permissions. Set the cost of each click with /npc command cost/expcost/itemcost. Commands can be executed one by one instead of all at once by using /npc command sequential or /npc command cycle.

/npc configgui None Display NPC configuration GUI
/npc controllable (-m(ount),-o(wner required)) (--controls [controls]) (--enabled [true|false]) Toggles whether the NPC can be ridden and controlled
/npc copier None Toggle the NPC copier
/npc coppergolem (--weatherstate state) (--weatheringtick tick) Controls copper golem modifiers
/npc copy (--name newname) Copies an NPC
/npc cow (--variant variant) Manage cow modifiers
/npc create [name] ((-b(aby),u(nspawned),s(ilent),t(emporary),c(enter),p(acket)) --at [x,y,z,world] --type [type] --item (item) --trait ['trait1, trait2...'] --model [model name] --nameplate [true|false|hover] --temporaryduration [duration] --registry [registry name] Create a new NPC
/npc debug -p(aths) -n(avigation) -i(tem in hand) Display debugging information
/npc deselect None Deselect currently selected NPC
/npc despawn (id) Despawn a NPC
/npc disguise --type [type] Manages entity disguises
/npc display --billboard [billboard] --brightness [blockLight,skyLight] --interpolationdelay [delay] --interpolationduration [duration] --height [height] --width [width] --scale [x,y,z] --viewrange [range] --leftrotation [x,y,z,w] --rightrotation [x,y,z,w] --offset [x,y,z] Set various display entity modifiers
/npc drops None Edit an NPC's drops
/npc endercrystal -b(ottom) Edit endercrystal modifiers
/npc enderdragon --phase [phase] --destroywalls [true|false] Sets enderdragon modifiers
/npc enderman -a(ngry) Set enderman modifiers
/npc entitypose [pose] Control entity pose
/npc equip None Toggle the equipment editor
/npc eval [expression] None
/npc flyable (true|false) Toggles or sets an NPC's flyable status
/npc follow (player name|NPC id) (-p[rotect]) (--margin [margin]) (--enable [boolean]) Toggles NPC following you
/npc forcefield --width [width] --height [height] --strength [strength] --vertical-strength [vertical strength] Creates a forcefield which pushes players close to the NPC away
/npc fox --type type --sleeping [true|false] --sitting [true|false] --crouching [true|false] --interested [true|false] --pouncing [true|false] --faceplanted [true|false] Sets fox modifiers
/npc frog (--variant variant) Sets frog modifiers
/npc gamemode [gamemode] Changes the gamemode
/npc glowing --color [minecraft chat color] Toggles an NPC's glowing status
/npc goat -l(eft) -r(ight) -n(either) -b(oth) horn Sets goat modifiers
/npc gravity None Toggles gravity
/npc hitbox --scale [scale] --width/height [value] --offset [x,y,z] Sets the NPC hitbox
/npc hologram add [text] (--duration [duration]) | insert [line #] [text] | set [line #] [text] | remove [line #] | edit_npc [template | name | line #] | clear | lineheight [height] | viewrange [range] | margintop [line #] [margin] | marginbottom [line #] [margin] Controls NPC hologram text
/npc home --location [loc] --delay [delay] --distance [distance] -h(ere) -p(athfind) -t(eleport) Controls home location
/npc horse (--color color) (--type type) (--style style) (-cbt) Use the -c flag to make the NPC have a chest, or the -b flag to stop them from having a chest.
/npc hurt [damage] Damages the NPC
/npc id None Sends the selected NPC's ID to the sender
/npc inventory (player name/uuid) Show's an NPC's inventory
/npc item [item] (-h(and)) Sets the NPC's item
/npc itemdisplay --transform [transform] None
/npc itemframe --visible [true|false] --fixed [true|false] --rotation [rotation] --item [item] --face [face] Sets itemframe modifiers
/npc jump None Makes the NPC jump
/npc knockback (--explicit true|false) Toggle NPC knockback
/npc leashable None Toggles leashability
/npc list (page) ((-a) --owner (owner) --type (type) --char (char) --registry (name)) List NPCs
/npc llama (--color color) (--strength strength) Sets llama modifiers
/npc lookclose --range [range] --filter [filter] -r[ealistic looking] --randomlook [true|false] --perplayer [true|false] --randomswitchtargets [true|false] --randompitchrange [min,max] --randomyawrange [min,max] --disablewhennavigating [true|false] --targetnpcs [true|false] Toggle whether a NPC will look when a player is near
/npc mannequin --hide_description [true|false] --immovable [true|false] --description [description] --main_hand [LEFT|RIGHT] --skin_patch_type [type] --skin_patch_body [location] --skin_patch_cape [location] --skin_patch_elytra [location] None
/npc metadata set|get|remove [key] (value) (-t(emporary)) Manages NPC metadata
/npc minecart (--offset offset) Sets minecart item
/npc mirror --name [true|false] --equipment [true|false] Controls mirroring of NPC skins and more
/npc model [name] None
/npc modelanimate [start|stop|clear] (name) (speed) None
/npc mount (--onnpc <npc id|uuid>) (-d(ismount)) (-c(ancel)) Mounts a controllable NPC
/npc moveto x:y:z:world | x y z world Teleports a NPC to a given location
/npc mushroomcow (--variant [variant]) Sets mushroom cow modifiers
/npc name (-h(over)) Toggle nameplate visibility, or only show names on hover
/npc ocelot (--type type) (-s(itting), -n(ot sitting)) Set the ocelot type of an NPC and whether it is sitting
/npc owner [uuid|SERVER] Set the owner of an NPC
/npc packet --enabled [true|false] Controls packet NPC settings
/npc painting (--art art) Set painting modifiers
/npc panda --gene (main gene) --hiddengene (hidden gene) -e(ating) -s(itting) -n (sneezing) -r(olling) Sets panda modifiers
/npc panimate [animation] Plays a player animation
/npc parrot (--variant variant) Sets parrot modifiers
/npc passive (--set [true|false]) Sets whether an NPC damages other entities or not
/npc path None Toggle the waypoint editor
/npc pathopt --avoid-teleporting [true|false] --avoid-water [true|false] --attack-delay-duration [duration] --destination-teleport-margin [margin] --open-doors [true|false] --path-range [range] --stationary-ticks [ticks] --attack-range [range] --distance-margin [margin] --path-distance-margin [margin] --pathfinder-type [CITIZENS|MINECRAFT] --falling-distance [distance] Sets an NPC's pathfinding options
/npc pathto me | here | cursor | [x] [y] [z] (--margin [distance margin]) (-s[traight line]) Starts pathfinding to a certain location
/npc pausepathfinding --onrightclick [true|false] --when-player-within [range in blocks] --pauseduration [duration] --lockoutduration [duration] Sets pathfinding pause
/npc phantom (--size size) Sets phantom modifiers
/npc pickupitems (--set [true|false]) Allow NPC to pick up items
/npc pig (--variant variant) Manage pig modifiers
/npc piglin (--dancing [true|false]) Sets piglin modifiers
/npc playerfilter -a(llowlist) -e(mpty) -d(enylist) --add [uuid] --remove [uuid] --addpermission [permission] --removepermission [permission] --addgroup [group] --removegroup [group] -c(lear) --applywithin [blocks range] Manages the NPC's player filter
/npc playerlist (-a(dd),r(emove)) Sets whether the NPC is put in the playerlist
/npc playsound [sound] (category) (volume) (pitch) (--to [player]) (--at x:y:z:world) Plays a sound at the NPC's location
/npc polarbear (-r) Sets polarbear modifiers
/npc pose (--save [name] (-d) | --mirror [name] (-d) | --assume [name] | --remove [name] | --default [name]) (--yaw yaw) (--pitch pitch) (-a) Manage NPC poses
/npc potioneffect [add|remove|list] (--name [name] or -t for temporary) (--type [type]) (--duration [duration]) (--amplifier [amplifier]) (--icon [icon]) None
/npc powered (--set true|false) Toggle a creeper NPC as powered
/npc pufferfish (--state state) Sets pufferfish modifiers
/npc rabbittype [type] Set the NPC's rabbit type
/npc remove (all|id|name| --owner [owner] | --eid [entity uuid] | --world [world]) Remove a NPC
/npc rename [name] Rename a NPC
/npc respawn [delay] Sets an NPC's respawn delay
/npc rotate (--towards [x,y,z]) (--toentity [name|uuid|me]) (--body [yaw]) (--head [yaw]) (--pitch [pitch]) (-s(mooth)) Rotate NPC
/npc rotationsettings [linear|immediate] (--link_body) (--head_only) (--max_pitch_per_tick) (--max_yaw_per_tick) (--pitch_range) (--yaw_range) Controls various head and body rotation settings for the NPC.

Currently NPCs look using simple Minecraft-style rotation where the head/body move a certain amount of degrees per tick towards the target Accepts the following flags: --link_body: whether the head and body rotation should be linked directly --head_only: whether only the head should --max_yaw_per_tick: how many degrees to change yaw per tick (defaults to 40) --max_pitch_per_tick: how many degrees to change pitch per tick (defaults to 10) --pitch_range: the range of possible pitches to take (defaults to -180,180) --yaw_range: the range of possible yaws to take (defaults to -180,180)

/npc scaledmaxhealth [health] Controls the max health of an NPC, can use large numbers.
/npc select [id|name] (--range range) (--registry [name]) Select a NPC with the given ID or name
/npc setequipment (-c(osmetic)) [slot] [item] Sets equipment via commands
/npc sheep (--color [color]) (--sheared [sheared]) Sets sheep modifiers
/npc shop (edit|show|delete|copyfrom) (name) (new_name) NPC shop edit/show
/npc showshop (name) NPC shop show
/npc shulker (--peek [peek] --color [color]) Sets shulker modifiers
/npc sitting (--explicit [true|false]) (--at [at]) Sets the NPC sitting
/npc skin (-e(xport) -c(lear) -l(atest) -s(kull) -b(edrock)) [name] (or --url [url] --file [file] (-s(lim)) or -t [uuid/name] [data] [signature]) Sets an NPC's skin name. Use -l to set the skin to always update to the latest
/npc skinlayers (--cape [true|false]) (--hat [true|false]) (--jacket [true|false]) (--sleeves [true|false]) (--pants [true|false]) Sets an NPC's skin layers visibility
/npc slimesize [size] None
/npc sniffer (--state [state]) Sets sniffer modifiers
/npc snowman (-d[erp]) (-f[orm snow]) Sets snowman modifiers
/npc sound (--death [death sound|d]) (--ambient [ambient sound|d]) (--hurt [hurt sound|d]) (-n(one)/-s(ilent)) (-d(efault)) Sets an NPC's played sounds
/npc spawn (id|name) -l(oad chunks) Spawn an existing NPC
/npc speak [message] --bubble [duration] --target [npcid|player name] --range (range to look for entities to speak to in blocks) Says a message from the NPC
/npc spectate (-r(eset)) None
/npc speed [speed] Sets the movement speed of an NPC as a percentage
/npc spellcaster (--spell spell) Sets spellcaster modifiers
/npc swim (--set [true|false]) Sets an NPC to swim or not
/npc target [name|UUID] (-a[ggressive]) (-c[ancel]) Target a given entity
/npc targetable None Toggles an NPC's targetability
/npc text None Toggle the text editor
/npc textdisplay --shadowed [true|false] --seethrough [true|false] --line_width [width] --text [text] None
/npc tp (-e(xact)) Teleport in front of an NPC
/npc tphere (cursor) -c(enter) -f(ront) Teleport a NPC to your location
/npc tpto [player name|npc id] [player name|npc id] Teleport an NPC or player to another NPC or player
/npc trackingrange [range] Sets the tracking range
/npc tropicalfish (--body color) (--pattern pattern) (--patterncolor color) Sets tropical fish modifiers
/npc type [type] Sets an NPC's entity type
/npc undo (all) Undoes the last action (currently only create/remove supported)
/npc useitem (-o(ffhand)) Sets an NPC to be using their held items
/npc vex (--charging [charging]) Set vex modifiers
/npc villager (--level level) (--type type) (--profession profession) -s(hake head) Sets villager modifiers
/npc vulnerable (-t(emporary)) Toggles an NPC's vulnerability
/npc wander (add x y z world) | (worldguardregion [region]) | (xyrange [xrange] [yrange]) Sets the NPC to wander around
/npc warden dig|emerge|roar|anger [entity uuid/player name] [anger] Sets warden modifiers
/npc wither (--invulnerable [true|false]) (--invulnerable-ticks [ticks]) (--arrow-shield [true|false]) Sets wither modifiers
/npc wolf (-s(itting) a(ngry) t(amed) i(nterested)) --collar [hex rgb color|name] --variant [variant] Sets wolf modifiers
/trait [trait1] [trait2] ... [traitN] - A list of Traits to apply Adds the trait type to the NPC. NPCs can have multiple traits. Example: /trait sentinel

Denizen-added commands

The following /npc commands are added by Denizen (as copied from /npc help). Denizen can be downloaded from here.

Denizen /NPC Commands
Command Arguments Description
/npc mirrorskin None Makes the NPC mirror the skin of the player looking at it.
/npc mirrorname None Makes the NPC mirror the name of the player looking at it.
/npc mirrorequip None Makes the NPC mirror the equipment of the player looking at it.
/npc stand None Makes the NPC stand.
/npc pushable -t (-r) (--delay #) Makes an NPC pushable.
/npc constant --set/remove name --value constant value Views/adds/removes NPC string constants.
/npc assignment --set assignment_name (-r) Controls the assignment for an NPC.
/npc trigger [trigger name] [(--cooldown [seconds])/(--radius [radius])/(-t)] Controls the various triggers for an NPC.
/npc nickname [--set nickname] Gives the NPC a nickname, used with a Denizen-compatible Speech Engine.
/npc sit (--location x,y,z,world) (--anchor anchor_name) (-c) Makes the NPC sit.
/npc sleep (--location x,y,z,world) (--anchor anchor_name) Makes the NPC sleep.
/npc sneak None Makes the NPC crouch.
/npc wakeup None Makes the NPC wake up.
/npc fish (--location x,y,z,world) (--anchor anchor_name) (-c) Makes the NPC fish, casting at the given location.
/npc stopfishing None Makes the NPC stop fishing.
/npc invisible None Turns the NPC invisible.
/npc health --set # (-r) Sets the max health for an NPC.

Waypoint commands

Permissions are of the format "citizens.waypoints.xx", like "citizens.waypoints.disableteleport" for the "disableteleport" command.

Waypoint Commands
Command Arguments Description
/waypoints add [x] [y] [z] (world) (--index idx) Adds a waypoint at a point
/waypoints disableteleport disableteleport Disables teleportation when stuck
/waypoints hpa hpa None
/waypoints provider [provider name] Sets the current waypoint provider
/waypoints remove (x y z world) (--index idx) Adds a waypoint at a point

Template commands

Template Commands
Command Arguments Permission Description
/template apply (template namespace:)[template name] citizens.templates.apply Applies a template to the selected NPC
/template generate (template namespace:)[name] citizens.templates.generate Generate a template from the selected NPC
/template list list citizens.templates.list Lists available templates

See Also

Characters
Text Syntax
Waypoints

Retrieved from "https://wiki.citizensnpcs.co/index.php?title=Commands&oldid=5677"