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	None	true	false	citizens.basic.use.info	View information on the selected NPC
/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 equip	None	true	true	citizens.basic.modify.equip	Enter equipment-edit mode
/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
citizens.admin.override.setowner	Grants ability to override the requirement of being the owner of an NPC to change its owner
citizens.admin.override.remove	Grants ability to override the requirement of being the owner of an NPC to remove it
citizens.admin.notifyupdates	If the citizens.yml setting notify-updates is true, any player with this node will be notified of Citizens updates upon logging on to the server