Commands: Difference between revisions

From Citizens Wiki

No edit summary
Line 44: Line 44:
== NPC Commands ==
== NPC Commands ==
General commands used for all NPCs.
General commands used for all NPCs.
'''{{color|red|white|NOTE: '/npc trait' has been replaced, there is a new set of commands for adding, removing and copying traits. }}
:'''<code> /trait {traitname] </code> is now used to add traits and characters.
More docs coming soon.


{| class="wikitable collapsible" style="text-align: center; width: 100%"
{| class="wikitable collapsible" style="text-align: center; width: 100%"

Revision as of 22:34, 6 August 2012

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

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 Args Description 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

NPC Commands

General commands used for all NPCs.

NOTE: '/npc trait' has been replaced, there is a new set of commands for adding, removing and copying traits.

/trait {traitname] is now used to add traits and characters.

More docs coming soon.

NPC Commands
Command Args Description Require Selected Require Ownership Require Mob Types Permission Description
/npc None Yes Yes No None Show basic NPC information
/npc create ['NPC Name'] - Name to give NPC
(--type [type]) - Mob type to use
Yes Yes No citizens.npc.create Create a new NPC.

Example : /npc create 'Jimbo Stevenson' --type PIG

/npc list (-a) - List all NPCs
(--owner (owner)) - Owner
(--type (type)) - Mob type
(--char (character)) - Character
No No No citizens.npc.list List NPCs that match at least one of the given conditions
/npc despawn None Yes Yes No citizens.npc.despawn Despawn a NPC
/npc remove (all) - Will remove all NPCs Yes (Not if "all" is used) Yes No citizens.npc.remove(.all) Remove a NPC
/npc rename ['name'] - New name for the NPC Yes Yes No citizens.npc.rename Rename a NPC
/npc select [id] - ID of the NPC to select No Yes No citizens.npc.select Selects a NPC with the given ID
/npc trait [character] - Character to use Yes Yes No citizens.npc.trait.* or citizens.npc.trait.<character-name> for per-character permissions Adds the character type to the NPC. NPCs can have multiple character traits.

Example: /npc trait sentry

/npc owner (name) - Name of the new owner, set as "server" if you want Citizens Admins (players with "citizens.admin" permission) to be owner Yes Yes No citizens.npc.owner Sets the owner of a NPC
/npc spawn [id] - ID of the NPC you want to spawn Yes Yes No citizens.npc.spawn Spawn a existing NPC
/npc tphere None Yes Yes No citizens.npc.tphere Teleport a NPC to your location
/npc tp None Yes Yes No citizens.npc.tp Teleport to a NPC
/npc lookclose None Yes Yes No citizens.npc.lookclose Toggle a NPC's look-close state
/npc equip None Yes Yes Yes - PLAYER, PIG, SHEEP, ENDERMAN citizens.npc.edit.equip Toggle equipment editor
/npc path None Yes Yes No citizens.npc.edit.path Toggle path editor
/npc text None Yes Yes No citizens.npc.edit.text Toggle text editor
/npc power None Yes Yes Yes - CREEPER citizens.npc.power Toggle whether a creeper NPC is powered
/npc age baby|integer|-l] - Adult sets as adult, baby as baby, age integer specifies an exact age, -l toggles whether the age is locked Yes Yes Yes - COW, SHEEP, CHICKEN, PIG, VILLAGER, OCELOT, WOLF citizens.npc.age Modify a NPC's age

See Also

Characters
Text Syntax
Waypoints