Content generated with AI — it may contain mistakes.

ExyliaEvents/ReferenceUpdated in v1.11.0

Placeholders

Show ExyliaEvents player counts, arena states, team colours, statistics and leaderboards on scoreboards, holograms and tab lists.

Page 16 of 252 min read

These show live ExyliaEvents data in other plugins that support PlaceholderAPI, such as holograms, tab lists and hub scoreboards. They need PlaceholderAPI installed. Click a placeholder to copy it.

PlaceholderShowsExample
%exyliaevents_total_players%Everyone inside active events, players and spectators.12
%exyliaevents_total_participants%Only the players, without spectators.9
%exyliaevents_total_spectators%Only the spectators.3
%exyliaevents_active%Events that are active, not counting disabled ones.2
%exyliaevents_waiting%Events you can join right now: waiting or counting down.1
%exyliaevents_in_progress%Events that are being played.1
%exyliaevents_status_bol_<event>%true when that event exists and is not disabled, false otherwise.true
%exyliaevents_state_<arena>%The state of that arena, here or on another server: Waiting, Starting, Playing, Ending or Disabled.Waiting
%exyliaevents_players_<pool>%Players in the games of an arena, an event type or a comma-separated list, on every server. 0 when none runs.7
%exyliaevents_max_players_<arena>%The player cap of that arena's game, or 0 when none runs.16
%exyliaevents_team_color%Colour code of the reader's team in a team event. Empty outside one.&c
%rel_exyliaevents_team_color%Colour code of the other player's team, for name tags and tab lists (needs a plugin that supports relational placeholders).&9
%exyliaevents_stats_kills%The reader's kills across every event.482
%exyliaevents_stats_deaths%The reader's deaths across every event.310
%exyliaevents_stats_wins%The reader's wins across every event.57
%exyliaevents_stats_games%The reader's games played across every event.140
%exyliaevents_stats_kdr%Kills over deaths, two decimals.1.55
%exyliaevents_stats_winrate%Wins over games played, one decimal and a percent sign.40.7%
%exyliaevents_event_stats_<stat>_<event>%The reader's counter for one event configuration. <stat> is kills, deaths, wins, games, kdr or winrate.12
%exyliaevents_stats_<type>_<stat>%The reader's counter for one minigame across all its arenas, such as %exyliaevents_stats_tnt_run_wins%. <stat> is kills, deaths, wins, games, kdr, winrate, fastestwin or bestround.3
%exyliaevents_top_name_<stat>_<position>%Name at that position of the all-time board. <stat> is kills, deaths, wins or games; position 1 to 10.Steve
%exyliaevents_top_value_<stat>_<position>%The number beside that name.482
%exyliaevents_event_top_name_<stat>_<position>_<event>%Name at that position of one event configuration's board.Alex
%exyliaevents_event_top_value_<stat>_<position>_<event>%The number beside that name.41
%exyliaevents_type_top_name_<stat>_<position>_<type>%Name at that position of one minigame's board across all its arenas. <stat> also accepts bestround.Alex
%exyliaevents_type_top_value_<stat>_<position>_<type>%The number beside that name.41

How to read the ids#

<event>, <arena> and <type> are the id you gave the configuration (such as koth) or the event type (such as tnt_run). Ids with underscores work as they are. <pool> takes what /events play takes: one arena, an event type for all its arenas, or a comma-separated list of both.

%exyliaevents_state_pillars_1%
%exyliaevents_players_pillarsoffortune%
%exyliaevents_event_stats_kills_koth%
%exyliaevents_event_top_name_wins_3_koth%

%exyliaevents_waiting% and %exyliaevents_in_progress% never overlap: an event counting down can be joined, one that is playing cannot.

The reader's team#

%exyliaevents_team_color% is the colour code of the team the reader belongs to in a team event (&c, &9, &a, &e), and empty for anyone not in one, so you can put it straight into a chat or tab format. %rel_exyliaevents_team_color% answers for the other player, the one whose name tag or tab entry is drawn, so a name tag plugin can colour each name by its owner's team.

Leaderboards#

Every board shows the top ten (<position> from 1 to 10). <stat> is kills, deaths, wins or games; kdr and winrate are worked out per player, so nothing can be ranked by them. A board is read at most once a minute and kept in memory between reads, so a hologram that refreshes every second costs nothing extra.

While a board or a statistic is still being read the placeholder shows -, and a position nobody has reached yet shows ---. Both fix themselves on the next refresh.

Statistics placeholders belong to the player who reads them. There is none for another player.

The plugin's own files use different tokens

The sidebars in scoreboards.yml and the boss bars in messages.yml are filled with tokens the running event provides, such as %time%, not with these. These placeholders are for other plugins to read the state of ExyliaEvents.

Something missing on this page? Tell us on Discord