TierSense

插件

· 作者 RealNamanOP

适用于 Paper 的服务端自动 PvP 技能评级与段位追踪,支持按模式排名及浮动段位徽章。

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

最新 v1.0.0 · 1.21.11 · Paper

一键开服(送7天)

TierSense

适用于 Paper 服务器的自动服务端 PvP 技能评级与段位追踪。

TierSense 会观察 PvP 战斗,评估玩家表现,为每种支持的 PvP 模式分配独立的段位,并在玩家名字标签上方显示排名模式。

无需安装客户端模组。

✨ 功能特性

⚔️ 自动 PvP 评级

TierSense 会自动观察 PvP 战斗并根据玩家的表现进行评级。

每场战斗都会根据玩家的装备和战斗上下文分类到特定的 PvP 模式中。

支持的模式:

  • ? Crystal PvP
  • ? Netherite Pot PvP
  • ? Diamond Pot PvP
  • ? Axe PvP
  • ⚔️ Sword PvP
  • ? UHC PvP

每种模式都有其独立的评级。

例如,一名玩家可以拥有以下段位:

Crystal   → LT3
NethPot   → HT4
DiaPot    → LT4
Axe       → HT3
Sword     → LT2
UHC       → LT4

? Elo 风格评级

TierSense 使用基于 Elo 的评级系统。

  • 起始评级可配置
  • 击败更强的对手可获得更多评级点数
  • K 值初始为 32,并随经验逐渐降低
  • 每次有段位的比赛评级变化上限为 ±35
  • 前 10 场有段位的比赛为暂定段位
  • 暂定段位的玩家显示为 Unranked(未定级)
  • 晋升立即生效
  • 降级需要连续 3 场有段位的比赛低于段位阈值

这可以防止因单场糟糕的战斗导致段位剧烈波动。

? 段位阶梯

默认阶梯包含 9 个段位:

LT5
HT4
LT4
HT3
LT3
HT2
LT2
HT1
LT1

段位阈值和颜色可在 tiers.yml 中配置。

?️ 防刷分保护

TierSense 包含防止人为刷取评级的安全措施。

  • 每 30 分钟内与同一对手的比赛最多计入 3 场有段位比赛
  • 20 秒内的重赛会降低评级影响
  • 时间过短的战斗会被忽略
  • 总伤害不足的战斗会被忽略
  • 距离过远的交互会被忽略
  • 比赛设有最大时长限制
  • 无效或不完整的战斗不会影响评级

? 浮动段位名字标签

已排名的模式可以使用原生的 Minecraft TextDisplay 显示在玩家名字标签上方。

示例:

? HT1  ? LT3  ? HT2
       PlayerName

该显示效果:

  • 跟随玩家移动
  • 使用特定段位的颜色
  • 在一行内显示所有排名模式
  • 使用 PvP 模式的物品图标
  • 平滑插值移动动画
  • 潜行时隐藏
  • 直到玩家拥有排名段位后才显示
  • 玩家离开或切换世界时自动清理
  • 不需要客户端模组

? 持久化档案

玩家数据根据其 UUID 单独存储。

plugins/TierSense/
├── config.yml
├── tiers.yml
├── messages.yml
└── playerdata/
    └── <uuid>.yml

档案包含:

  • 评级
  • 当前段位
  • 比赛统计
  • 战斗统计
  • 段位历史
  • 排名信息

玩家数据会定期自动保存。

? 高级账号与离线服务器支持

TierSense 支持在线模式(premium)和离线模式(offline-mode)服务器。

在高级/在线模式下,玩家身份与其 Minecraft UUID 关联。

可以通过插件配置启用离线模式支持。

TierSense 不需要 Microsoft 密码、认证令牌或任何私人账户信息。

? 管理员覆盖

服务器管理员可以在必要时手动分配段位。

手动覆盖优先于自动排名,并且在移除覆盖之前不会被排名系统覆盖。

示例:

/tier set PlayerName crystal LT3

? 开发者 API

TierSense 为其他插件提供了 Bukkit ServicesManager API。

开发人员可以访问:

  • 玩家评级
  • 玩家段位
  • PvP 模式信息

包含的事件:

PvpMatchStartEvent
PvpMatchEndEvent
PlayerTierChangeEvent

这使得 TierSense 适合作为大型 PvP 服务器、排行榜、匹配系统、网站以及其他排名相关插件的基础。


命令

