Prekoyte's Powerlevels - ：装备战力等级

战力等级系统

Prekoyte's PowerLevel 是一款基于玩家装备与属性计算战力值的插件，支持 PlaceholderAPI 占位符，并允许管理员通过规则引擎对战力进行世界与权限的全局调整。

💡需求

• 服务端：Paper/Spigot 1.21+（基于 Paper API 1.21.1 构建）
• Java 版本：Java 21
• 必需插件：PlaceholderAPI
• 推荐插件：权限管理插件（如 LuckPerms）

✨功能特性

• 战力来源：综合计算生命值、护甲、主副手物品、背包神器、精英附魔、原版附魔以及权限权重。
• 规则引擎：支持基于世界和玩家权限的全局战力倍率调整。
• 管理工具：内置游戏内规则管理界面与后台更新检查开关。
• 占位符扩展：提供 %powerlevel_power%、%powerlevel_powerdecimal%、%powerlevel_power_<player>%、%powerlevel_color% 等多种 PlaceholderAPI 占位符。
• 高度可配置：
• 可配置战力颜色、物品白名单、副手开关、累计模式。
• 支持自动为未知权限添加权重记录。
• 支持自定义物品与神器权重（基于材质或显示名称）。
• 支持从物品 lore 中解析精英附魔。
• 稳定可靠：线程安全的占位符解析，具备弹性的配置解析与更新检查机制。

🎮指令与帮助

• /power 或 /power show [玩家名]

查看自己（或指定在线玩家）的战力。控制台使用时必须指定玩家名。

• /power reload

重载所有配置文件。

• /power admin rules list|add|remove

管理规则倍率。

• /power admin updates on|off

切换后台更新检查功能。

• /power help

在游戏内显示此帮助信息。

🎮权限节点

• powerlevel.show

允许查看自身战力（默认：true）。

• powerlevel.show.others

允许查看其他玩家的战力。

• powerlevel.reload

允许重载配置文件。

• powerlevel.admin

允许使用管理类子指令（如 rules/updates）。

• 可选权重：在 config.yml 的 permission-power 项下添加条目，可为特定权限赋予额外的固定战力值。

✨战力计算来源

• 生命值 (HP)：基于 hp-power 配置中的 per-hp（每点生命）、per-max-hp（每点最大生命）和 for-max-hp（达到最大生命时的奖励）进行计算。
• 护甲：基于 armor.yml 中配置的材质权重及其附魔。
• 主手/副手物品：基于 item.yml 中配置的物品权重及其附魔。副手物品是否计入受 do-offhand、do-whitelist 和 whitelist 配置控制。
• 神器：指背包中未装备的物品。基于 item.yml 中的 Artifact 和 CustomArtifact 配置计算，其附魔也会被计入。已装备在护甲槽、主手或副手的物品不会被重复计算为神器。
• 自定义物品：在 item.yml 的 CustomItem 和 CustomArtifact 中，通过物品显示名称（去除颜色代码）进行匹配。材质键名需使用小写（例如 diamond_sword）。
• 权限：permission-power 配置可为特定权限添加固定战力；rules.permission-multipliers 则可为拥有特定权限的玩家提供最终战力的倍率加成。

✨附魔计算

• 标准附魔：在 enchantments.yml 的 Enchantments 项下配置。若 do-cumulative 为 true，则使用累计值乘以等级；否则使用每级固定值。
• 精英附魔：在 enchantments.yml 的 elite 项下配置。插件会从物品 lore 中解析格式为“名称 罗马数字”的附魔（例如 Shadow Assassin V），颜色代码会被忽略。do-cumulative 配置同样影响精英附魔的计算方式（累计值×等级 或 每级固定值）。

✨规则（倍率系统）

• rules.world-multipliers

为指定世界设置战力倍率（不支持通配符，需明确列出每个世界名）。

• rules.permission-multipliers

为拥有指定权限的玩家设置战力倍率（权限匹配不区分大小写）。

• 生效时机：所有战力来源相加得到总和后，再根据适用的世界和权限倍率进行乘法计算。

🔧配置要点 (`config.yml`)

• dynamic-reload：每次计算时都重载配置（仅用于测试，生产环境请关闭）。
• do-offhand、do-whitelist、whitelist：控制副手物品是否计入及白名单机制。
• hp-power：配置生命值相关的 per-hp、per-max-hp 和 for-max-hp 值。
• do-cumulative：为附魔等级启用累计战力计算模式（同时影响标准附魔和精英附魔）。
• permission-power：将权限映射到固定战力值。
• do-auto-generate：为 true 时，插件会将遇到的未知权限以 0.0 的权重自动添加到 permission-power 中，便于后续调整。
• auto-generate-flush-seconds：控制自动生成的权限记录被保存到配置文件的频率。设置较低值可提高持久化速度，较高值可减少磁盘写入。
• update-checks：启用/禁用启动时的异步更新检查。
• colors：颜色范围列表，用于驱动 %powerlevel_color% 占位符的输出。

🔧管理操作示例

• 列出所有规则：/power admin rules list
• 添加世界倍率：/power admin rules add world world_nether 2.0
• 移除世界倍率：/power admin rules remove world world_nether
• 添加权限倍率：/power admin rules add permission vip.tier3 1.5
• 移除权限倍率：/power admin rules remove permission vip.tier3
• 切换更新检查：/power admin updates off（或 on）
• 保存自动生成的权限：/power admin flush

❓PlaceholderAPI 占位符

• %powerlevel_power%：战力的整数部分（向下取整）。
• %powerlevel_powerdecimal%：保留一位小数的战力值。
• %powerlevel_power_<玩家名>%：查询指定在线玩家的战力。
• %powerlevel_color%：根据配置的颜色范围，返回对应的颜色代码。

⭐安装步骤

• 将 PowerLevel-0.3.0.jar 放入服务器的 /plugins 文件夹。
• 确保已安装并运行 PlaceholderAPI。
• 重启服务器。
• 通过权限插件（如 LuckPerms）授予玩家相关权限。
• 按需编辑 config.yml、enchantments.yml、item.yml、armor.yml 等配置文件，然后使用 /power reload 重载。

💡注意事项与提示

• 使用 /power admin rules remove ... 移除特定规则。所有规则都保存在 config.yml 的 rules 节点下。
• 世界倍率不支持通配符，必须明确列出每个世界名称。
• 当 do-auto-generate 开启时，新出现的权限会以 0.0 的权重被记录到 permission-power 中，方便后续手动调整。
• 通过 auto-generate-flush-seconds 可以调整自动生成权限的保存频率。数值越低保存越及时，越高则减少磁盘写入。
• 生产环境中请保持 dynamic-reload 为关闭状态，以避免不必要的配置读写开销。