武器增强器

武器强化插件

最后更新： 2026-02-01
插件版本： 0.3.21

武器强化 为 Hytale 中的武器和护甲添加了一个高级强化系统。你获得的每一件武器和护甲都会自动拥有独特的随机属性！

🚀 主要功能

• ✓ 自动强化： 所有武器和护甲自动获取词缀
• ✓ 5种稀有度等级： 普通、魔法、稀有、史诗、传说
• ✓ 总计20个词缀： 12个武器词缀 + 8个护甲词缀
• ✓ 超级词缀： 具有触发概率的特殊效果
• ✓ 难度系统： 4个难度等级，奖励可缩放
• ✓ 材料系统： 材料影响词缀强度
• ✓ 图形界面： 现代化 UI 管理武器和护甲
• ✓ 完全可配置： 每一个方面都可以自定义

🆕 最新更新 (0.3.21)

• 物品强化黑名单： 排除特定物品ID（例如：喇叭枪弹药），使其永远不会获得稀有度/词缀。
• 掉落倍率黑名单： 排除特定物品ID（例如：战利品袋），使其永远不会被难度掉落系统倍乘。
• 全局强化几率： 符合条件的武器/护甲获得稀有度+词缀的可配置几率（enhancementGenerationChance）。设为 1.0 即为“始终强化”。
• 护甲生命恢复平衡： 可配置的倍率+上限，防止因叠加恢复导致的失衡。
• HUD稳定性改进： 降低了加入游戏时 HUD 的竞态条件。

📋 快捷栏提示

概述
插件会在玩家选中一个快捷栏格子时显示一个自定义 HUD 提示。该提示只针对当前选中的快捷栏格子（不依赖鼠标悬停）。仅对强化过的武器或护甲显示，并在几秒后自动隐藏。

重要提示： 此提示仅在快捷栏（选中的格子）生效。由于当前 Hytale 客户端的限制，目前无法实现鼠标悬停时显示每个物品的提示（例如背包中）。快捷栏 HUD 是展示已装备物品稀有度和词缀的受支持方式。

• 何时显示： 对当前激活的快捷栏格子可见；提示卡在4秒后或切换格子时隐藏。
• 显示内容： 物品名称、稀有度（带有颜色）和词缀，每行一个。
• 空位/未强化格子： 不显示提示卡。

⚔️ 稀有度系统

稀有度	颜色	词缀数量	数值上限
普通	⚪ 白色	1	30%
魔法	🔵 蓝色	2	50%
稀有	🟡 黄色	3	70%
史诗	🟣 紫色	4	85%
传说	🔴 红色	5	100%

原理： 当你获得一件武器/护甲时，会分配一个随机稀有度。稀有度越高，词缀越多，数值上限也越高。

✨ 武器词缀（共12个）

攻击类

• 力量 - 提升伤害 (10% - 100%)
• 暴击 - 提升暴击几率 (10% - 50%)
• 暴击伤害 - 提升暴击伤害 (30% - 100%)

实用类

• 能量充能 - 每次命中生成能量 (15% - 60%)
• 生命偷取 - 基于造成的伤害恢复生命值 (25% - 100%)
• 耐久 - 提升武器耐久度 (20% - 80%)

特殊类

• 共振 - 提升对特定敌人的伤害 (20% - 50%)
• 捕食者 - 提升对生物的伤害 (15% - 40%)
• 主宰 - 提升对玩家的伤害 (5% - 15%)

🛡️ 护甲词缀（共8个）

• 生命恢复 - 每秒恢复生命值 (1% - 3%)
• 魔力消耗降低 - 减少魔力消耗 (5% - 25%)
• 能量消耗降低 - 减少能量消耗 (5% - 15%)
• 移动速度 - 提升移动速度 (5% - 15%)
• 火焰伤害减免 - 减少火焰伤害 (5% - 100%)
• 毒素伤害减免 - 减少毒素伤害 (5% - 100%)
• 通用防御 - 减少所有物理和魔法伤害 (4% - 7%)
• 荆棘 - 向攻击者反弹伤害 (4% - 7%)

重要提示： 护甲词缀在穿戴多个部件时会叠加（例如，4件拥有生命恢复的装备 = 4倍数值）。

🌟 超级词缀

战斗中按一定概率触发的特殊效果：

超级词缀	效果	触发概率	持续时间
流血	造成持续伤害	20%	15秒
毒素伤害	造成毒素伤害	20%	8秒
冰霜伤害	冻结敌人	20%	5秒

原理： 当你击中敌人时，会进行随机判定是否触发效果。该概率是可配置的（默认30%的武器拥有超级词缀）。

🎮 难度系统

选择你的挑战等级，共有4个难度级别：

