Content generated with AI — it may contain mistakes.

Placeholders

Every placeholder the plugin answers, written in full, with what it reads inside and outside a run.

Page 15 of 253 min read

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%
Renamed after 1.0.1

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.

PlaceholderShowsExample
%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