Have you ever wanted to reward you players when they do something such as kill a mob, a player or for earning a hard-to-get achievement?
If so then this is the plugin for you!
eTokens is based a a fairly advanced system that will allow you to o just that!
With this plugin comes a default, easy to configure, XML file that allows you, the server owner, to automatically reward players.
The XML is really easy to grasp. All you need to do is add a "token" tab and tell it what you want to do.
Below are some example and what attribute means what.
<!-- This token is rewarded when the player breaks 10 diamond_ore blocks, they are given 10 tokens and sent the message -->
<token block-amount="10" block-type="DIAMOND_ORE" objective="block-break" token-amount="10">Well done {PLAYER}, have received {TOKEN-AMOUNT} token(s) for breaking {BLOCK-AMOUNT} {BLOCK-TYPE} block(s)!</token>
<!-- This token is rewarded when the player earns the achievement "BUILD_PICK". They are given 10 tokens -->
<token achievement="BUILD_PICKAXE" objective="achievement" token-amount="10">You have received {TOKEN-AMOUNT} tokens for getting the achievement {ACHIEVEMENT}!</token>
<!-- This token is rewarded when the player kills 10 zombies. This rewards them with 10 tokens.
This also has the "repeatable" attribute which means that the user can complete this for as many times as they want -->
<token entity-type="ZOMBIE" kills="10" objective="kill" repeatable="true" token-amount="10">You have received {TOKEN-AMOUNT} tokens for killing {KILLS} {ENTITY-TYPE}(s)!</token>| XML Attribute | What it does | Values |
|---|---|---|
| objective | This sets the objective that the player needs to complete in order to receive the token | block-break, kill, achievement |
| token-amount | This is the amount of tokens you want to reward the player with | Any number between 0 and 2147483647 |
| block-amount | This should only be used with the "block-break" objectives, this is how many blocks the player needs to break | Any number between 0 and 2147483647 |
| block-type | The type of block that the user needs to break | See Here |
| achievement | This should only be used with the "achievement" objective. This is the name of the achievement that the user needs to get | See here |
| entity-type | This should only be used with the "kills" objective. This is the type of mob that the player needs to kill | See Here |
| kills | The amount of entities the player needs to kill | Any number between 0 and 2147483647 |
| repeatable | States whether an objective can be repeated by the player (Currently only works with kills and block-break) | true or false |
The commands that come with this plugin allow you to control how many tokens each player has.
| Command | Description |
|---|---|
| /token add | Add a specified amount of tokens to the players' account |
| /token remove | Remove specified tokens to this players' account |
| /token set | Set this players token count |
| /tokens give | Give this player some of your tokens |
| /shop create | Create a shop with the specified name (Case sensitive) |
| /shop add | Add the currently held item to the specified shop |
| /shop | Open a specified shop (Typing in a wrong shop will show available shops) |
All commands (Even the /shop) need a permission node before the user can execute it. You can find these permissions and their corresponding commands below
| Permission | Command |
|---|---|
| etokens.admin | /token add |
| etokens.admin | /token remove |
| etokens.admin | /token set |
| etokens.give | /token give |
| etokens.shop.create | /shop create |
| etokens.shop.create | /shop add |
| etokens.shop.create | /shop command |
| etokens.shop. | This will give the player permission to open the specified shop |