难度	敌人防御	敌人伤害	材料奖励	稀有度奖励	掉落率
普通	1.0x	1.0x	1.0x	0%	1.0x
困难	3.5x	1.5x	1.5x	15%	1.5x
专家	4.5x	2.0x	2.5x	30%	2.5x
大师	6.0x	2.8x	4.0x	50%	4.0x

注意： 敌人防御内部使用递减收益，以避免极端数值（因此“有效”伤害减免并非纯粹的线性增长）。

如何使用： 输入 /enhancer 并打开难度菜单。难度越高，奖励越好（更多材料、更高掉落率、更好的稀有度几率），但敌人也更强大。

宝箱战利品： 宝箱会根据你的难度等级生成更好的战利品。难度越高，获得稀有物品的几率越大。

🔧 命令

🎮 菜单命令

• /enhancer - 打开主菜单（武器、护甲、难度、设置、背包）

⚙️ 材料系统

材料影响词缀的强度：

材料等级	倍率	示例
基础	30%	粗糙、木制、骨质
低级	50%	铜
中级	65-80%	青铜、铁
高级	90-95%	钢、银、金
终局	100%	秘银、精金、钴、钍、黑曜石、诅咒

示例： 一把稀有级的铁质武器拥有50%的力量词缀，实际效果为 50% × 0.8 = 40% 的力量。更好的材料 = 更强的词缀！

💡 玩家提示

1. 从简单的开始： 使用基础材料制作武器，以了解系统运作方式
2. 使用 /enhancer： 打开菜单浏览你的物品，管理升级/词缀
3. 渐进式升级： 从低概率的升级开始，以节省精华
4. 堆叠护甲： 穿戴4件拥有相同词缀的装备以最大化效果
5. 超级词缀： 寻找带有超级词缀的武器，让战斗更轻松
6. 回收旧物品： 回收旧武器/护甲以回收材料
7. 难度奖励： 更高难度 = 更好奖励，但也更具挑战性
8. 材料很重要： 一把普通级的秘银武器可能比稀有级的铜武器更好

⚠️ 重要提示

• 词缀在获得武器/护甲时自动应用
• 超级词缀有触发概率（并非总是激活）
• 材料影响词缀强度（更好的材料 = 更好的词缀）
• 更高稀有度拥有更多词缀和更高数值
• 护甲词缀在穿戴多个部件时会叠加
• 一切均可通过 plugins/weapon-enhancer/ 目录下的 JSON 文件进行配置

⚙️ 新配置选项

这些选项位于 plugins/weapon-enhancer/config.json：

• enhancementItemIdBlacklist： 必须永远不获得稀有度/词缀的物品ID（例如：弹药）。
• dropMultiplierItemIdBlacklist： 必须永远不被难度掉落系统倍乘的物品ID（例如：战利品袋）。
• enhancementGenerationChance： 应用稀有度+词缀的几率（0.0 - 1.0）。使用 1.0 保持“始终强化”。
• armorHpRegenMultiplier： 倍乘最终叠加的护甲生命恢复数值（越低 = 恢复越弱）。
• armorHpRegenMaxPercentPerInterval： 限制每个间隔的生命恢复上限，防止过强的治疗。

🔧 需求与依赖

该插件需要服务器上安装并启用（即未被服务器配置禁用）以下模组/插件：

1. Hybrid API (Serilum:Hybrid)

• 版本： 最新兼容版本
• 下载： 可在 CurseForge 获取
• 安装： 将 Hybrid JAR 文件放入服务器的 plugins/ 目录
• 注意： 必须安装并运行 Hybrid 后，此插件才能正常工作

2. HyUI (Ellie:HyUI)

• 版本： 最新兼容版本
• 下载： 可在 CurseForge 获取
• 用途： 用于UI（例如分解、升级、快捷栏提示）
• 安装： 将 HyUI 作为独立的模组/插件安装（它并未集成在此 JAR 包内）

3. MultipleHUD (Buuz135:MultipleHUD)

• 版本： 最新兼容版本
• 用途： 此插件所需的快捷栏提示 HUD 层（客户端 HUD 集成）
• 安装： 作为独立模组/插件安装并保持启用

故障排除

如果遇到问题：

• “插件加载失败”： 确保首先安装并加载了 Hybrid API
• “找不到类”： 确认 Hybrid API 版本正确且已正确安装
• “UI 无法工作”： 确保你使用的是兼容的 Hytale 服务器版本
• “找不到依赖 'Ellie:HyUI' / 'Buuz135:MultipleHUD'”： 模组缺失或被服务器配置禁用

注意： 此插件专为 Hytale 早期访问版设计。功能可能随着游戏开发而改变。