1.x/Commands and Permissions

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