HyArmorVariants - 新手盒子

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

HyArmorVariants 为**护甲**添加了随机属性变体，使每件制作或拾取的头盔、胸甲、护腿或靴子都能获得不同的性能。变体会按物品存储，并在交易、存储和服务器重启后保持不变。

正在开发中

免责声明： 本模组仍在开发中！请在 CurseForge 项目页面或 Discord 报告错误/功能请求。

报告问题时，请包含： mods/HyArmourVariants/config/HyArmourVariants.json5、mods/HyArmourVariants/Languages/ 中的语言文件（如已修改），以及相关的服务器日志片段（在配置中启用 debug: true 以获取详细日志）。

✅ 主要功能

每件护甲的独立随机属性 —— 相同的头盔或胸甲可能因其变体而提供不同的属性加成。
持久化的物品数据 —— 变体存储在 ItemStack（BSON 元数据）上。
护甲支持： 在制作、拾取、背包变化或打开容器时应用。可与原版风格护甲（头盔、胸甲、护腿、靴子）及可配置的通配符一起使用。
工具提示中的变体评级 —— 当安装了 DynamicTooltipsLib 时，工具提示会显示 5 星评级 和 百分比，然后是特殊效果和属性加成。可选功能；无此模组也可正常运行。
护甲上的特殊攻击 —— 护甲可以随机到五种特殊效果之一（烈焰环、冰霜新星、毒雾、雷霆一击、荆棘光环）。当你被击中时，你的护甲特殊效果可以作用于攻击者（玩家、生物或 NPC），具有可配置的触发几率和冷却时间。
对攻击者的护甲效果（荆棘式） —— 当你被击中时，你护甲的变体属性（例如荆棘）可以对击中你的实体施加效果。可配置规则、几率和冷却时间。
效果持续时间 —— 效果持续时间变体增加你施加的减益效果的持续时间。当穿戴同一套中的多件装备时，可选择获得套装加成。

⭐ 变体星级评级

当启用 DynamicTooltipsLib 时，变体护甲物品工具提示的第一行会显示 5 星评级 和 总体变体百分比（例如 [****-] 91%）。实心星 (*) 为黄色，空位 (-) 为灰色；百分比反映了随机到的强度（例如，默认为 0-150%）。伤害倍率不包含在护甲评级中。

✨ 特殊效果（防御者护甲 -> 攻击者）

护甲可以随机到以下一种特殊攻击。当你被玩家、生物或 NPC 击中时，你装备的护甲的特殊效果可以作用于攻击者（可配置触发几率和每个防御者的冷却时间）。

特殊效果	触发时对攻击者的作用
烈焰环	灼烧（火焰环）。
冰霜新星	在区域内冰冻/减速并造成伤害。
毒雾	持续中毒伤害。
雷霆一击	闪电伤害。
荆棘光环	对攻击者施加荆棘效果。

🛡️ 对攻击者的护甲效果（荆棘式）

当你被击中时，你护甲的变体属性可以对攻击者（击中你的那个）施加效果。默认规则：荆棘——如果你的护甲有荆棘变体，则有一定几率对击中你的玩家/生物/NPC 施加荆棘效果。您可以在配置中添加更多规则（例如，其他属性对应其他效果）。每个效果的冷却时间是可配置的。

效果	护甲变体属性	描述
荆棘	荆棘	有一定几率对击中你的实体施加荆棘效果（可配置）。

📊 所有护甲变体

护甲会随机获得这些属性的一部分（数量和池可配置）。每个变体都有一个倍率范围；随机结果决定了该属性在装备上的强度。不含仅限武器的属性（例如额外伤害、暴击率）——仅包含对护甲有意义的属性。

变体 ID	显示名称	典型范围	描述
EffectDuration	效果持续时间	75-150%	增加你施加的减益效果的持续时间。
Mana	魔力	80-120%	魔力消耗或上限（百分比越低表示消耗越少）。
SignatureEnergy	签名能量	80-120%	签名/技能能量消耗。
Stamina	耐力	80-115%	耐力消耗或上限。
Thorns	荆棘	80-135%	当你被击中时，对攻击者施加荆棘效果的几率。
LifeSteal	生命偷取	70-140%	造成伤害时的生命偷取（如果适用）。
MovementSpeed	移动速度	90-115%	穿戴该装备时的移动速度。
DurabilityBonus	耐久度	75-150%	护甲耐久度或消耗速率。

🛠️ 兼容性与集成

