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. If this system is enabled, all tools/armor will only track statistics once a token is applied to it. There are different tokens for different statistics.

However, origin of items will be tracked still. You can disable this in the enabled section of the config.

Warning

The plugin supports swapping between regular and token system. You can toggle it off/on without any issue, as the plugin tries to make sure it accounts swapping between modes. However, it's not fully tested but I have tried my best to support it without issue.

Setup

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

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