Documentation & PlaceholderAPI

TokenEconomy features built-in support for PlaceholderAPI. You can display player token balances and top leaderboards anywhere on your server, including scoreboards, holograms, chat formats, and custom menus.

There is no need to download external expansions from the eCloud; the integration is completely native to the plugin.

Available Placeholders

Player Balances:
To display a player's current balance for a specific token, use the following format:
%token_balance_<currency>%
Example: %token_balance_mining%

Leaderboards:
To display the top players for a specific token, use these formats:
Player Name: %token_top_name_<position>_<currency>%
Player Balance: %token_top_bal_<position>_<currency>%
Example: %token_top_name_1_mining% (Returns the name of the #1 player)

Important Note on Currency Names:
To keep your configurations clean, you do not need to type "_tokens" at the end of the placeholder. The plugin will automatically detect it. Writing %token_balance_mining% works exactly the same as %token_balance_mining_tokens%.


Scoreboard Example

Because TokenEconomy allows you to create many different currencies, it is highly recommended to display them to your players so they can track their progress.

Below is an example of a "Portfolio" setup for a scoreboard plugin. This example displays multiple balances in a compact and clean way.