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-places decimals, or no decimals for a currency with use-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%.