Content generated with AI — it may contain mistakes.

ExyliaTotemTrainer/GuidesUpdated in v1.2.0

Tune the grading

Change how fast a reaction must be for Perfect, how the 0-100 score works and what players see and hear on every pop.

Page 7 of 237 min read

Every re-equip is timed from the hit to the moment a totem is back in a hand, and graded against thresholds in performance. A session's grades and fails become a score from 0 to 100, which is what the rating leaderboard ranks by, weighted by the speed it was set at. What each grade looks and sounds like is feedback, in messages.yml.

Before you start#

Thresholds live in plugins/ExyliaTotemTrainer/config.yml, the feedback in plugins/ExyliaTotemTrainer/lang/<language>/messages.yml. After a change run /totemtraineradmin reload; no restart is needed. Colour tokens such as {success} are explained on Colours.

The grades#

GradeDefault thresholdPoints
PERFECT0.25 s100
EXCELLENT0.40 s85
GOOD0.60 s70
OK0.90 s50
SLOWanything slower than ok25

A threshold is the slowest reaction, in seconds, that still earns the grade, inclusive: a reaction of exactly 0.25 s is PERFECT.

plugins/ExyliaTotemTrainer/config.yml
yaml
performance:
  defaults:
    perfect: 0.25
    excellent: 0.40
    good: 0.60
    ok: 0.90
  by-ticks: {}
  by-mode: {}
  points:
    perfect: 100
    excellent: 85
    good: 70
    ok: 50
    slow: 25
  fail-penalty: 15
  full-credit-pops: 20
  speed-weights:
    "25": 0.8
    "20": 1.0
    "15": 1.5
    "10": 2.5
    "5": 5.0
  reference-ticks: 20

Thresholds per speed and per mode#

The thresholds a session uses are resolved once when it starts, most specific first:

  1. by-ticks.<ticks> — the tick interval, written as a string key such as "10".
  2. by-mode.<modeId> — the mode id.
  3. defaults.

Both override maps ship empty: a reaction is graded against one standard at every speed, and how hard a speed is lives in speed-weights instead (see the rating). Grading a fast interval harder here as well would charge a player twice for picking it. A mode entry is checked only when no entry matches the speed, so a by-ticks block always wins over a by-mode block.

The score#

The score of a session, a round or a whole duel is:

  1. The mean of the points of every pop's grade.
  2. While the session has fewer pops than full-credit-pops, the mean is scaled by pops / full-credit-pops. A full session is untouched; full-credit-pops: 0 turns the scaling off.
  3. Rounded, minus fail-penalty per fail, clamped to 0..100. No pops at all is 0.

Five pops, all GOOD, no fail, with the defaults: a mean of 70, scaled by 5/20 to 17.5, rounded to 18. The same five pops ending in a miss: 18 − 15 = 3. Twenty pops all GOOD ending in a miss: 70 − 15 = 55.

Why the scaling exists

A mean on its own rates one lucky pop as highly as a long clean run: a single GOOD pop would sit at 70 above a twenty-two pop session on a leaderboard sorted by score. Scaling below full-credit-pops makes a short session score like a short session.

In a duel, each round is scored on its own and the match score is the average of the round scores. Pops, fails and the best reaction are summed across rounds.

Rating#

The score says how cleanly a session was played and is blind to speed, which is what a duel round is decided on. A leaderboard asks something else: a clean run at 10 ticks is harder than a clean run at 20. The rating is the score times the weight of the interval it was played at:

rating = round(score × weight(ticks))

weight(ticks) is the value under performance.speed-weights for that interval, written as text such as "10". An interval with no weight of its own weighs reference-ticks / ticks, so with the default 20 a 40-tick interval would weigh 0.5. A score of 80 is a rating of 200 at 10 ticks and 80 at 20 ticks.

KeyDefaultWhat it does
speed-weights25: 0.8, 20: 1.0, 15: 1.5, 10: 2.5, 5: 5.0What one point of score is worth at each interval. The shipped weights rise a little faster than the plain ratio: the last few ticks are the hard ones.
reference-ticks20The interval that weighs 1.0 when it has no weight of its own.

The rating is what the rating leaderboard sorts by and what the session summary screen shows. It is computed from the stored score each time a board is read, so retuning the weights re-ranks every board without touching a record. See Statistics.

