Skip to content

Token System

hyperdefined edited this page Jan 26, 2025 · 13 revisions

The token system is a way for players to add stats to items they want. Players either craft or are given a token to add to an item. Once added, that tool will track that given statistic. Once this system is on, all stats will be turned off unless the player's tool/armor has a token applied.

Setup

To enable, set tokens.enabled true in your config. I recommend setting up the tokens section before using on your server.

Caution

It's recommended to either keep this enabled or disabled. Changing the setting can break the plugin's functions. I recommend deciding what you want first, then installing. Installing on an existing world is fine, but decide if you want it disabled/enabled first. Changing it afterwards can lead to items not tracking or breaking.

Obtaining Tokens

Tokens be obtained by being crafted or given via commands. By default, tokens can be crafted. If you want to disable this, set craft-tokens to false in your config. Below are the crafting recipes.

If you want to use commands, you can use /toolstats givetokens <player> <token-type>. You can specify more than one by using /toolstats givetokens <player> <token-type> <amount>. Requires toolstats.givetokens permission.

Blocks Mined Player Kills Mob Kills
blocks-mined player-kills mob-kills
Crops Mined Sheep Sheared Fish Caught
crops-mined sheep-sheared fish-caught
Flight Time Arrows Shot Damage Taken
flight-time arrows-shot damage-taken

Using Tokens

To use a token, simply apply it in an anvil like below. You can configure how many levels it takes for each in the config. anvil

Reset Token

There is a special reset token, which will reset the tracked stats of an item. This does NOT remove the tokens on the item, but sets the values to zero. This also does not remove the origin of the item (crafted, traded, etc).

Apply it like any other token.

reset-token

Clone this wiki locally