Denizen/0.7/Replaceables

From Citizens Wiki

< Denizen‎ | 0.7

Revision as of 23:45, 30 September 2012 by Davidcernat (talk | contribs) (→‎Chat Input Replaceable: Clarified description.)

Replaceable data tags can be used to dynamically put flags and values inside texts and commands.

Flag Replaceables

<FLAG.PLAYER:Name:fallback> or <FLAG.P:Name:fallback>

The value of a FLAG set on the Player, with the optional 'fallback' being the value used if the FLAG isn't found.

<FLAG.DENIZEN:Name:fallback> or <FLAG.D:Name:fallback>

The value of a FLAG set on the Denizen, with the optional 'fallback' being the value used if the FLAG isn't found.

<FLAG.GLOBAL:Name:fallback> or <FLAG.G:Name:fallback>

The value of a FLAG set globally, with the optional 'fallback' being the value used if the FLAG isn't found.

Chat Input Replaceable

<*>

Contains the Player's input after a Chat Trigger from the Current Step. Unlike other replaceables, it can currently only be used in Speech commands and the FLAG command.

Player Replaceables

<DISPLAYNAME>

The display name of the Player interacting with the Denizen, i.e. the name including colors.

<PLAYER> or <PLAYER.NAME>

The name of the Player.

<PLAYER.EXP>

The Player's total experience.

<PLAYER.BOOTS>

The MATERIAL of the boots that the Player is wearing. Is 'FALSE' if the Player is not wearing any.

<PLAYER.CHESTPLATE>

The MATERIAL of the chestplate that the Player is wearing. Is 'FALSE' if the Player is not wearing any.

<PLAYER.EXP_TO_NEXT_LEVEL>

The experience the Player must gain to reach the next level.

<PLAYER.FOOD_LEVEL>

The Player's food level, from 0 to 20.

<PLAYER.HEALTH>

The Player's health, from 0 to 20.

<PLAYER.HELM>

The MATERIAL of the helm that the Player is wearing. Is 'FALSE' if the Player is not wearing any.

<PLAYER.ITEM_IN_HAND.ID>

The ID of the item in the Player's hand. Is '0' if the Player's hand is empty.

<PLAYER.ITEM_IN_HAND.MATERIAL>

The MATERIAL of the item in the Player's hand. Is 'AIR' if the Player's hand is empty.

<PLAYER.ITEM_IN_HAND.NAME>

The name of the item in the Player's hand. Doesn't work at the moment.

<PLAYER.ITEM_IN_HAND.QTY>

The quantity of the item in the Player's hand.

<PLAYER.KILLER>

The name of the last killer of this Player. Doesn't work at the moment.

<PLAYER.LEGGINGS>

The MATERIAL of the leggings that the Player is wearing. Is 'FALSE' if the Player is not wearing any.

<PLAYER.MONEY>

The amount of money that the Player has. This replaceable will only work if you have Vault installed and a compatible permissions/economy plugin.

<PLAYER.WORLD>

The name of the world the Player is in.

Denizen Replaceables

<NPC> or <DENIZEN.NAME>

The name of the Denizen.

<NPCID> or <DENIZEN.NPCID>

The ID of the Denizen.