-
Notifications
You must be signed in to change notification settings - Fork 0
PlaceholderAPI & TAB
AFK Area integrates optionally with PlaceholderAPI and TAB.
Neither is required for the core AFK area system.
When PlaceholderAPI is installed and enabled, AFK Area registers the afkarea expansion automatically.
No separate expansion download is required.
| Placeholder | Description |
|---|---|
%afkarea_state% |
active, afk or afk_area
|
%afkarea_is_afk% |
Whether the player is AFK |
%afkarea_tab_suffix% |
Configured AFK/AFK-area tab suffix |
%afkarea_idle_seconds% |
Current idle duration in seconds |
%afkarea_area_id% |
Current AFK area ID |
%afkarea_area_name% |
Current AFK area display name |
%afkarea_session_seconds% |
Current AFK area session duration |
%afkarea_stats_session_count% |
Completed session count |
%afkarea_stats_total_seconds% |
Total completed AFK area time |
%afkarea_stats_last_session_seconds% |
Last session duration |
%afkarea_stats_longest_session_seconds% |
Longest session |
%afkarea_stats_last_area_id% |
Last AFK area ID |
%afkarea_stats_last_session_end_epoch_millis% |
Last session end epoch milliseconds |
AFK Area applies its native player-list marker using:
tab.afk-format
tab.afk-area-format
from messages.yml.
The previous player-list name is preserved and restored when the marker is removed.
When TAB is detected, native AFK tab markers are disabled.
Use:
%afkarea_tab_suffix%
inside TAB instead.
This avoids both plugins competing over the player-list name.
If TAB is present but PlaceholderAPI is not available, native markers remain disabled and AFK Area logs a warning.
Install PlaceholderAPI when using %afkarea_tab_suffix%.
%player% %afkarea_tab_suffix%
The exact TAB syntax depends on your TAB configuration.
If placeholders are not replaced:
- Confirm PlaceholderAPI is enabled.
- Check for the integration message in console.
- Test
%afkarea_state%. - Confirm the receiving plugin supports PlaceholderAPI.
- Restart after adding PlaceholderAPI to an existing server.
See Troubleshooting.
AFK Area Wiki
Setup
Administration
Integrations & Storage
Help