Feedback#

Everything a player sees and hears is an ExyliaLib effect under feedback in messages.yml, so each language folder carries its own: a title, an action bar, a sound, and optionally a boss bar, particles or a firework. Remove a channel to keep it quiet; remove a whole section and nothing plays. The full shape of an effect block is documented in the library's effects page.

Per grade#

Each grade has an effect and a chat line, empty for none. Both know four placeholders:

PlaceholderValue
%grade%The grade name, PERFECT to SLOW.
%reaction%The reaction in seconds, two decimals, no unit.
%pops%Pops so far in this session or round.
%streak%Pops in a row since the last fail.

By default a grade shows no title, plays ENTITY_EXPERIENCE_ORB_PICKUP at volume 0.8 and a pitch that drops with the grade, and writes the action bar:

GradeAction barPitch
perfect{success}⚡ PERFECT {muted}· {letters}%reaction%s1.8
excellent{success_light}✦ EXCELLENT {muted}· {letters}%reaction%s1.5
good{info}✔ GOOD {muted}· {letters}%reaction%s1.2
ok{warning}• OK {muted}· {letters}%reaction%s1.0
slow{error}▼ SLOW {muted}· {letters}%reaction%s0.7

Only perfect has a chat line by default: %prefix% {success}Perfect pop! {highlight}%reaction%s.

plugins/ExyliaTotemTrainer/lang/en/messages.yml
yaml
feedback:
  perfect:
    effect:
      action-bar:
        text: "{success}⚡ PERFECT {muted}· {letters}%reaction%s"
        duration: 2.0
      sound:
        name: ENTITY_EXPERIENCE_ORB_PICKUP
        volume: 0.8
        pitch: 1.8
        category: MASTER
    chat: "%prefix% {success}Perfect pop! {highlight}%reaction%s"

The other moments#

SectionWhenDefault
failNo totem in hand when a hit landedTitle {error}&lPOPPED OUT / {letters}You did not swap in time, sound ENTITY_ITEM_BREAK 1.0 · 0.8
countdownBefore the first hit of a session or roundTitle {primary}&l%time% / {letters}Press {highlight}E {letters}and swap totems from your inventory, action bar {secondary}Starting in {highlight}%time_precise% ⌚, sound BLOCK_NOTE_BLOCK_HAT 1.0 · 1.4. %time% is the seconds left, %time_precise% the same with its unit.
match-foundBoth duellists arrived in the arenaTitle {primary}&lMATCH FOUND / {letters}Teleporting…, sound ENTITY_EXPERIENCE_ORB_PICKUP 1.0 · 1.2
round-wonA round went to youTitle {success}&lROUND WON, sound ENTITY_PLAYER_LEVELUP 1.0 · 1.4
round-lostA round went to your opponentTitle {error}&lROUND LOST, sound BLOCK_NOTE_BLOCK_BASS 1.0 · 0.7
round-drawBoth dropped the totem in the same tickTitle {warning}&lDRAW / {letters}Both of you dropped it — replaying, action bar {warning}Round replayed, sound BLOCK_NOTE_BLOCK_SNARE 1.0 · 0.8
match-wonThe series is yoursTitle {success}&lVICTORY / {letters}Match won, sound UI_TOAST_CHALLENGE_COMPLETE
match-lostThe series is theirsTitle {error}&lDEFEAT / {letters}Match lost, sound ENTITY_WITHER_HURT 0.6 · 0.8
training-completeA full-inventory mode without refill ran outTitle {success}&lCOMPLETE / {letters}Every totem used, sound UI_TOAST_CHALLENGE_COMPLETE

Sound values are volume · pitch. The countdown's title and action bar count the same seconds and stop together, whether the timer ran out or a punch cut it short.

Per-grade chat lines

The chat line accepts the same placeholders as the effect. A server that wants a quieter screen can empty the action bars and write one chat line per grade instead; a server that wants none of it removes the chat values and keeps the sounds.

Check that it works#

Run /totemtraineradmin reload, start /totem train normal, and let a few totems pop. Each one should show the action bar of its grade with the reaction in seconds; a very fast swap reads PERFECT. Miss a totem and the "POPPED OUT" title appears, then the summary screen shows the score and the rating.

Going further#

Something missing on this page? Tell us on Discord