回收机/加工台 —— 变体护甲可在回收机中使用；打开时物品 ID 会被标准化，以便配方接受它们；当你取回物品时，变体数据会被恢复。
Romnas 品质工艺 —— 当同时安装两个模组时，品质物品 ID 会被解析为变体和回收机的基础物品（可配置；无额外依赖）。
当模组护甲符合护甲判定规则（例如 armor_, helmet, chestplate, leggings, boots）或可配置的 armorItemIdGlobs 时，可得到支持。可选的 护甲套装加成，当穿戴同一套中的多件装备时生效。

⚙️ 配置

配置文件路径：mods/HyArmourVariants/config/HyArmourVariants.json5 (JSON5 格式，首次运行时创建)。
最小/最大随机范围、分布（均匀 / 三角 / 正态）、每件护甲的变体数量、可随机到的属性、护甲套装加成。
何时应用变体：背包变化、拾取、打开容器；用于手中物品同步的轮询器。可选的 性能模式 和工具提示选项。
对攻击者的护甲效果： applyArmorOnAttackerEffects、armorOnAttackerEffects、armorOnAttackerCooldownSeconds。
防御者护甲特殊效果： applyDefenderArmorSpecialToAttacker、defenderArmorSpecialCooldownSeconds、与武器特殊攻击相同的特殊攻击配置和触发几率。
/hav reload 可应用配置更改，无需重启服务器。

🌐 支持的语言

工具提示和 UI 字符串可以进行翻译。在配置中设置 language: "xx"（例如 language: "de" 表示德语）。语言文件位于 mods/HyArmourVariants/Languages/，并在首次运行时从模组中提取。

代码	语言
`en`	英语
`de`	德语
`cs`	捷克语
`uk`	乌克兰语
`fr`	法语
`es`	西班牙语
`pl`	波兰语
`ru`	俄语
`pt`	葡萄牙语
`it`	意大利语

📋 命令

/hav 或 /hav help —— 显示版本和命令列表（或根据权限打开配置菜单）
/hav version —— 显示模组版本
/hav reload —— 从磁盘重新加载配置（无需重启服务器）
/hav menu —— 打开配置界面
/hav dump —— （手持护甲） 显示用于调试的变体元数据
/hav apply —— （手持护甲） 强制为手持物品应用一个变体
/hav reroll —— （手持护甲） 移除现有变体并随机生成一个新的变体

别名：/hyarmorvariants、/hyarmourvariants

权限（与 LuckPerms 及类似插件兼容）：

hyarmorvariants.command.help —— /hav、/hav help、/hav version
hyarmorvariants.command.reload —— /hav reload
hyarmorvariants.command.menu —— /hav menu
hyarmorvariants.command.dump —— /hav dump
hyarmorvariants.command.apply —— /hav apply
hyarmorvariants.command.reroll —— /hav reroll
hyarmorvariants.command.edit —— 通过界面编辑配置

如果没有权限插件：帮助和版本命令对所有人可用；重新加载、菜单、导出、应用和重新随机需要 op 权限。控制台可以运行所有命令。

🛡️ 技术说明

构建时考虑了更新弹性：安全的反射和回退、元数据版本控制、稳定的指纹识别。变体根据属性 id 存储，因此将来的属性重新排序不太可能破坏旧物品。护甲属性在已装备的部件之间进行累加汇总（例如 1 + Σ(m_piece − 1) + 套装加成）。

🔧 更新后插件未显示/未加载

如果更新后（或回滚/重新安装后）游戏没有识别到模组，请尝试：

移除模组 —— 从你的 mods 文件夹中删除 HyArmourVariants JAR 文件。
清除模组数据 —— 删除 mods/HyArmourVariants 文件夹（配置和语言文件），以便插件全新启动。
重启游戏 以清除内存状态。
重新安装 —— 将 HyArmourVariants JAR 文件放回 mods 文件夹并重新启动游戏。

如果插件仍未出现，请检查服务器/客户端日志中关于 HyArmourVariants 的错误。如果配置文件或语言文件丢失，模组会回退到默认设置，因此它至少应该能够加载。

📝 备注

配置和语言文件位于 mods/HyArmourVariants/ 目录下（查看首次运行的服务器日志以获取确切路径）。
与 HyWeaponVariants（用于武器）配合使用；此模组仅针对护甲。

🔖 图例：

🧑‍🍳 - 正在下次更新中制作

✏️ - 将来会做

📋 待办事项列表

🧑‍🍳 | 连接 HyArmorVariants 和 HyWeaponVariants

🧑‍🍳 | 创建可以组合属性的套装

🧑‍🍳 | 制作发光护甲变体

🔖 图例：

📋 待办事项列表

评论