原创 娱乐 【1.7-1.21+|Folia】⚔ WarZPvPTitle - PvP 声望 · 段位晋升 · 战斗即荣耀|高度自定义|极致视听体验|排行榜|Papi 1.5.0

[MD] ### v1.5.0 * **修复**: 修复 1.17 及以下版本服务端启动时报 `NoSuchMethodError: FileConfigurationOptions.parseComments(boolean)` 导致插件无法启用的问题（YAML 注释 API 为 1.18+ 专属，已做版本隔离）。 * **优化**: 在低版本服务端上，自动补齐缺失配置项仅在内存中生效，不再覆写配置文件，避免低版本保存 YAML 时丢失全部注释；1.18+ 行为不变。 [/MD]

v1.4.9 主要更新：

1. 修复: 修复排名变量（%warzpvptitle_top_name_X%、%warzpvptitle_top_fame_X%、%warzpvptitle_top_rank_X%）无法解析的问题
2. 优化: HologramManager 排名缓存系统现在独立运行，不再依赖 DecentHolograms 插件是否安装
3. 说明: 之前版本中，排名变量只有在安装了 DecentHolograms 时才能正常工作。现在即使不使用全息图插件，排名变量也能在记分板、Tab 列表等任何支持 PlaceholderAPI 的地方正常显示

[MD] ### v1.4.8 * **修复**: 修复 1.18 等旧版本服务端加载失败：`InvalidPluginException: Unsupported API version 1.2`。 * **修复**: `plugin.yml` 中 `api-version: 1.20` 被 YAML 解析为浮点数 `1.2` 的问题；现改为字符串 `'1.13'`。 * **兼容**: 将声明的 API 版本从 `1.20` 下调为 `1.13`，避免在 1.13–1.19 服务端因 API 版本过高被拒绝加载。 * **说明**: 不影响 Folia 标记（`folia-supported: true`）与既有功能；建议从 1.4.7 升级到本版本。 [/MD]

更新内容总结：

• 新增段位 permissions 配置，玩家首次达到对应段位后自动解锁权限。
• 权限记录到 data.yml 的 unlocked_permissions，玩家重进服务器会自动恢复。
• /warzpvp reload 会重新同步已达到段位的权限。
• 保留原来的 rewards 命令奖励逻辑，旧格式段位配置仍兼容。

• 修复全息排行榜玩家名、段位名在特殊情况下夹带零宽字符后，被客户端渲染成 ZWSP 一类异常小字的问题。
• 优化 %warzpvptitle_top_name_X%、%warzpvptitle_top_rank_X%、%warzpvptitle_rank%、%warzpvptitle_next_rank% 的输出，在返回前自动清洗常见隐藏字符。
• 增加对 U+200B、U+200C、U+200D、U+2060、U+FEFF 等零宽字符的兜底过滤，降低外部配置或上游文本污染对排行榜显示的影响。

v1.4.5 更新内容总结​

本次需求​

给全息排行榜增加段位名称，让它能在一行里同时显示「玩家名字 + 声望值 + 对应段位名」。

新增​

• 全息排行榜段位名称变量%warzpvptitle_top_rank_X%（X = 1~20）
  • 根据该名玩家的声望值实时换算段位（青铜 / 白银 / 黄金 / 铂金 / 钻石 / 黑鹰 / 巅峰战神…）
  • 段位名自带 § 颜色码，DecentHolograms 可正常渲染颜色
  • 排行榜数据仍每 60 秒自动刷新一次

• 补充了声望排行榜出现 ZWSP 等异常小字时的排查说明。
• 明确 %warzpvptitle_top_fame_X% 占位符本身只返回纯数字，不会额外附加后缀。
• 建议优先检查 DecentHolograms 全息配置中的隐藏字符，以及客户端资源包的字体渲染问题。

v1.4.3 修复了 ranks.yml 在重载后自动补回默认段位的问题；现在服主可以自由删除、重排、自定义军衔，不会再被默认内容覆盖；自动补配置功能仍保留给 config.yml 和 lang.yml。

• v1.4.1
  修复击杀 0 声望玩家时击杀者仍然获得声望的问题；新增“被击杀者最低声望门槛”配置；优化死亡扣分的实际结算与提示一致性。
• v1.4.2
  新增自动补齐配置文件功能，支持 config.yml、lang.yml、ranks.yml；启动和重载时自动同步缺失项；写回前自动创建备份，降低升级维护成本。

1. 新增可选开关：可限制低声望/零声望玩家击杀时不再获得声望。
2. 新增可选开关：可为首次接触插件数据的玩家发放初始声望，避免成长死循环。
3. 优化玩家加入时的声望初始化流程。
4. 更新 Wiki 与配置示例，版本升级至 v1.4.0。