PlaceholderAPI

PlaceholderAPI

If PlaceholderAPI is installed, RoyalBank registers an expansion under the royalbank identifier automatically. Use these anywhere PlaceholderAPI is supported — scoreboards, chat formats, holograms, tab lists, and other plugins.

These %percent% placeholders are for other plugins. Inside RoyalBank's own menus you use the {curly} GUI tokens instead — see GUI Customization.

Placeholders

Placeholder	Value
%royalbank_balance%	Bank balance, formatted (with symbol/abbreviation)
%royalbank_balance_raw%	Bank balance, raw number
%royalbank_max_balance%	Tier max balance, formatted
%royalbank_max_balance_raw%	Tier max balance, raw number
%royalbank_bank_space%	Remaining bank room, formatted
%royalbank_bank_space_raw%	Remaining bank room, raw number
%royalbank_combined_balance%	Bank + purse, formatted
%royalbank_level%	Account tier number
%royalbank_level_name%	Account tier display name
%royalbank_max_interest%	Interest cap for the current tier
%royalbank_next_interest%	Next interest amount, formatted
%royalbank_next_interest_raw%	Next interest amount, raw number
%royalbank_interest_time%	Time remaining until interest can be claimed

Formatted vs raw

• Formatted placeholders use your currency-symbol and RoyalBank's number formatting (e.g. $1.5M) — best for display.
• _raw placeholders return the bare number (e.g. 1500000.0) — best when another plugin needs to do math or comparisons on the value.

Example uses

Scoreboard line

&7Bank: &6%royalbank_balance%
&7Tier: &e%royalbank_level_name%

Chat prefix (via a chat plugin)

[%royalbank_level_name%] %player_name%: ...

Conditional (via a plugin that supports comparisons) — using the raw value so the comparison is numeric:

%royalbank_bank_space_raw%

Not showing up?

• Confirm PlaceholderAPI is installed and RoyalBank enabled after it (check /papi list for royalbank).
• Placeholders resolve per player — they need a player context. A console or global context returns empty.
• If you just installed PlaceholderAPI, restart once so the expansion registers cleanly.