命令 描述 权限
/tier [player] 查看玩家的段位概览 tiersense.view
/tier stats <player> [mode] 查看战斗统计 tiersense.stats
/tier history <player> 查看最近的段位变更 tiersense.stats
/tier set <player> <mode> <tier> 设置手动段位覆盖 tiersense.set
/tier reset <player> <mode> 移除段位覆盖 tiersense.set
/tier evaluate <player> 重新评估玩家的评级和段位 tiersense.set
/tier reload 重载配置 tiersense.reload
/tier debug <player> 查看内部战斗状态 tiersense.debug

管理员权限

tiersense.admin

tiersense.admin 授予对所有 TierSense 管理权限的访问权。


配置

TierSense 为插件的不同部分提供单独的配置文件。

config.yml

控制:

  • 账号识别
  • 排名设置
  • 战斗检测
  • 名字标签显示
  • 图标
  • PvP 模式
  • 允许的世界
  • 自动保存
  • 其他插件行为

tiers.yml

控制:

  • 段位名称
  • 评级阈值
  • 段位颜色

messages.yml

控制面向玩家的消息,并支持自定义颜色代码和占位符。

playerdata/

每个玩家 UUID 对应一个档案文件。


评级工作原理

TierSense 并不声称单一统计数据能完美衡量机械 PvP 技巧。

相反,它结合战斗中可观察到的服务器端信息,并利用结果来维持评级。

根据 PvP 模式的不同,跟踪的信息可能包括以下内容:

  • 造成的伤害
  • 受到的伤害
  • 命中次数
  • 战斗时长
  • 距离
  • 相关物品使用
  • 模式专属战斗行为
  • 胜利
  • 失败
  • 比赛历史

具体可用的信息取决于 Minecraft/Paper 为该模式暴露的数据。

结果是 PvP 表现的自动化统计估算,而非替代人工锦标赛裁判。


比赛检测

当玩家进入战斗时,战斗会话开始,并在发生以下任一情况时结束:

  • 一名玩家死亡
  • 超过 10 秒没有相关交互
  • 战斗达到配置的最大持续时间
  • 战斗以其他方式变得无效

默认情况下,以下情况下的比赛会被忽略:

  • 时间过短
  • 低于最低总伤害要求
  • 距离过远
  • 因其他原因不适合排名

这些值可以进行配置。


PvP 模式检测

TierSense 使用装备和战斗上下文来确定战斗风格。

检测优先级:

Crystal
↓
NethPot
↓
DiaPot
↓
Axe
↓
Sword
↓
UHC

每种模式都有独立的评级。

通过 PvpMode 系统,为开发者添加新的 PvP 模式被设计得十分简便。


要求

  • Minecraft Java Edition
  • Paper 1.21.11
  • Java 21

客户端模组

无需安装。

TierSense 是一个服务端插件。


兼容性

TierSense 专为以下环境设计:

  • Paper 1.21.11
  • Java Edition 服务器
  • 在线模式(Online-mode)服务器
  • 启用后支持离线模式(Offline-mode)服务器

通过 Geyser 连接的 Bedrock 玩家可能会因客户端/资源包支持的限制而减少部分视觉功能。底层的服务器端排名系统仍可正常运行。


性能

TierSense 围绕基于事件的战斗跟踪进行设计,而不是每刻都持续计算玩家统计数据。

它使用:

  • 缓存的玩家资料
  • 定期持久化
  • 基于事件的战斗跟踪
  • 受控的显示实体管理
  • 可配置的调试日志

旨在提供 PvP 分析的同时,避免不必要地增加服务器负载。


面向开发者

TierSense 通过以下方式暴露一个 Bukkit 服务:

TierSenseApi

其他插件可以使用它来查询玩家的排名信息。

示例用例:

  • PvP 排行榜
  • 匹配系统
  • 锦标赛系统
  • 网站
  • Discord 集成
  • 计分板
  • 自定义匹配队列
  • 基于排名的奖励

文档:

docs/CONTEXT.md
docs/usage.md

重要限制

TierSense 只能评估 Minecraft 服务器可获得的信息。

它无法直接观察:

  • 鼠标移动
  • 原始 CPS(每秒点击次数)
  • 客户端瞄准
  • 私有的客户端信息
  • Microsoft 账户凭证
  • 对服务器隐藏的信息

因此,TierSense 应被视为 自动化的 PvP 表现排名系统,而非对机械技巧的完美衡量。


许可

请参阅随项目附带的许可证文件。

链接

源代码: 在此处添加您的 GitHub 仓库链接。

问题 / Bug 报告: 在此处添加您的 GitHub Issues 页面链接。

文档: 在此处添加您的文档链接。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源