Kitten Clash Arena Helper

Passive stats tracker + community leaderboard for
Kitten Clash Arena.

Companion site: https://kittenclash-arena-helper.chez.gg/

What it does

Two independent features, both fully passive:

1. In-page stats widget

A small overlay on kittenclash.com that tracks your today
performance:

• Battles played and wins (with success rate)
• XP, gold, ELO earned
• Auto rollover at local midnight

Nothing about your account or credentials leaves the browser for this
feature - everything lives in localStorage.

2. Community ladder push

On explicit triggers, the script calls the game's own
/api/v1/leaderboard and /api/v1/season endpoints (same-origin, uses
your existing session cookie) and forwards the result to
kittenclash-arena-helper.chez.gg,
where it feeds a public read-only ladder:

• Full daily ELO ranking (podium + top 200+)
• Day-over-day Δ column
• Season-long Δ column
• Top 10 gainers / top 10 losers, per day and per season
• Season progress bar
• Historical day navigation

When it pushes

Three triggers, all explicit - no polling:

1. First game load of the day (once per Paris day, on script boot)
2. When you open the league page (detected via .league-header
   appearing in the DOM)
3. When you click the ↻ Update button in the widget

What it never does

• Never touches account settings, cosmetics, purchases, or DM.
• Never interacts with combat or dungeon UI.
• Never sends anything besides the leaderboard payload the game's own
  API already returns.
• Never stores or transmits your session cookie - it's used implicitly
  by the browser for the same-origin fetch, then discarded.

Data collected

For each visible fighter, the game's API already returns publicly:
fighterId, name, level, rating (ELO), wins, cosmetics.
That set is forwarded 1:1 to the companion site. Retention: 1 year.

Your own fighterId is remembered locally to make a future personal
history page possible - not sent as a separate identifier.

Install

Requires Tampermonkey (or any
compatible userscript manager exposing GM_xmlhttpRequest).

Direct install from openuserjs.org:

https://openuserjs.org/scripts/GeGe_GM/Kitten_Clash_Arena_Helper

Widget quick tour

• ↻ Update - force a push right now.
• Logs - full timestamped log (stats + push results, 24 h TTL).
• Ranks - snapshot of the last captured leaderboard.
• Reset - wipe today's local stats (never touches the server).
• Under the button row: last push timestamp + server response summary.

License

MIT.

Author

GeGe_GM - also author of
EasyPTRE.