PlaceholderAPI
With PlaceholderAPI installed and
placeholder.enabled: true in config.yml, Obfeco registers the obfeco expansion on start. No
eCloud download needed.
Replace <currency> with a currency id (dollars, gems) and <position> with a rank starting
at 1.
Player balances
| Placeholder | Returns | Example |
|---|---|---|
%obfeco_<currency>_balance% |
Formatted balance | $1.50k |
%obfeco_<currency>_raw% |
Plain number | 1500.00 |
%obfeco_<currency>_symbol% |
The currency's symbol | $ |
%obfeco_<currency>_name% |
The currency's display name | <gold>Dollars |
Same values, other spellings:
- Formatted:
%obfeco_<currency>_formatted%,%obfeco_<currency>_amount%,%obfeco_balance_<currency>%,%obfeco_amount_<currency>%,%obfeco_formatted_<currency>% - Raw:
%obfeco_<currency>%,%obfeco_<currency>_balance_raw%,%obfeco_<currency>_raw_balance%,%obfeco_raw_<currency>% - Name:
%obfeco_<currency>_displayname% - Symbol:
%obfeco_symbol_<currency>%
Leaderboards
| Placeholder | Returns |
|---|---|
%obfeco_<currency>_top_name_<position>% |
Player name at that rank |
%obfeco_<currency>_top_balance_<position>% |
Formatted balance at that rank |
%obfeco_<currency>_top_raw_<position>% |
Plain balance at that rank |
%obfeco_top_<position>_<currency>% |
Formatted balance at that rank (short form) |
%obfeco_top_<position>_<currency>_name% |
Player name at that rank (short form) |
Examples: %obfeco_dollars_top_name_1% is the richest player's name, %obfeco_top_1_dollars% is
their formatted balance.
Ranks 1–100 are available. Past the end of the list you get --- for a name and 0 for a balance.
player works in place of name, and value, formatted or amount in place of balance.
Economy totals
| Placeholder | Returns |
|---|---|
%obfeco_<currency>_total_balance% |
Formatted total of the currency across all players |
%obfeco_<currency>_total_raw% |
Plain total |
_total_formatted / _total_amount and _total / _total_balance_raw work too.
Notes
- Raw values use
formatting.decimal-placesdecimals, or no decimals for a currency withuse-decimals: false. They have no suffix or symbol, so they're the ones to use for math or conditions in other plugins. - Freshness: leaderboards and totals come from saved balances and are cached for
placeholder.top-cache-minutes. They update in the background and never slow a scoreboard down. See Leaderboards → How fresh is it?. - Offline players: balance placeholders work for offline players too; their balance is loaded in the background, so the first request may show the starting balance.
- Currency ids with underscores work (
event_tokens); the longest matching id is used.
Test any placeholder with /papi parse me %obfeco_dollars_balance%.