Placeholders

PlaceholderAPI

PlaceholderAPI is a soft dependency, used only for exposing live data to scoreboards, tab lists, holograms, and similar. If PlaceholderAPI is not installed, Exchequer's other functionality is unaffected.

Available Placeholders

Placeholder	Description
%exchequer_balance_%	The viewing player's ledger balance for the given material
%exchequer_price_%	Current live spot rate for the given material
%exchequer_gdp%	The viewing player's nation GDP (or personal GDP if Towny isn't installed)
%exchequer_gdp_rank%	The viewing player's nation rank on the GDP leaderboard
%exchequer_vault_capacity%	The viewing player's current vault capacity tier limit
%exchequer_vault_used%	The viewing player's current total ledger value against their capacity
%exchequer_tax_rate%	The current effective tax rate for the viewing player, accounting for their nation's governance modifier if applicable
%exchequer_specialization%	The viewing player's nation's current industry specialization, if any

Example Usage

A scoreboard line showing gold balance and current GDP rank:

Gold: %exchequer_balance_gold_ingot%
GDP Rank: #%exchequer_gdp_rank%

Notes

Material specific placeholders use the same material identifier format as commands, lowercase with underscores (iron_ingot, gold_ingot, emerald). If you rename a material's display name in config.yml, the placeholder identifier itself does not change, only what's shown to players in GUIs and chat.