!Elo Bot Example

MCSREloBot

Players can check elo, rank, personal bests, and daily session stats for any MCSR Ranked player — Twitch-bot style, right in game chat. Powered by the public MCSR Ranked API. No API key required.

Features

• /elo [username] (or +elo in chat) - Full elo summary: rating, season peak, rank + division, leaderboard position, W/L, win rate, match count, pb, average completion, and forfeit rate
• /pb [username] (or +pb) - Season, all-time, and casual personal bests
• /today [username] (or +today) - Today's ranked session: W/L, net elo change, match count, and best completion
• Twitch-bot style chat aliases - Players type +elo Feinberg in normal chat, the response is broadcast for everyone (both prefix and broadcast behavior configurable)
• Defaults to your own name - +elo with no username looks up the sender
• Tab completion for online player names
• Smart rate limiting - Per-player cooldowns and response caching keep you far below the MCSR Ranked API limits
• Fully configurable messages - Every output line, color, and placeholder is editable in config.yml
• LuckPerms-ready permissions - Per-command nodes, cooldown bypass, and admin nodes out of the box

Example

Player: +elo Feinberg
[MCSR] Feinberg Elo: 2294 (Peak 2319) • Netherite (#13) • W/L 224/126 (64.0%) • 354 Matches • 6:08 pb (9:24.0 avg) • 1.1% FF Rate
Player: +today
[MCSR] eldoor Today: 4W/2L • +37 Elo (1310 now) • 6 Matches • Best: 12:41
Player: /pb couriway
[MCSR] Couriway PB: 8:32 (Season) • 7:01 (All-Time) • Casual: 9:12

Requirements

• Java 21 or higher
• Paper/Spigot/Purpur — Minecraft 1.20 through 26.2
• Outbound HTTPS access to api.mcsrranked.com

Quick Start

1. Drop the jar into plugins/ and restart.
2. Type +elo <any MCSR Ranked player> in chat. That's it — no API key needed.
3. Optionally tweak plugins/MCSREloBot/config.yml and run /mcsrelo reload.

Configuration

chat-aliases-enabled: true   # +elo / +pb / +today in chat
chat-prefix: "+"
cooldown-seconds: 5          # per-player cooldown
cache-seconds: 60            # API response cache
today-timezone: "UTC"        # what counts as "today" for /today
broadcast: true              # responses visible to everyone vs. only the sender

Permissions (LuckPerms)

Works with LuckPerms via normal Bukkit permissions — no extra setup beyond assigning nodes to groups.

Node	Default	Purpose
mcsrelobot.use	everyone	Parent of elo/pb/today
mcsrelobot.elo / .pb / .today	everyone	Individual commands
mcsrelobot.bypass.cooldown	op	Skip the cooldown
mcsrelobot.admin	op	Reload + cooldown bypass

/lp group default permission set mcsrelobot.use true
/lp group vip permission set mcsrelobot.bypass.cooldown true

License

MIT License.

Made for the Minecraft speedrunning community Not affiliated with Mojang, Microsoft, or the MCSR Ranked team