Placeholders
Every placeholder the plugin answers, written in full, with what it reads inside and outside a run.
Every placeholder below is written in full, and clicking one copies it.
How the name is written#
A placeholder is the plugin name followed by the placeholder's own name, written the same way
everywhere: through PlaceholderAPI, and inside the plugin's own files — scoreboards.yml, menus/,
messages.yml.
%exyliaaimtrainer_wins%Up to v1.0.1 every name carried the group aim: %exyliaaimtrainer_aim_wins% through PlaceholderAPI
and %aim_wins% inside the plugin's files. Neither form resolves any more. Write
%exyliaaimtrainer_<name>%, and update a scoreboards.yml or menus/main.yml already generated on the
server.
Every placeholder resolves for the player looking at it. Most answer something whatever the moment: 0,
or — (the menu.none text in messages.yml) where a number or a name does not apply. The exceptions
are noted in their rows.
A run, a session, a duel#
Three words matter in the list below.
- A run is one drill being played, from the first live target to the end. It does not exist during the countdown, while resting after a drill, or between two rounds of a duel. In a duel, each round is a run.
- A session is the whole solo stay in the arena: countdown, run, rest and every replay.
- A duel is the whole series, from the teleport to the result.
Lifetime numbers (rating, hits, shots) are those of the edition the viewer is on: Bedrock totals for a Bedrock player, Java otherwise. Until the profile has loaded after joining they answer 0, or — for times. The live-or-lifetime ones (hits, misses, shots, accuracy) mean the running run while there is one and the lifetime profile otherwise.
| Placeholder | Shows | Example |
|---|---|---|
%exyliaaimtrainer_total_rating% | The overall rating on the viewer's edition: the sum of the player's best rating in every drill. | 9120 |
%exyliaaimtrainer_sessions% | Solo runs stored. | 42 |
%exyliaaimtrainer_total_hits% | Lifetime hits, solo runs and duels. | 1520 |
%exyliaaimtrainer_total_shots% | Lifetime shots (hits plus misses), solo runs and duels. | 1800 |
%exyliaaimtrainer_best_flick% | The fastest time between two hits ever. Shows — when there is none. | 183ms |
%exyliaaimtrainer_best_reaction% | The fastest reaction ever. Shows — when there is none. | 201ms |
%exyliaaimtrainer_wins% | Duels won. | 12 |
%exyliaaimtrainer_losses% | Duels lost. | 7 |
%exyliaaimtrainer_winrate% | Wins over duels played, with a % sign. | 63% |
%exyliaaimtrainer_win_streak% | Duels won in a row right now. | 3 |
%exyliaaimtrainer_best_win_streak% | Best run of duels won in a row. | 5 |
%exyliaaimtrainer_hits% | Hits of the running run; lifetime hits outside one. | 96 |
%exyliaaimtrainer_misses% | Misses of the running run; lifetime shots minus hits outside one. | 8 |
%exyliaaimtrainer_shots% | Hits plus misses of the running run; lifetime shots outside one. | 104 |
%exyliaaimtrainer_accuracy% | Accuracy of the running run (time on target in a tracking drill), or lifetime accuracy outside one. One decimal and no % sign. | 87.5 |
%exyliaaimtrainer_score% | The live score. 0 outside a run. | 950 |
%exyliaaimtrainer_rating% | The live score times the difficulty. | 1284 |
%exyliaaimtrainer_streak% | Hits in a row. A miss, an expired target or a false start ends it. | 12 |
%exyliaaimtrainer_best_streak% | The longest streak of this run. | 41 |
%exyliaaimtrainer_combo% | The current combo, in a combo drill. | 4 |
%exyliaaimtrainer_best_combo% | The longest combo of this run. | 12 |
%exyliaaimtrainer_time_left% | Seconds left, rounded up. In a reaction drill, what is left of its cap. | 1:30 |
%exyliaaimtrainer_targets_left% | Lights still to answer in a reaction drill; 0 in any other. | 7 |
%exyliaaimtrainer_grade% | The grade of the last graded hit (Perfect, Excellent, Good, Ok or Slow, in your menu.grades words). — before the first. | Perfect |
%exyliaaimtrainer_avg_flick% | Average time between two hits. — before the second hit. | 312ms |
%exyliaaimtrainer_avg_reaction% | Average reaction. — before the first. | 245ms |
%exyliaaimtrainer_on_target% | Percent of the run spent on target in a tracking drill. One decimal, no sign. | 64.2 |
%exyliaaimtrainer_precision% | How central the hits were, as a percent. One decimal, no sign. | 78.0 |
%exyliaaimtrainer_ping% | The ping the run last measured. Outside a run, the player's current ping. | 42 |
%exyliaaimtrainer_state% | none, training or match. | training |
%exyliaaimtrainer_state_label% | The same in the words of menu.state-none, state-training and state-match: None, Drill, Duel. | Drill |
%exyliaaimtrainer_phase% | In a solo session: countdown, running or resting. none outside one, and during a duel. | running |
%exyliaaimtrainer_drill% | Display name of the drill of the session or duel. — outside both. | Gridshot |
%exyliaaimtrainer_drill_id% | The drill id from config.yml. Empty outside a session or duel. | gridshot |
%exyliaaimtrainer_kind% | The drill's kind (Flicking, Reaction, Tracking, Combo). — outside. | Flicking |
%exyliaaimtrainer_difficulty% | The difficulty multiplier of the session or duel, two decimals. 1.00 outside. | 1.35 |
%exyliaaimtrainer_format% | The series length. — outside a duel. | BO3 |
%exyliaaimtrainer_opponent% | The opponent's name. — outside a duel. | Steve |
%exyliaaimtrainer_opponent_score% | The opponent's live score this round; 0 between rounds and outside a duel. | 840 |
%exyliaaimtrainer_opponent_hits% | The opponent's hits this round; 0 between rounds and outside a duel. | 31 |
%exyliaaimtrainer_round% | The round being played. 0 outside a duel. | 2 |
%exyliaaimtrainer_series% | Rounds won, yours first. 0 - 0 outside a duel. | 2 - 1 |
%exyliaaimtrainer_match_state% | waiting, starting, active, round_end, ending or finished. none outside a duel. | active |
%exyliaaimtrainer_training_count% | Players in a solo session, in any phase. Needs no viewer, so a lobby hologram can show it. | 5 |
%exyliaaimtrainer_match_count% | Players in a duel (one duel counts 2). Finished duels no longer count. | 4 |
%exyliaaimtrainer_playing_count% | Every player in a drill or a duel. | 9 |
%exyliaaimtrainer_top_<drill>_rating_<n>% | Name of the player at position n on the drill's board. Sorted by: Best rating, highest first. | Steve |
%exyliaaimtrainer_top_<drill>_rating_<n>_value% | The number that put that player there. | 1284 |
%exyliaaimtrainer_top_<drill>_score_<n>% | Name of the player at position n on the drill's board. Sorted by: Best score, highest first. | Steve |
%exyliaaimtrainer_top_<drill>_score_<n>_value% | The number that put that player there. | 950 |
%exyliaaimtrainer_top_<drill>_accuracy_<n>% | Name of the player at position n on the drill's board. Sorted by: Best accuracy, highest first. | Steve |
%exyliaaimtrainer_top_<drill>_accuracy_<n>_value% | The number that put that player there. | 92.4% |
%exyliaaimtrainer_top_<drill>_streak_<n>% | Name of the player at position n on the drill's board. Sorted by: Longest streak, highest first. | Steve |
%exyliaaimtrainer_top_<drill>_streak_<n>_value% | The number that put that player there. | 41 |
%exyliaaimtrainer_top_<drill>_hits_<n>% | Name of the player at position n on the drill's board. Sorted by: Most hits in one run, highest first. | Steve |
%exyliaaimtrainer_top_<drill>_hits_<n>_value% | The number that put that player there. | 96 |
%exyliaaimtrainer_top_<drill>_reaction_<n>% | Name of the player at position n on the drill's board. Sorted by: Fastest single reaction, lowest first. | Steve |
%exyliaaimtrainer_top_<drill>_reaction_<n>_value% | The number that put that player there. | 178ms |
%exyliaaimtrainer_top_<drill>_combo_<n>% | Name of the player at position n on the drill's board. Sorted by: Longest combo, highest first. | Steve |
%exyliaaimtrainer_top_<drill>_combo_<n>_value% | The number that put that player there. | 12 |
%exyliaaimtrainer_top_overall_rating_<n>% | Name at position n on the overall board, sorted by overall rating. | Steve |
%exyliaaimtrainer_top_overall_rating_<n>_value% | Their overall rating. | 9120 |
%exyliaaimtrainer_top_overall_accuracy_<n>% | Name at position n on the overall board, sorted by lifetime accuracy. | Steve |
%exyliaaimtrainer_top_overall_accuracy_<n>_value% | Their lifetime accuracy. | 81.3% |
%exyliaaimtrainer_top_bedrock_<drill>_<category>_<n>% | The same board on Bedrock. Add _value for the number. Every board without bedrock_ is the Java one (java_ is accepted). | Alex |
Leaderboards#
A board is about one drill and sorted by one category, and both go in the name. Every board placeholder
comes in two forms: the plain one answers the name of the player at position n, and the one ending in
_value the number that put them there.
<drill> is a drill id from config.yml — in the file the plugin ships: gridshot, scatter,
sixshot, microshot, spidershot, flick, flick_180, flick_360, precision, decay, switch, strafe, reaction,
tracking, evasive, combo, combo_19 and axe — and <n> is the position, counting from 1.
The overall board goes in place of a drill as overall, and sorts by two categories only, rating and accuracy.
Any other category written after overall reads the rating board.
Java and Bedrock boards#
Every board above is the Java one. Write bedrock_ before the drill for the same board on Bedrock,
and java_ to say Java out loud; both work with overall too. They are the top_bedrock_ and top_java_ rows in the list above.
An edition word is only read as one when no drill is named by it, so a drill you call bedrock_… is
still matched as a drill.
Written out, with a drill and a position in place:
%exyliaaimtrainer_top_gridshot_rating_1%
%exyliaaimtrainer_top_gridshot_rating_1_value%
%exyliaaimtrainer_top_reaction_reaction_3_value%
%exyliaaimtrainer_top_combo_19_combo_1%
%exyliaaimtrainer_top_overall_rating_1_value%
%exyliaaimtrainer_top_bedrock_gridshot_rating_1%
%exyliaaimtrainer_top_bedrock_overall_rating_1_value%A drill id with underscores in it is matched whole, longest id first:
%exyliaaimtrainer_top_combo_19_combo_1% is the combo board of combo_19, not something about
combo. Until a board has been read once, both forms answer the menu.loading text, Loading…, and
kick the read off; after that they keep showing the last board read while a newer one loads. A position
past the end of the board, an unknown drill, an unknown category or a position that is not a number
leaves the text unchanged. See Statistics for how a board is built and
how long it is cached.
Something missing on this page? Tell us on Discord