Placeholders
AdvancedFFA ships with a built-in PlaceholderAPI (PAPI) expansion (%ffa_...%), allowing you to showcase player stats across scoreboards, tablists, chat formatters, and menus.
INFO
Requires PlaceholderAPI to be installed on your server.
Global Placeholders
These placeholders display lifetime statistics across all FFA arenas and kits combined:
| Placeholder | Description | Example Output |
|---|---|---|
%ffa_kills% | Total player kills | 142 |
%ffa_deaths% | Total player deaths | 38 |
%ffa_kdr% | Overall Kill/Death ratio | 3.74 |
%ffa_tokens% | Player's current token balance | 450 |
%ffa_killstreak% | Current active killstreak | 5 |
%ffa_highest_killstreak% | All-time highest killstreak | 18 |
%ffa_playtime% | Total playtime in FFA | 14h 23m 10s |
Per-Kit Placeholders
Track and display statistics tied to specific kits:
| Placeholder | Description | Example Output |
|---|---|---|
%ffa_kills_<kit>% | Kills scored using the specified kit | 96 |
%ffa_deaths_<kit>% | Deaths suffered while using the specified kit | 21 |
%ffa_playtime_<kit>% | Playtime recorded while using the specified kit | 8h 12m 45s |
Kit ID Matching
When using per-kit placeholders, replace <kit> with the lowercase ID of the kit (for example: %ffa_kills_nodebuff%, %ffa_playtime_gapple%).
In-Game Stats Command (/stats)
Players can check stats directly in chat using:
/stats [player]This sends a formatted breakdown showing:
- Overall Kills, Deaths, and KDR
- Tokens Balance
- Current Killstreak & Highest Killstreak
- Total Playtime
- Per-kit performance metrics for all kits the player has used
Permission required: advancedffa.stats (true by default).
Testing Your Placeholders
To test placeholders in-game via PlaceholderAPI:
/papi parse me %ffa_kills%
/papi parse me %ffa_tokens%
/papi parse me %ffa_killstreak%
/papi parse me %ffa_highest_killstreak%
/papi parse me %ffa_kills_nodebuff%