Grading

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.

The grades

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

performance:
  defaults:
    perfect: 0.25
    excellent: 0.40
    good: 0.60
    ok: 0.90
  by-ticks:
    "10":
      perfect: 0.15
      excellent: 0.25
      good: 0.35
      ok: 0.45
  by-mode: {}
  points:
    perfect: 100
    excellent: 85
    good: 70
    ok: 50
    slow: 25
  fail-penalty: 15
  full-credit-pops: 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.

The shipped file grades a 10-tick session harder than a 25-tick one: at half a second between hits, 0.45 s is the slowest reaction that still counts as OK. 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.

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.

Feedback

Everything a player sees and hears is an ExyliaLib effect under feedback: 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:

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:

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

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

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.