
MCSREloBot
玩家可以查询任何 MCSR 排位玩家的 Elo、排名、个人最佳成绩以及每日会话统计——像 Twitch 机器人一样,直接在游戏聊天中操作。
由公共 MCSR Ranked API 提供支持。无需 API 密钥。
功能
/elo [用户名](或在聊天中使用 +elo)- 完整的 Elo 摘要:评分、赛季最高分、排名 + 分区、排行榜位置、胜/负、胜率、比赛场次、PB(个人最佳)、平均完成时间以及弃权率
/pb [用户名](或 +pb)- 赛季、历史总记录以及休闲模式的个人最佳成绩
/today [用户名](或 +today)- 今日排位会话:胜/负、净 Elo 变化、比赛场次以及最佳完成时间
- Twitch 机器人风格的聊天别名 - 玩家在普通聊天中输入
+elo Feinberg,回复将向所有人广播(前缀和广播行为均可配置)
- 默认使用你自己的名字 - 输入不带用户名的
+elo 会查找发送者本人
- 在线玩家名称的 Tab 补全
- 智能速率限制 - 按玩家设置的冷却时间和响应缓存确保远低于 MCSR Ranked API 的限制
- 完全可配置的消息 - 每一行输出、颜色和占位符都可以在
config.yml 中编辑
- 支持 LuckPerms 权限系统 - 开箱即用的每个命令节点、冷却绕过和管理员节点
示例
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 今日战绩:4胜2负 • +37 Elo(当前 1310)• 6场比赛 • 最佳成绩:12:41
玩家:/pb couriway
[MCSR] Couriway PB:8:32(本赛季)• 7:01(历史最佳)• 休闲模式:9:12
要求
- Java 21 或更高版本
- Paper/Spigot/Purpur — Minecraft 1.20 至 26.2
- 需要向
api.mcsrranked.com 发送出站 HTTPS 请求
快速开始
-
将 jar 文件放入 plugins/ 目录并重启服务器。
-
在聊天栏输入 +elo <任意 MCSR 排位玩家>。就这么简单——无需 API 密钥。
-
可选:调整 plugins/MCSREloBot/config.yml 并运行 /mcsrelo reload。
配置
chat-aliases-enabled: true # 聊天中使用 +elo / +pb / +today
chat-prefix: "+"
cooldown-seconds: 5 # 每位玩家的冷却时间
cache-seconds: 60 # API 响应缓存时间
today-timezone: "UTC" # 什么算作“今天”用于 /today
broadcast: true # 响应是否对所有人可见,还是仅发送者可见
权限 (LuckPerms)
通过标准的 Bukkit 权限与 LuckPerms 配合工作——无需额外设置,只需将节点分配给组即可。
| 节点 |
默认值 |
用途 |
mcsrelobot.use |
所有人 |
elo/pb/today 的父节点 |
mcsrelobot.elo / .pb / .today |
所有人 |
独立命令 |
mcsrelobot.bypass.cooldown |
op |
跳过冷却时间 |
mcsrelobot.admin |
op |
重载 + 跳过冷却时间 |
/lp group default permission set mcsrelobot.use true
/lp group vip permission set mcsrelobot.bypass.cooldown true
许可证
MIT License.
专为 Minecraft 速通社区打造
与 Mojang、Microsoft 或 MCSR Ranked 团队无关

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
- Drop the jar into
plugins/ and restart.
- Type
+elo <any MCSR Ranked player> in chat. That's it — no API key needed.
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