Placeholders
AFKPlus placeholders for PlaceholderAPI, and what each one returns.
Install PlaceholderAPI, then restart. AFKPlus lists it as softdepend, so the server still starts if PlaceholderAPI is missing. When it is present, the console prints PlaceholderAPI hooked. The expansion id is afkplus and it stays registered across /papi reload.
| Placeholder | Needs a player | Returns |
|---|---|---|
%afkplus_balance% | yes | Shard balance. 0 if that player has no row. |
%afkplus_currency% | no | Currency.Name, default Shard. |
%afkplus_place% | yes | Leaderboard place, starting at 1. 0 if the player is not stored. |
%afkplus_in_zone% | yes | true or false. |
%afkplus_boost_seconds% | yes | Live wait multiplier. 1 when no seconds boost is running. |
%afkplus_boost_amount% | yes | Live payout multiplier. 1 when no amount boost is running. |
%afkplus_reward_seconds% | yes | Current AFK wait in seconds, after boosts. Empty if the player is offline. |
%afkplus_reward_amount% | yes | Current AFK payout, after boosts. Empty if the player is offline. |
A placeholder that needs a player is empty when PlaceholderAPI has no player, for example in a console-only parse. An unknown suffix is left unchanged.
These read the same values another plugin gets from AfkPlusApi. They do not give or take shards.
Suggestions
Put %afkplus_balance% and %afkplus_place% on a scoreboard only after a player has been paid once, so the place is not 0. For a hologram that another plugin fills itself, use leaderboard(10) on the API page instead of parsing placeholders.