EloRanks

插件

· 作者 i_c0de

适用于 Minecraft 1.21 服务器的基于 Elo 的 1v1 竞技排名系统,支持匹配、自动竞技场加载和动态 K 值。

0 本站下载 0 关注 更新于 6 个月前

最新 v2.1.0 · 1.21.11 · Paper

一键开服(送7天)

请在此处报告问题:Bug 和功能请求

可以通过 GitHub 请求版本更新!

EloRanks

适用于 Minecraft 1.21 服务器的竞技性 1v1 Elo 排名系统,具备匹配机制、自动竞技场加载和动态 K 值。

功能

  • Elo 评分系统:基于游戏场次和 Elo 评分的动态 K 值
  • 定级赛:新玩家进行 5 场定级赛,击败评分更高的对手可获得额外 Elo 奖励
  • 匹配机制:基于队列的匹配,随时间推移扩大 Elo 匹配范围
  • 自动竞技场加载:基于 FAWE 的竞技场系统,支持自动加载/卸载
  • 1v1 决斗:UHC 风格装备库,自定义倒计时计时器
  • 投降:30 秒后可用 - 立即判负(扣除全额 Elo)
  • 计分板 & Boss 栏:实时显示排名、Elo 和对手血量
  • 排名标签页: nametag 上带有颜色编码的排名前缀(#1-50)
  • 详细配置:高度可定制,提供大量选项
  • 自动更新检查器:当 Modrinth 上有新版本时通知服务器所有者

命令

玩家命令

命令 别名 描述
/er elo, elostats, erstats 查看你的 Elo 统计数据和排名
/er <player> 查看其他玩家的统计数据
/er top 查看顶级玩家
/duel <player> 向玩家发起决斗挑战
/duel accept <player> 接受决斗请求
/duel decline <player> 拒绝决斗请求
/duel match queue, mm 进入匹配队列
/duel cancel stop 取消匹配
/surrender forfeit, sq 从当前决斗中投降(最少 30 秒)
/leaderboard lb 查看全局 Elo 排行榜

管理员命令 (/eradmin)

命令 别名 描述
makeduel <p1> <p2> [force] startduel 创建决斗(force=true 为立即开始)
addarena createarena 添加新的竞技场实例
reload rl 重新加载配置
resetall wipedata 重置所有玩家数据
resetplayer <p> resetp 重置特定玩家的统计数据
setelo <p> <elo> setrating 设置玩家的 Elo
adde <p> <amt> addrating 为玩家增加 Elo
arenainfo arenastatus 显示竞技场信息
forcereset <id> cleararena 强制重置特定竞技场
endduel <p> cancelduel 结束玩家的活跃决斗
tparena [p] [id] arenatp 传送至竞技场
getpos <id> arenapos 获取竞技场坐标
heal <p> 治疗一名玩家
feed <p> 喂食一名玩家
stats plstats 显示插件统计数据
debug diag 显示调试信息

权限:er.admin(默认为 OP)

权限

权限 描述
er.duel 允许与其他玩家决斗
er.duel.request 允许发送决斗请求
er.duel.accept 允许接受决斗请求
er.duel.matchmaking 允许使用匹配队列
er.duel.surrender 允许从决斗中投降
er.stats.view 允许查看自己的统计数据
er.stats.view.others 允许查看其他玩家的统计数据
er.leaderboard 允许查看排行榜
er.admin 管理员访问权限

配置

所有配置均存储在 config.yml 中(首次运行时生成)。

Elo 设置

elo:
  starting: 1000              # 新玩家的起始 Elo
  min: 0                      # 最小 Elo
  max: 10000                  # 最大 Elo
  k-factor:
    win: 32                   # 胜利的基准 K 值
    draw: 16                  # 平局的基准 K 值
    dynamic:
      enabled: true           # 启用动态 K 值
      by-games:
        enabled: true
        threshold: 20         # 减少 K 值前的游戏场次阈值
        new-player-k: 48      # 新玩家的 K 值(前期比赛)
      by-elo:
        enabled: true
        threshold-1: 1500     # 第一个 Elo 阈值
        threshold-2: 2000    # 第二个 Elo 阈值
        k-at-1500: 24        # 在第一个阈值时的 K 值
        k-at-2000: 16        # 在第二个阈值时的 K 值
  placement:
    enabled: true
    min-players: 5            # 定级系统所需的最小玩家数
    match-count: 5            # 定级比赛场次
    k-factor-games: 5         # 定级比赛的 K 值
    bonus-beating-higher: true # 击败评分更高的玩家获得额外 Elo 奖励

决斗设置

duel:
  cooldown: 60                # 两次决斗之间的冷却时间(秒)
  request-timeout: 30        # 请求过期时间(秒)
  arena-world: "duel_arena"  # 竞技场所在的世界
  allow-spectators: true
  spectator-permission: "er.spectate"

投降设置

surrender:
  enabled: true
  min-duel-time-seconds: 30  # 投降前必须等待 30 秒
  instant-loss: true        # 全额 Elo 惩罚(不减半)

匹配设置

matchmaking:
  enabled: true
  initial-elo-range: 50      # 初始 Elo 范围
  range-increase-per-second: 10  # 每秒增加的范围
  max-elo-range: 500        # 最大范围
  bidirectional-check: true # 双方玩家都必须在范围内
  check-interval-seconds: 1

倒计时设置

countdown:
  teleport-seconds: 5        # 传送倒计时持续时间
  duel-start-seconds: 20    # 决斗开始倒计时持续时间
  show-title: true          # 显示标题
  show-subtitle: true       # 显示副标题
  show-chat-messages: true  # 显示聊天消息
  colors:
    seconds-20-to-6: "BLUE"
    second-5: "DARK_RED"
    second-4: "RED"
    second-3: "GOLD"
    second-2: "YELLOW"
    second-1: "GREEN"

竞技场设置

arena:
  initial-count: 10          # 初始竞技场数量
  spacing: 100               # 竞技场间距
  schematic: "cloudy.schematic"
  auto-expand: true          # 需要时自动添加竞技场
  expand-count: 5            # 扩展时添加的竞技场数量
  respawn-delay: 3           # 重生延迟(秒)
  load-timeout: 10           # 结构文件加载超时时间

套装设置

kit:
  enabled: true
  sword: "DIAMOND_SWORD"
  bow: "BOW"
  arrows: 64
  helmet: "DIAMOND_HELMET"
  chestplate: "DIAMOND_CHESTPLATE"
  leggings: "DIAMOND_LEGGINGS"
  boots: "DIAMOND_BOOTS"
  offhand: "SHIELD"
  food: "GOLDEN_APPLE:10"
  blocks: "COBWEB:16,OAK_PLANKS:64"
  buckets: "WATER_BUCKET,LAVA_BUCKET"

药水效果

effects:
  speed: true
  speed-level: 2
  speed-duration: 180  # 持续时间(秒),即 3 分钟
  strength: true
  strength-level: 2
  strength-duration: 180

世界与游戏机制

world:
  void-world: true           # 竞技场为虚空世界
  spawn-protection: false
  pvp-enabled: true

gameplay:
  fall-damage: false
  fire-damage: false
  hunger-depletion: false
  keep-inventory: true
  natural-regeneration: false
  potion-effects-disabled: true

计分板与 Boss 栏

scoreboard:
  enabled: true
  show-title: true
  title-animation: true
  show-rank: true
  show-elo: true
  show-world: true
  show-opponent-in-duel: true
  update-interval: 2  # 更新间隔(秒)

bossbar:
  enabled: true
  show-opponent-health: true
  health-update-interval: 5

聊天消息

chat:
  duel-request: true
  duel-start: true
  duel-end: true
  rank-up: true
  matchmaking-search: true
  pre-duel-instructions: true

调试设置

debug-mode: false
debug:
  show-elo-calculations: false
  show-matchmaking: false
  show-countdown: false

依赖

  • Minecraft Paper 1.21+
  • FAWE (FastAsyncWorldEdit) 用于竞技场系统
  • WorldGuard(推荐用于竞技场保护)

安装

  1. 在服务器上安装 FastAsyncWorldEdit
  2. 将 EloRanks-2.1.0.jar 放入 plugins 文件夹
  3. 重启或重载服务器
  4. 根据需要配置 config.yml
  5. 将你的竞技场结构文件放入 plugins/EloRanks/arenas/

竞技场搭建

  1. 使用 WorldEdit 在 Minecraft 中建造竞技场
  2. 在玩家 1 出生点放置 RED_WOOL(红色羊毛)
  3. 在玩家 2 出生点放置 BLUE_WOOL(蓝色羊毛)
  4. 导出竞技场为 .schematic 文件(使用 FAWE:/schem save name)
  5. 将其命名为 cloudy.schematic(或与配置文件中一致)
  6. 将该结构文件放入 plugins/EloRanks/arenas/

工作原理

Elo 计算

  • 新玩家的 K-factor 初始值为 48(前 5 场定级赛)
  • 随着玩家场次和 Elo 的增加,K-factor 会降低
  • 高评级玩家获得奖励较少,失去惩罚较多
  • 在定级赛中击败高评级玩家可获得额外 Elo

匹配机制

  • 玩家通过 /duel match 加入队列
  • Elo 范围从 50 开始,每秒增加 10
  • 最大范围为 500 Elo
  • 双方必须处于彼此的匹配范围内才能进行匹配

决斗流程

  1. 玩家 A 向玩家 B 发起挑战(或双方使用匹配系统)
  2. 玩家 B 接受挑战(或自动匹配)
  3. 双方看到 5 秒传送倒计时
  4. 战斗前有 20 秒倒计时,颜色逐渐变化:
    • 第 20-6 秒:蓝色
    • 第 5 秒:暗红色
    • 第 4 秒:红色
    • 第 3 秒:橙色
    • 第 2 秒:黄色
    • 第 1 秒:绿色
    • 第 0 秒:GO!
  5. 直到一方死亡或投降(至少持续 30 秒)
  6. 胜者获得 Elo,败者扣除 Elo

投降

  • 决斗开始后 30 秒可用
  • 视为立即失败——施加全额 Elo 惩罚
  • 对手获得全额 Elo 奖励(不减半)

构建

# 使用构建脚本
cd EloRanks
mvn clean package

构建好的 JAR 文件位于 target/EloRanks-{version}.jar

许可证

EloRanks © 2026 by i_c0de is licensed under CC BY-ND 4.0

更新日志

v2.1.0

  • 添加了自动 Modrinth 版本检查器——当有新版本可用时通知服务器所有者

v2.0.1

  • 修复了一些小错误并进行了改进

v2.0.0

  • 首次发布,包含完整的 Elo 排名系统
  • 匹配队列
  • 基于 FAWE 的自动竞技场加载
  • 带有 UHC 风格套装的 1v1 决斗
  • 基于场次和 Elo 评级的动态 K-factor
  • 新玩家的定级比赛
  • 投降功能
  • 计分板和 Boss 栏显示

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源