Placeholders
PlaceholderAPI placeholders (%alphaevent_*%) for event state, the top three, the time left and per-player status.
Event status
| Placeholder | Returns |
|---|---|
%alphaevent_status% | IDLE if no event is running, otherwise the current state (ANNOUNCING, JOINING, WAITING, ROUND_STARTING, ROUND_ACTIVE, ROUND_ENDING, EVENT_ENDING) |
%alphaevent_running% | true / false |
%alphaevent_paused% | true / false |
%alphaevent_type% | Plain event name, e.g. TNT Run, or None |
%alphaevent_event% | The styled name from lang/messages.yml (small caps by default), or None |
%alphaevent_event_id% | The id, e.g. tntrun, or none |
%alphaevent_arena% | Name of the arena in use, or none |
%alphaevent_round% | Current round number, 0 if idle |
%alphaevent_total_rounds% | Configured total rounds, 0 if idle |
%alphaevent_countdown% | Current countdown value for whichever phase is active |
%alphaevent_time% | Time left in the live round as m:ss, or --:-- without a limit |
Players & points
| Placeholder | Returns |
|---|---|
%alphaevent_alive% | Alive participant count |
%alphaevent_dead% | Eliminated-so-far count |
%alphaevent_participants% | Total participants (excludes late spectators) |
%alphaevent_spectators% | Spectator count |
%alphaevent_max_players% | The running event's maximum (its own file, else settings.max-players) |
%alphaevent_min_players% | The running event's minimum |
Leaderboard
| Placeholder | Returns |
|---|---|
%alphaevent_first_place% / second_place / third_place | Player name at that rank, - if none |
%alphaevent_first_points% / second_points / third_points | Points at that rank, 0 if none |
Personal (requesting player)
| Placeholder | Returns |
|---|---|
%alphaevent_points% | The player's own event points, 0 if none |
%alphaevent_score% | The player's event score: kills, catches, checkpoints, hits... whatever the running event counts |
%alphaevent_rank% | Their rank among participants, - if not found |
%alphaevent_in_event% | true / false |
%alphaevent_is_alive% | true / false |
Arena in use
| Placeholder | Returns |
|---|---|
%alphaevent_spawn_region% | The arena's lobby region name, or not set |
%alphaevent_arena_region% | The arena's arena region name, or not set |
%alphaevent_spawn_count% | Number of spawn points in the arena |
The same ranking drives the final results, the placeholders and the rewards, so a scoreboard always matches what players see in chat.