Placeholders
PlaceholderAPI values provided by XenoTokens through the %xtk_*% expansion.
XenoTokens registers the %xtk_*% PlaceholderAPI expansion. It can work against the default currency or a specific currency prefix.
Currency selector syntax
Use the default currency:
%xtk_balance%%xtk_balance_formatted%
Target a specific currency:
%xtk_main_balance%%xtk_main_balance_formatted%%xtk_custom_token_range%
The prefix can be the currency ID or a resolved alias.
Currency metadata
| Placeholder | Description |
|---|---|
%xtk_currency_name_single% | Singular name of the current currency context |
%xtk_currency_name_plural% | Plural name of the current currency context |
%xtk_currency_symbol% | Symbol of the current currency context |
%xtk_token_system% | Representation system label from currency.yml |
Balance and history
| Placeholder | Description |
|---|---|
%xtk_balance% or %xtk_player_balance% | Raw numeric balance |
%xtk_balance_formatted% or %xtk_player_balance_formatted% | Formatted balance using the currency formatter |
%xtk_token_range% or %xtk_player_token_range% | Resolved balance range label |
%xtk_top_position% or %xtk_player_top_position% | Leaderboard position in that currency |
%xtk_transactions_count% or %xtk_player_transactions_count% | Stored transaction count in that currency |
%xtk_last_transaction% or %xtk_player_last_transaction% | Last transaction ID |
%xtk_last_type% or %xtk_player_last_type% | Last transaction type label |
%xtk_last_reason% or %xtk_player_last_reason% | Last transaction reason |
%xtk_last_sender% or %xtk_player_last_sender% | Sender on the last transaction |
%xtk_last_amount% or %xtk_player_last_amount% | Raw amount from the last transaction |
Default values
When the player is missing or there is not enough history yet:
- numeric placeholders fall back to the configured zero value
- sender/type placeholders use the configured
nonetext - token range resolves from zero balance
Per-currency display
The most useful pattern on multi-currency servers is to mix a currency prefix with formatted values, for example %xtk_main_balance_formatted% or %xtk_main_token_range%.
Commands & Permissions
Review the public and admin command surface of XenoTokens.
Currencies & Ranges
Understand the global registry, per-currency folders, aliases, and token representation ranges.
Last updated on