Commands: Difference between revisions
From Citizens Wiki
| (3 intermediate revisions by the same user not shown) | |||
| Line 79: | Line 79: | ||
| /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 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 | | /npc aggressive || <code>[true|false]</code> || Sets the aggressive status of the entity | ||
|- | |- | ||
| /npc ai || <code>(true& | | /npc ai || <code>(true|false)</code> || Sets whether the NPC should use vanilla AI | ||
|- | |- | ||
| /npc allay || <code>(-d(ancing))</code> || Sets allay modifiers | | /npc allay || <code>(-d(ancing))</code> || Sets allay modifiers | ||
|- | |- | ||
| /npc anchor || <code>(--save [name]|--assume [name]& | | /npc anchor || <code>(--save [name]|--assume [name]|--remove [name]) (-a) (-c)</code> || Manages the NPC's location anchor(s) | ||
|- | |- | ||
| /npc armadillo || <code>--state [state]</code> || None | | /npc armadillo || <code>--state [state]</code> || None | ||
|- | |- | ||
| /npc armorstand || <code>--visible [visible] --small [small] --marker [marker] --gravity [gravity] --arms [arms] --baseplate [baseplate] --(head& | | /npc armorstand || <code>--visible [visible] --small [small] --marker [marker] --gravity [gravity] --arms [arms] --baseplate [baseplate] --(head|body|leftarm|leftleg|rightarm|rightleg)pose [angle x,y,z]</code> || Edit armorstand properties | ||
|- | |- | ||
| /npc attribute || <code>[attribute] [value]</code> || Set various NPC attributes | | /npc attribute || <code>[attribute] [value]</code> || Set various NPC attributes | ||
|- | |- | ||
| /npc axolotl || <code>(-d) (--variant variant)</code> || Sets axolotl modifiers | | /npc axolotl || <code>(-d) (--variant variant)</code> || Sets axolotl modifiers | ||
|- | |||
| /npc bat || <code>--awake [awake]</code> || Set bat modifiers | |||
|- | |- | ||
| /npc bee || <code>(-s/-n) --anger anger</code> || Sets bee modifiers | | /npc bee || <code>(-s/-n) --anger anger</code> || Sets bee modifiers | ||
| Line 99: | Line 101: | ||
| /npc boat || <code>--type [type]</code> || Sets boat modifiers | | /npc boat || <code>--type [type]</code> || Sets boat modifiers | ||
|- | |- | ||
| /npc bossbar || <code>--style [style] --color [color] --title [title] --visible [visible] --viewpermission [permission] --flags [flags] --track [health & | | /npc bossbar || <code>--style [style] --color [color] --title [title] --visible [visible] --viewpermission [permission] --flags [flags] --track [health | placeholder] --range [range]</code> || Edit bossbar properties | ||
|- | |- | ||
| /npc breakblock || <code>--location [x,y,z] --radius [radius]</code> || None | | /npc breakblock || <code>--location [x,y,z] --radius [radius]</code> || None | ||
| Line 109: | Line 111: | ||
| /npc chunkload || <code>(-t(emporary))</code> || Toggle the NPC forcing chunks to stay loaded | | /npc chunkload || <code>(-t(emporary))</code> || Toggle the NPC forcing chunks to stay loaded | ||
|- | |- | ||
| /npc collidable || <code> | | /npc collidable || <code>--fluids [true|false]</code> || Toggles an NPC's collidability | ||
|- | |- | ||
| /npc command || <code>(add [command] & | | /npc command || <code>(add [command] | remove [id|all] | permissions [permissions] | 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]</code> || | ||
Use the [[-l]] flag to make the command run on left click, [[-r]] on right click (default). | 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 per-player cooldown before the command can be used again using [[--cooldown]] (in [[seconds]]). | ||
| Line 119: | Line 121: | ||
[[--n]] will only let the player run the command that number of times. | [[--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 [[-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]]. | 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]]. | 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]]. | Commands can be executed one by one instead of all at once by using [[/npc command sequential]] or [[/npc command cycle]]. | ||
|- | |- | ||
| /npc configgui || <code> | | /npc configgui || <code>None</code> || Display NPC configuration GUI | ||
|- | |- | ||
| /npc controllable || <code>(-m(ount) | | /npc controllable || <code>(-m(ount),-o(wner required)) (--controls [controls]) (--enabled [true|false])</code> || Toggles whether the NPC can be ridden and controlled | ||
|- | |- | ||
| /npc copier || <code> | | /npc copier || <code>None</code> || Toggle the NPC copier | ||
|- | |- | ||
| /npc copy || <code>(--name newname)</code> || Copies an NPC | | /npc copy || <code>(--name newname)</code> || Copies an 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 ['trait1, trait2...'] --model [model name] --nameplate [true& | | /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 ['trait1, trait2...'] --model [model name] --nameplate [true|false|hover] --temporaryticks [ticks] --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)</code> || Display debugging information | ||
|- | |- | ||
| /npc deselect || <code> | | /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> | | /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]</code> || Set various display entity modifiers | ||
|- | |||
| /npc drops || <code>None</code> || Edit an NPC's drops | |||
|- | |- | ||
| /npc endercrystal || <code>-b(ottom)</code> || Edit endercrystal modifiers | | /npc endercrystal || <code>-b(ottom)</code> || Edit endercrystal modifiers | ||
|- | |- | ||
| /npc enderdragon || <code>--phase [phase] --destroywalls [true& | | /npc enderdragon || <code>--phase [phase] --destroywalls [true|false]</code> || Sets enderdragon modifiers | ||
|- | |- | ||
| /npc enderman || <code>-a(ngry)</code> || Set enderman modifiers | | /npc enderman || <code>-a(ngry)</code> || Set enderman modifiers | ||
|- | |- | ||
| /npc | | /npc entitypose || <code>[pose]</code> || Control entity pose | ||
|- | |- | ||
| /npc | | /npc equip || <code>None</code> || Toggle the equipment editor | ||
|- | |- | ||
| /npc | | /npc flyable || <code>(true|false)</code> || Toggles or sets an NPC's flyable status | ||
|- | |- | ||
| /npc fox || <code>--type type --sleeping [true& | | /npc follow || <code>(player name|NPC id) (-p[rotect]) (--margin [margin]) (--enable [boolean])</code> || Toggles NPC following you | ||
|- | |||
| /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 fox || <code>--type type --sleeping [true|false] --sitting [true|false] --crouching [true|false] --interested [true|false] --pouncing [true|false] --faceplanted [true|false]</code> || Sets fox modifiers | |||
|- | |- | ||
| /npc frog || <code>(--variant variant)</code> || Sets frog modifiers | | /npc frog || <code>(--variant variant)</code> || Sets frog modifiers | ||
| Line 163: | Line 172: | ||
| /npc goat || <code>-l(eft) -r(ight) -n(either) -b(oth) horn</code> || Sets goat modifiers | | /npc goat || <code>-l(eft) -r(ight) -n(either) -b(oth) horn</code> || Sets goat modifiers | ||
|- | |- | ||
| /npc gravity || <code> | | /npc gravity || <code>None</code> || Toggles gravity | ||
|- | |- | ||
| /npc hitbox || <code>--scale [scale] --width/height [value]</code> || Sets the NPC hitbox | | /npc hitbox || <code>--scale [scale] --width/height [value]</code> || Sets the NPC hitbox | ||
|- | |- | ||
| /npc hologram || <code>add [text] & | | /npc hologram || <code>add [text] | set [line #] [text] | remove [line #] | bgcolor [line #] (red,green,blue(,alpha)) | clear | lineheight [height] | viewrange [range] | margintop [line #] [margin] | marginbottom [line #] [margin]</code> || Controls NPC hologram text | ||
|- | |- | ||
| /npc home || <code>--location [loc] --delay [delay] --distance [distance] -h(ere) -p(athfind) -t(eleport)</code> || Controls home location | | /npc home || <code>--location [loc] --delay [delay] --distance [distance] -h(ere) -p(athfind) -t(eleport)</code> || Controls home location | ||
| Line 175: | Line 184: | ||
| /npc hurt || <code>[damage]</code> || Damages the NPC | | /npc hurt || <code>[damage]</code> || Damages the NPC | ||
|- | |- | ||
| /npc id || <code> | | /npc id || <code>None</code> || Sends the selected NPC's ID to the sender | ||
|- | |- | ||
| /npc inventory || <code> | | /npc inventory || <code>(player name/uuid)</code> || Show's an NPC's inventory | ||
|- | |- | ||
| /npc item || <code>(item) (metadata) (-h(and))</code> || Sets the NPC's item | | /npc item || <code>(item) (metadata) (-h(and))</code> || Sets the NPC's item | ||
|- | |- | ||
| /npc itemframe || <code>--visible [true& | | /npc itemframe || <code>--visible [true|false] --fixed [true|false] --rotation [rotation] --item [item]</code> || Sets itemframe modifiers | ||
|- | |- | ||
| /npc jump || <code> | | /npc jump || <code>None</code> || Makes the NPC jump | ||
|- | |- | ||
| /npc knockback || <code>(--explicit true& | | /npc knockback || <code>(--explicit true|false)</code> || Toggle NPC knockback | ||
|- | |- | ||
| /npc leashable || <code> | | /npc leashable || <code>None</code> || Toggles leashability | ||
|- | |- | ||
| /npc list || <code>(page) ((-a) --owner (owner) --type (type) --char (char) --registry (name))</code> || List NPCs | | /npc list || <code>(page) ((-a) --owner (owner) --type (type) --char (char) --registry (name))</code> || List NPCs | ||
| Line 193: | Line 202: | ||
| /npc llama || <code>(--color color) (--strength strength)</code> || Sets llama modifiers | | /npc llama || <code>(--color color) (--strength strength)</code> || Sets llama modifiers | ||
|- | |- | ||
| /npc lookclose || <code>--range [range] -r[ealistic looking] --randomlook [true& | | /npc lookclose || <code>--range [range] -r[ealistic looking] --randomlook [true|false] --perplayer [true|false] --randomswitchtargets [true|false] --randompitchrange [min,max] --randomyawrange [min,max] --disablewhennavigating [true|false] --targetnpcs [true|false]</code> || Toggle whether a NPC will look when a player is near | ||
|- | |- | ||
| /npc metadata || <code>set& | | /npc metadata || <code>set|get|remove [key] (value) (-t(emporary))</code> || Manages NPC metadata | ||
|- | |- | ||
| /npc minecart || <code>(--item item_name(:data)) (--offset offset)</code> || Sets minecart item | | /npc minecart || <code>(--item item_name(:data)) (--offset offset)</code> || Sets minecart item | ||
|- | |- | ||
| /npc mirror || <code>--name [true& | | /npc mirror || <code>--name [true|false]</code> || Controls mirroring of NPC skins and more | ||
|- | |- | ||
| /npc model || <code>[name]</code> || None | | /npc model || <code>[name]</code> || None | ||
|- | |- | ||
| /npc modelanimate || <code>[start& | | /npc modelanimate || <code>[start|stop|clear] (name) (speed)</code> || None | ||
|- | |- | ||
| /npc mount || <code>(--onnpc <npc id& | | /npc mount || <code>(--onnpc <npc id|uuid>) (-c(ancel))</code> || Mounts a controllable NPC | ||
|- | |- | ||
| /npc moveto || <code>x:y:z:world & | | /npc moveto || <code>x:y:z:world | x y z world</code> || Teleports a NPC to a given location | ||
|- | |- | ||
| /npc mushroomcow || <code>(--variant [variant])</code> || Sets mushroom cow modifiers | | /npc mushroomcow || <code>(--variant [variant])</code> || Sets mushroom cow modifiers | ||
| Line 215: | Line 224: | ||
| /npc ocelot || <code>(--type type) (-s(itting), -n(ot sitting))</code> || Set the ocelot type of an NPC and whether it is sitting | | /npc ocelot || <code>(--type type) (-s(itting), -n(ot sitting))</code> || Set the ocelot type of an NPC and whether it is sitting | ||
|- | |- | ||
| /npc owner || <code>[uuid& | | /npc owner || <code>[uuid|SERVER]</code> || Set the owner of an NPC | ||
|- | |- | ||
| /npc packet || <code>--enabled [true& | | /npc packet || <code>--enabled [true|false]</code> || Controls packet NPC settings | ||
|- | |- | ||
| /npc painting || <code>(--art art)</code> || Set painting modifiers | | /npc painting || <code>(--art art)</code> || Set painting modifiers | ||
| Line 227: | Line 236: | ||
| /npc parrot || <code>(--variant variant)</code> || Sets parrot modifiers | | /npc parrot || <code>(--variant variant)</code> || Sets parrot modifiers | ||
|- | |- | ||
| /npc passive || <code>(--set [true& | | /npc passive || <code>(--set [true|false])</code> || Sets whether an NPC damages other entities or not | ||
|- | |- | ||
| /npc path || <code> | | /npc path || <code>None</code> || Toggle the waypoint editor | ||
|- | |- | ||
| /npc pathopt || <code>--avoid-water& | | /npc pathopt || <code>--avoid-water|aw [true|false] --open-doors [true|false] --path-range [range] --stationary-ticks [ticks] --attack-range [range] --distance-margin [margin] --path-distance-margin [margin] --use-new-finder [true|false] --falling-distance [distance]</code> || Sets an NPC's pathfinding options | ||
|- | |- | ||
| /npc pathto || <code>me & | | /npc pathto || <code>me | here | cursor | [x] [y] [z] (--margin [distance margin]) (-s[traight line])</code> || Starts pathfinding to a certain location | ||
|- | |- | ||
| /npc pausepathfinding || <code>--onrightclick [true& | | /npc pausepathfinding || <code>--onrightclick [true|false] --when-player-within [range in blocks] --pauseticks [ticks]</code> || Sets pathfinding pause | ||
|- | |- | ||
| /npc phantom || <code>(--size size)</code> || Sets phantom modifiers | | /npc phantom || <code>(--size size)</code> || Sets phantom modifiers | ||
|- | |- | ||
| /npc pickupitems || <code>(--set [true& | | /npc pickupitems || <code>(--set [true|false])</code> || Allow NPC to pick up items | ||
|- | |- | ||
| /npc piglin || <code>(--dancing [true& | | /npc piglin || <code>(--dancing [true|false])</code> || Sets piglin modifiers | ||
|- | |- | ||
| /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's player filter | | /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's player filter | ||
| Line 251: | Line 260: | ||
| /npc polarbear || <code>(-r)</code> || Sets polarbear modifiers | | /npc polarbear || <code>(-r)</code> || Sets polarbear modifiers | ||
|- | |- | ||
| /npc pose || <code>(--save [name] (-d) & | | /npc pose || <code>(--save [name] (-d) | --mirror [name] (-d) | --assume [name] | --remove [name] | --default [name]) (--yaw yaw) (--pitch pitch) (-a)</code> || Manage NPC poses | ||
|- | |- | ||
| /npc | | /npc powered || <code>(--set true|false)</code> || Toggle a creeper NPC as powered | ||
|- | |- | ||
| /npc pufferfish || <code>(--state state)</code> || Sets pufferfish modifiers | | /npc pufferfish || <code>(--state state)</code> || Sets pufferfish modifiers | ||
| Line 261: | Line 268: | ||
| /npc rabbittype || <code>[type]</code> || Set the NPC's rabbit type | | /npc rabbittype || <code>[type]</code> || Set the NPC's rabbit type | ||
|- | |- | ||
| /npc remove || <code>(all& | | /npc remove || <code>(all|id|name| --owner [owner] | --eid [entity uuid] | --world [world])</code> || Remove a NPC | ||
|- | |- | ||
| /npc rename || <code>[name]</code> || Rename a NPC | | /npc rename || <code>[name]</code> || Rename a NPC | ||
| Line 269: | Line 276: | ||
| /npc rotate || <code>(--towards [x,y,z]) (--body [yaw]) (--head [yaw]) (--pitch [pitch]) (-s(mooth))</code> || Rotate NPC | | /npc rotate || <code>(--towards [x,y,z]) (--body [yaw]) (--head [yaw]) (--pitch [pitch]) (-s(mooth))</code> || Rotate NPC | ||
|- | |- | ||
| /npc select || <code>[id& | | /npc select || <code>[id|name] (--range range) (--registry [name])</code> || Select a NPC with the given ID or name | ||
|- | |- | ||
| /npc setequipment || <code>[slot] [item]</code> || Sets equipment via commands | | /npc setequipment || <code>[slot] [item]</code> || Sets equipment via commands | ||
| Line 275: | Line 282: | ||
| /npc sheep || <code>(--color [color]) (--sheared [sheared])</code> || Sets sheep modifiers | | /npc sheep || <code>(--color [color]) (--sheared [sheared])</code> || Sets sheep modifiers | ||
|- | |- | ||
| /npc shop || <code>(edit& | | /npc shop || <code>(edit|show|delete|copyfrom) (name) (new_name)</code> || NPC shop edit/show | ||
|- | |- | ||
| /npc shulker || <code>(--peek [peek] --color [color])</code> || Sets shulker modifiers | | /npc shulker || <code>(--peek [peek] --color [color])</code> || Sets shulker modifiers | ||
|- | |- | ||
| /npc sitting || <code>(--explicit [true& | | /npc sitting || <code>(--explicit [true|false]) (--at [at])</code> || Sets the NPC sitting | ||
|- | |- | ||
| /npc size || <code>[size]</code> || Sets the NPC's size | | /npc size || <code>[size]</code> || Sets the NPC's size | ||
|- | |- | ||
| /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's skin name. Use -l to set the skin to always update to the latest | | /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's skin name. Use -l to set the skin to always update to the latest | ||
|- | |- | ||
| /npc skinlayers || <code>(--cape [true& | | /npc skinlayers || <code>(--cape [true|false]) (--hat [true|false]) (--jacket [true|false]) (--sleeves [true|false]) (--pants [true|false])</code> || Sets an NPC's skin layers visibility | ||
|- | |- | ||
| /npc sniffer || <code>(--state [state])</code> || Sets sniffer modifiers | | /npc sniffer || <code>(--state [state])</code> || Sets sniffer modifiers | ||
| Line 291: | Line 298: | ||
| /npc snowman || <code>(-d[erp]) (-f[orm snow])</code> || Sets snowman modifiers | | /npc snowman || <code>(-d[erp]) (-f[orm snow])</code> || Sets snowman modifiers | ||
|- | |- | ||
| /npc sound || <code>(--death [death sound& | | /npc sound || <code>(--death [death sound|d]) (--ambient [ambient sound|d]) (--hurt [hurt sound|d]) (-n(one)/-s(ilent)) (-d(efault))</code> || Sets an NPC's played sounds | ||
|- | |- | ||
| /npc spawn || <code>(id& | | /npc spawn || <code>(id|name) -l(oad chunks)</code> || Spawn an existing NPC | ||
|- | |- | ||
| /npc speak || <code>[message] --bubble [duration] --target [npcid& | | /npc speak || <code>[message] --bubble [duration] --target [npcid|player name] --range (range to look for entities to speak to in blocks)</code> || Says a message from the NPC | ||
|- | |- | ||
| /npc speed || <code>[speed]</code> || Sets the movement speed of an NPC as a percentage | | /npc speed || <code>[speed]</code> || Sets the movement speed of an NPC as a percentage | ||
| Line 301: | Line 308: | ||
| /npc spellcaster || <code>(--spell spell)</code> || Sets spellcaster modifiers | | /npc spellcaster || <code>(--spell spell)</code> || Sets spellcaster modifiers | ||
|- | |- | ||
| /npc swim || <code>(--set [true& | | /npc swim || <code>(--set [true|false])</code> || Sets an NPC to swim or not | ||
|- | |- | ||
| /npc target || <code>[name& | | /npc target || <code>[name|UUID] (-a[ggressive]) (-c[ancel])</code> || Target a given entity | ||
|- | |- | ||
| /npc targetable || <code>(-t(emporary))</code> || Toggles an NPC's targetability | | /npc targetable || <code>(-t(emporary))</code> || Toggles an NPC's targetability | ||
|- | |- | ||
| /npc text || <code> | | /npc text || <code>None</code> || Toggle the text editor | ||
|- | |- | ||
| /npc tp || <code>(-e(xact))</code> || Teleport in front of an NPC | | /npc tp || <code>(-e(xact))</code> || Teleport in front of an NPC | ||
| Line 313: | Line 320: | ||
| /npc tphere || <code>(cursor) -c(enter) -f(ront)</code> || Teleport a NPC to your location | | /npc tphere || <code>(cursor) -c(enter) -f(ront)</code> || Teleport a NPC to your location | ||
|- | |- | ||
| /npc tpto || <code>[player name& | | /npc tpto || <code>[player name|npc id] [player name|npc id]</code> || Teleport an NPC or player to another NPC or player | ||
|- | |- | ||
| /npc trackingrange || <code>[range]</code> || Sets the tracking range | | /npc trackingrange || <code>[range]</code> || Sets the tracking range | ||
| Line 329: | Line 336: | ||
| /npc vulnerable || <code>(-t(emporary))</code> || Toggles an NPC's vulnerability | | /npc vulnerable || <code>(-t(emporary))</code> || Toggles an NPC's vulnerability | ||
|- | |- | ||
| /npc wander || <code> | | /npc wander || <code>None</code> || Sets the NPC to wander around | ||
|- | |- | ||
| /npc warden || <code>dig& | | /npc warden || <code>dig|emerge|roar|anger [entity uuid/player name] [anger]</code> || Sets warden modifiers | ||
|- | |- | ||
| /npc wither || <code>(--invulnerable [true& | | /npc wither || <code>(--invulnerable [true|false]) (--invulnerable-ticks [ticks]) (--arrow-shield [true|false])</code> || Sets wither modifiers | ||
|- | |- | ||
| /npc wolf || <code>(-s(itting) a(ngry) t(amed) i(nterested)) --collar [hex rgb color& | | /npc wolf || <code>(-s(itting) a(ngry) t(amed) i(nterested)) --collar [hex rgb color|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> | ||
Latest revision as of 12:25, 5 September 2024
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. Such as:
- npc skin has documentation here: Skins
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] |
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 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 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 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] | remove [id|all] | permissions [permissions] | 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] |
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. 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 copy | (--name newname) |
Copies an NPC | ||||
| /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] --temporaryticks [ticks] --registry [registry name] |
Create a new NPC | ||||
| /npc debug | -p(aths) -n(avigation) |
Display debugging information | ||||
| /npc deselect | None |
Deselect currently selected NPC | ||||
| /npc despawn | (id) |
Despawn a NPC | ||||
| /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] |
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 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] |
Sets the NPC hitbox | ||||
| /npc hologram | add [text] | set [line #] [text] | remove [line #] | bgcolor [line #] (red,green,blue(,alpha)) | 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) (-cb) |
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) (metadata) (-h(and)) |
Sets the NPC's item | ||||
| /npc itemframe | --visible [true|false] --fixed [true|false] --rotation [rotation] --item [item] |
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] -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 metadata | set|get|remove [key] (value) (-t(emporary)) |
Manages NPC metadata | ||||
| /npc minecart | (--item item_name(:data)) (--offset offset) |
Sets minecart item | ||||
| /npc mirror | --name [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>) (-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-water|aw [true|false] --open-doors [true|false] --path-range [range] --stationary-ticks [ticks] --attack-range [range] --distance-margin [margin] --path-distance-margin [margin] --use-new-finder [true|false] --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] --pauseticks [ticks] |
Sets pathfinding pause | ||||
| /npc phantom | (--size size) |
Sets phantom modifiers | ||||
| /npc pickupitems | (--set [true|false]) |
Allow NPC to pick up items | ||||
| /npc piglin | (--dancing [true|false]) |
Sets piglin modifiers | ||||
| /npc playerfilter | -a(llowlist) -e(mpty) -d(enylist) --add [uuid] --remove [uuid] --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] (volume) (pitch) (--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 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]) (--body [yaw]) (--head [yaw]) (--pitch [pitch]) (-s(mooth)) |
Rotate NPC | ||||
| /npc select | [id|name] (--range range) (--registry [name]) |
Select a NPC with the given ID or name | ||||
| /npc setequipment | [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 shulker | (--peek [peek] --color [color]) |
Sets shulker modifiers | ||||
| /npc sitting | (--explicit [true|false]) (--at [at]) |
Sets the NPC sitting | ||||
| /npc size | [size] |
Sets the NPC's size | ||||
| /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 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 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 | (-t(emporary)) |
Toggles an NPC's targetability | ||||
| /npc text | None |
Toggle the text editor | ||||
| /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 villager | (--level level) (--type type) (--profession profession) -s(hake head) |
Sets villager modifiers | ||||
| /npc vulnerable | (-t(emporary)) |
Toggles an NPC's vulnerability | ||||
| /npc wander | None |
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
| Quick Navigation | |
|---|---|
| Usage | Installation · Frequently Asked Questions · Commands · Editors · Characters · API · |
| Configuration | Configuration · Text Syntax · Permissions · Waypoints · Data Storage |