1.x/Commands and Permissions

From Citizens Wiki

< 1.x

Revision as of 09:25, 26 August 2011 by APunch (talk | contribs)

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

Key

[] - Mandatory
() - Optional

Admin Commands

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

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

Toggle Commands

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
off] off - whether to toggle all types on or off true true citizens.toggle.all Toggle all NPC types for an NPC

Waypoint Commands

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