# PlaceholderAPI

ExcellentEconomy features built-in PlaceholderAPI integration. You do not need to install any additional expansions!

# 📋 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
`%coinsengine_balance_short_clean_[currency]%`	⚡ Short	⚡ Compact	❌
`%coinsengine_balance_short_legacy_[currency]%`	⚡ Short	⚡ Compact	`§`
`%coinsengine_balance_short_[currency]%`	⚡ Short	⚡ Compact	MiniMessage
`%coinsengine_balance_clean_[currency]%`	✔️ Normal	✔️ Rounded	❌
`%coinsengine_balance_legacy_[currency]%`	✔️ Normal	✔️ Rounded	`§`
`%coinsengine_balance_[currency]%`	✔️ Normal	✔️ Rounded	MiniMessage
`%coinsengine_balance_raw_[currency]%`	❌ None	❌ None	❌

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
`%coinsengine_server_balance_short_clean_[currency]%`	⚡ Short	⚡ Compact	❌
`%coinsengine_server_balance_short_legacy_[currency]%`	⚡ Short	⚡ Compact	`§`
`%coinsengine_server_balance_short_[currency]%`	⚡ Short	⚡ Compact	MiniMessage
`%coinsengine_server_balance_clean_[currency]%`	✔️ Normal	✔️ Rounded	❌
`%coinsengine_server_balance_legacy_[currency]%`	✔️ Normal	✔️ Rounded	`§`
`%coinsengine_server_balance_[currency]%`	✔️ Normal	✔️ Rounded	MiniMessage
`%coinsengine_server_balance_raw_[currency]%`	❌ None	❌ None	❌

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
`%coinsengine_top_balance_short_clean_[pos]_[currency]%`	⚡ Short	⚡ Compact	❌
`%coinsengine_top_balance_short_legacy_[pos]_[currency]%`	⚡ Short	⚡ Compact	`§`
`%coinsengine_top_balance_short_[pos]_[currency]%`	⚡ Short	⚡ Compact	MiniMessage
`%coinsengine_top_balance_clean_[pos]_[currency]%`	✔️ Normal	✔️ Rounded	❌
`%coinsengine_top_balance_legacy_[pos]_[currency]%`	✔️ Normal	✔️ Rounded	`§`
`%coinsengine_top_balance_[pos]_[currency]%`	✔️ Normal	✔️ Rounded	MiniMessage
`%coinsengine_top_balance_raw_[pos]_[currency]%`	❌ None	❌ None	❌

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).

%coinsengine_leaderboard_position_[currency]% - Shows the viewer's own rank.
%coinsengine_top_player_name_[pos]_[currency]% - Shows the name of the player at that rank.
%coinsengine_top_player_uuid_[pos]_[currency]% - Shows the UUID of the player at that rank.

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