PlaceholderAPI

ExcellentEconomy features built-in PlaceholderAPI expansion.

Available Placeholders

In the examples below, replace [currency] with your specific Currency ID.

These placeholders show the current balance of a specific player.

Placeholder	Currency Format	Number Format	Text Format
`%excellenteconomy_balance_short_clean_[currency]%`	Short	Compact
`%excellenteconomy_balance_short_legacy_[currency]%`	Short	Compact	`§`
`%excellenteconomy_balance_short_[currency]%`	Short	Compact	MiniMessage
`%excellenteconomy_balance_clean_[currency]%`	Normal	Rounded
`%excellenteconomy_balance_legacy_[currency]%`	Normal	Rounded	`§`
`%excellenteconomy_balance_[currency]%`	Normal	Rounded	MiniMessage
`%excellenteconomy_balance_raw_[currency]%`	Raw	Raw

These placeholders show the total wealth of all players on the server combined.

You must enable the Leaderboards for these placeholders to function.

Placeholder	Currency Format	Number Format	Text Format
`%excellenteconomy_server_balance_short_clean_[currency]%`	Short	Compact
`%excellenteconomy_server_balance_short_legacy_[currency]%`	Short	Compact	`§`
`%excellenteconomy_server_balance_short_[currency]%`	Short	Compact	MiniMessage
`%excellenteconomy_server_balance_clean_[currency]%`	Normal	Rounded
`%excellenteconomy_server_balance_legacy_[currency]%`	Normal	Rounded	`§`
`%excellenteconomy_server_balance_[currency]%`	Normal	Rounded	MiniMessage
`%excellenteconomy_server_balance_raw_[currency]%`	Raw	Raw

These placeholders show the last updated balance of a specific rank.

You must enable the Leaderboards for these placeholders to function.

Replace [pos] with the numerical rank in the leaderboard (e.g., 1 for the top player).

Placeholder	Currency Format	Number Format	Text Format
`%excellenteconomy_top_balance_short_clean_[pos]_[currency]%`	Short	Compact
`%excellenteconomy_top_balance_short_legacy_[pos]_[currency]%`	Short	Compact	`§`
`%excellenteconomy_top_balance_short_[pos]_[currency]%`	Short	Compact	MiniMessage
`%excellenteconomy_top_balance_clean_[pos]_[currency]%`	Normal	Rounded
`%excellenteconomy_top_balance_legacy_[pos]_[currency]%`	Normal	Rounded	`§`
`%excellenteconomy_top_balance_[pos]_[currency]%`	Normal	Rounded	MiniMessage
`%excellenteconomy_top_balance_raw_[pos]_[currency]%`	Raw	Raw

Display rankings and top player information.

You must enable the Leaderboards for these placeholders to function.

Replace [pos] with the numerical rank in the leaderboard (e.g., 1 for the top player).

%excellenteconomy_leaderboard_position_[currency]% - Shows the viewer's own rank.
%excellenteconomy_top_player_name_[pos]_[currency]% - Shows the name of the player at that rank.
%excellenteconomy_top_player_uuid_[pos]_[currency]% - Shows the UUID of the player at that rank.

%excellenteconomy_payments_state_[currency]% - Displays the player's current payment status (e.g., if they have toggled payments off).