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。
开发人员可以访问:
包含的事件:
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 页面链接。
文档: 在此处添加您的文档链接。
TierSense
Automatic server-side PvP skill rating and tier tracking for Paper.
TierSense watches PvP fights, evaluates player performance, assigns an independent tier for each supported PvP mode, and displays ranked modes above the player's nametag.
No client-side mods required.
✨ Features
⚔️ Automatic PvP Rating
TierSense automatically observes PvP fights and rates players based on their performance.
Each fight is classified into a PvP mode using the player's equipment and combat context.
Supported modes:
- ? Crystal PvP
- ? Netherite Pot PvP
- ? Diamond Pot PvP
- ? Axe PvP
- ⚔️ Sword PvP
- ? UHC PvP
Each mode has its own independent rating.
For example, a player can be:
Crystal → LT3
NethPot → HT4
DiaPot → LT4
Axe → HT3
Sword → LT2
UHC → LT4
? Elo-Style Rating
TierSense uses an Elo-style rating system.
- Starting rating is configurable
- Stronger opponents are worth more rating
- K-factor starts at 32 and gradually decreases with experience
- Rating changes are capped at ±35 per rated match
- First 10 rated matches are provisional
- Provisional players appear as Unranked
- Promotions happen immediately
- Demotions require 3 consecutive rated losses below the tier threshold
This keeps tiers from changing dramatically because of one bad fight.
? Tier Ladder
The default ladder contains 9 tiers:
LT5
HT4
LT4
HT3
LT3
HT2
LT2
HT1
LT1
Tier thresholds and colors are configurable in tiers.yml.
?️ Anti-Farming Protection
TierSense includes safeguards against artificially farming rating.
- Maximum 3 rated matches against the same opponent per 30 minutes
- Rematches within 20 seconds receive reduced rating impact
- Very short fights are ignored
- Fights with insufficient total damage are ignored
- Excessively distant interactions are ignored
- Matches have a maximum duration
- Invalid or incomplete fights do not affect ratings
? Floating Tier Nametag
Ranked modes can be displayed above a player's nametag using a native Minecraft TextDisplay.
Example:
? HT1 ? LT3 ? HT2
PlayerName
The display:
- Follows the player
- Uses tier-specific colors
- Shows all ranked modes on one line
- Uses PvP-mode item icons
- Interpolates movement smoothly
- Hides while sneaking
- Hides until the player has a ranked tier
- Cleans itself up when players leave or change worlds
- Does not require a client-side mod
? Persistent Profiles
Player data is stored individually using their UUID.
plugins/TierSense/
├── config.yml
├── tiers.yml
├── messages.yml
└── playerdata/
└── <uuid>.yml
Profiles contain:
- Ratings
- Current tiers
- Match statistics
- Combat statistics
- Tier history
- Ranking information
Player data is automatically saved periodically.
? Premium & Offline Server Support
TierSense supports both online-mode and offline-mode servers.
In premium/online mode, player identity is associated with their Minecraft UUID.
Offline-mode support can be enabled through the plugin configuration.
TierSense does not require Microsoft passwords, authentication tokens, or any private account information.
? Admin Overrides
Server administrators can manually assign a tier when necessary.
Manual overrides take priority over automatic ranking and will not be overwritten by the ranking system until the override is removed.
Example:
/tier set PlayerName crystal LT3
? Developer API
TierSense provides a Bukkit ServicesManager API for other plugins.
Developers can access:
- Player ratings
- Player tiers
- PvP mode information
Included events:
PvpMatchStartEvent
PvpMatchEndEvent
PlayerTierChangeEvent
This makes TierSense suitable as a foundation for larger PvP servers, leaderboards, matchmaking systems, websites, and other ranking-related plugins.
Commands
| Command |
Description |
Permission |
/tier [player] |
View a player's tier summary |
tiersense.view |
/tier stats <player> [mode] |
View combat statistics |
tiersense.stats |
/tier history <player> |
View recent tier changes |
tiersense.stats |
/tier set <player> <mode> <tier> |
Set a manual tier override |
tiersense.set |
/tier reset <player> <mode> |
Remove a tier override |
tiersense.set |
/tier evaluate <player> |
Re-evaluate a player's rating and tier |
tiersense.set |
/tier reload |
Reload configuration |
tiersense.reload |
/tier debug <player> |
View internal combat state |
tiersense.debug |
Administrator Permission
tiersense.admin
tiersense.admin grants access to all TierSense administrative permissions.
Configuration
TierSense provides separate configuration files for different parts of the plugin.
config.yml
Controls:
- Account identification
- Ranking settings
- Combat detection
- Nametag display
- Icons
- PvP modes
- Allowed worlds
- Autosave
- Other plugin behavior
tiers.yml
Controls:
- Tier names
- Rating thresholds
- Tier colors
messages.yml
Controls player-facing messages and supports customizable color codes and placeholders.
playerdata/
Contains one profile per player UUID.
How Rating Works
TierSense does not attempt to claim that one statistic can perfectly measure mechanical PvP skill.
Instead, it combines server-observable information from fights and uses the result to maintain a rating.
Depending on the PvP mode, tracked information can include things such as:
- Damage dealt
- Damage received
- Hits
- Fight duration
- Distance
- Relevant item usage
- Mode-specific combat actions
- Wins
- Losses
- Match history
The exact information available depends on what Minecraft/Paper exposes for that mode.
The result is an automated statistical estimate of PvP performance, not a replacement for human tournament judging.
Match Detection
A combat session begins when players enter combat and ends when one of the following occurs:
- A player dies
- There has been no relevant interaction for 10 seconds
- The fight reaches the configured maximum duration
- The fight otherwise becomes invalid
By default, matches are ignored when they are:
- Too short
- Below the minimum total damage requirement
- Too far apart
- Otherwise invalid for ranking
These values can be configured.
PvP Mode Detection
TierSense determines the fight style using equipment and combat context.
Detection priority:
Crystal
↓
NethPot
↓
DiaPot
↓
Axe
↓
Sword
↓
UHC
Each mode has an independent rating.
Adding another PvP mode is designed to be straightforward for developers through the PvpMode system.
Requirements
- Minecraft Java Edition
- Paper 1.21.11
- Java 21
Client Mods
None required.
TierSense is a server-side plugin.
Compatibility
TierSense is designed for:
- Paper 1.21.11
- Java Edition servers
- Online-mode servers
- Offline-mode servers when enabled
Bedrock players connecting through Geyser may have reduced visual functionality depending on client/resource-pack support. The underlying server-side ranking system can still operate.
Performance
TierSense is designed around event-driven combat tracking rather than constantly calculating player statistics every tick.
It uses:
- Cached player profiles
- Periodic persistence
- Event-based combat tracking
- Controlled display entity management
- Configurable debug logging
The goal is to provide PvP analytics without unnecessarily adding server load.
For Developers
TierSense exposes a Bukkit service through:
TierSenseApi
This can be used by other plugins to query player ranking information.
Example use cases:
- PvP leaderboards
- Matchmaking
- Tournament systems
- Websites
- Discord integrations
- Scoreboards
- Custom matchmaking queues
- Rank-based rewards
Documentation:
docs/CONTEXT.md
docs/usage.md
Important Limitations
TierSense can only evaluate information available to the Minecraft server.
It cannot directly observe:
- Mouse movement
- Raw CPS
- Client-side aim
- Private client information
- Microsoft account credentials
- Information hidden from the server
Therefore, TierSense should be considered an automated PvP performance ranking system, rather than a perfect measurement of mechanical skill.
License
See the license included with the project.
Links
Source Code: Add your GitHub repository here.
Issues / Bug Reports: Add your GitHub Issues page here.
Documentation: Add your documentation link here.
评论 0
登录后参与评分
还没有评论,来抢沙发吧