1.x/Commands and Permissions
< 1.x
Read below for detailed command documentation. For more info on per-type commands and permissions, see its corresponding page.
Admin Commands
[] - Mandatory
() - Optional
Command - command's syntax
Permission - command's permission node
Description - short description of the command
Command | Permission | Description |
---|---|---|
/citizens | citizens.admin.info | View general Citizens information |
/citizens debug | citizens.admin.debug | Toggle debug mode, if debug is on, debug messages will print to the console |
/citizens reload | citizens.admin.reload | Reload Citizens configuration files |
/citizens save | citizens.admin.save | Save Citizens files |
/citizens clean | citizens.admin.clean | Removes all "ghost" entities in your world |
General Commands
[] - 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
Permission - command's permission node
Description - short description of the command
Command | Args Description | Require Selected | Require Ownership | Permission | Description |
---|---|---|---|---|---|
/citizens help (page) | page - page to view | false | false | citizens.basic.use.help | View the help page for Citizens |
/npc help (page) | page - page to view | false | false | citizens.basic.use.help | View the help page for Citizens |
/npc create [name] (text) | name - name of NPC text - text that an NPC says when right-clicked with the talk-item |
false | false | citizens.basic.create | Create an NPC |
/npc move | None | true | true | citizens.basic.modify.move | Move an NPC to your location |
/npc moveTo [x y z] (world pitch yaw) | x y z - coordinates to teleport NPC to world - world to teleport an NPC to pitch - orientation of body yaw - orientation of head |
true | true | citizens.basic.modify.moveto | Move an NPC to the specified location |
/npc copy | None | true | true | citizens.basic.modify.copy | Copy an NPC to your location (you must also meet the NPC count guidelines, see citizens.npccount permissions in the Other Permissions section below) |
/npc remove (all) | all - Removes all NPCs | true (only for /npc remove) | true (only for /npc remove) | citizens.basic.modify.remove or citizens.basic.modify.remove.all for /npc remove all | Remove an NPC or all NPCs |
/npc rename | None | true | true | citizens.basic.modify.rename | Rename an NPC |
/npc color &[code] | code - Color code to change the name to | true | true | citizens.basic.modify.color | Color an NPC's nameplate |
/npc set [text] | text - Text to give to an NPC, split lines with tag |
true | true | citizens.basic.modify.settext | Set an NPC's text |
/npc add [text] | text - Text to add to an NPC, split lines with tag |
true | true | citizens.basic.modify.addtext | Add to an NPC's text |
/npc reset | None | true | true | citizens.basic.modify.resettext | Remove an NPC's text |
/npc item [item] | item - item to put in an NPC's hand, your inventory must contain at least one of this item | true | true | citizens.basic.modify.item | Set an NPC's item in-hand |
/npc armor [slot] [item] | slot - armor slot to change (available slots: helmet, torso, leggings, boots) item - item to set slot to, your inventory must contain at least one of this item |
true | true | citizens.basic.modify.armor | Modify an NPC's armor |
/npc tp | None | true | true | citizens.basic.use.teleport | Teleport to an NPC |
/npc talkclose | None | true | true | citizens.basic.modify.talkclose | Toggle whether an NPC will talk when a player comes near |
/npc lookat | None | true | true | citizens.basic.modify.lookat | Toggle whether an NPC will turn when a player comes near |
/npc select [id] | id - ID of the NPC to select | false | false | citizens.basic.use.select | Modify an NPC's armor |
/npc setowner [player-name] | player-name - name of player to set the owner to | true | true | citizens.basic.modify.setowner | Set the owner of an NPC |
/npc list (name) (page) | name - name of player to list NPCs of, leave blank to list your own NPCs page - page of list to view |
false | false | citizens.basic.use.list | List NPCs for yourself or another player |
Waypoint Commands
[] - 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
Permission - command's permission node
Description - short description of the command
Command | Args Description | Require Selected | Require Ownership | Permission | Description |
---|---|---|---|---|---|
/npc path | None | true | true | citizens.waypoints.edit | Start editing an NPC's waypoints |
/waypoints modifier [type] | type - modifier type to add to an NPC's waypoints | true | true | citizens.waypoints.modifer.(type) (replace type with the modifier type's name, see the Waypoints page for more info) | Add a modifier to an NPC's waypoints |
Toggle Commands
[] - 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
Permission - command's permission node
Description - short description of the command
Command | Args Description | Require Selected | Require Ownership | Permission | Description |
---|---|---|---|---|---|
/toggle help (page) | page - page number to view | false | false | citizens.toggle.help | View the available NPC types that you can toggle an NPC to become |
/toggle [type] | type - the type you want to toggle an NPC to become | true | true | citizens.toggle.(type) (replace type with the NPC type) | Toggle an NPC to become a type |
/toggle all [on/off] | on/off - whether to toggle all types on or off | true | true | citizens.toggle.all | Toggle all NPC types for an NPC |
Other Permissions
Permission - permission node
Description - description of permission node
Permission | Description |
---|---|
citizens.npccount.x | Number of NPC's that a player with this node can create; replace x with the number of NPCs you want a player to be able to create |
citizens.npccount.unlimited | Gives a player with this node the ability to create unlimited NPCs |