Skip to content
This repository has been archived by the owner. It is now read-only.
Bukkit plugin that rewards players with "Tokens"
Java
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.settings
src/ovh/tgrhavoc/etokens
.classpath
.gitignore
.project
LICENSE
README.md
plugin.yml

README.md

eTokens

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

Commands:

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
You can’t perform that action at this time.