⚔️ 强化装备系统 Addon

📖 概述

本 Addon 为 Minecraft 基岩版增加了一套完整的装备强化体系，包含宝石镶嵌、卷轴强化、神器石附魔、天罚、掉落获取和保底机制。所有操作通过投掷器作为合成台完成。

• 自定义物品：4 种（强化宝石、强化卷轴、神器石、神器石碎片）
• 可强化装备：60 种（剑 / 重锤 / 三叉戟 / 弓弩 / 全套盔甲 / 鞘翅 / 工具）
• 宝石效果：6 种（吸血 / 暴击 / 爆炸 / 经验 / 耐久 / 转移）
• 卷轴 BUFF：6 部位 × 5 等级
• 合成台：投掷器（共 7 种操作）

🎁 一、自定义物品

物品	ID	图标	堆叠	获取方式
强化宝石	enhance:gem	石英	不可堆叠	怪物 / 方块掉落、命令给予
强化卷轴	enhance:scroll	纸	不可堆叠	方块掉落、合成升级、命令给予
神器石	enhance:godstone	下界之星	不可堆叠	碎片合成、命令给予
神器石碎片	enhance:debris	唱片残片 5	64	怪物 / 方块掉落、命令给予

🛠️ 二、投掷器合成台

💎 1. 宝石镶嵌（GEM_INLAY）

槽位	放入
槽 0	强化宝石（任意类型）
槽 1	可强化的装备

• 将宝石镶嵌到装备上，概率判定 + 保底机制（3 次）

📜 2. 卷轴强化（SCROLL_ENHANCE）

槽位	放入
槽 0	强化卷轴
槽 1	可强化的装备

• 将卷轴强化效果施加到装备对应部位

⬆️ 3. 卷轴升级（SCROLL_UPGRADE）

槽位	放入
槽 0 / 1 / 2	3 个同等级强化卷轴

• 3 张同等级卷轴 → 1 张升 1 级卷轴（100% 成功），最高 5 级

🔮 4. 碎片合成（DEBRIS_COMBINE）

槽位	放入
槽 0	神器石碎片（9 个一组）

• 9 个碎片 → 1 个神器石（基础成功率 50%，保底 10 次）

⭐ 5. 神器石附魔（GODSTONE_ENCHANT）

槽位	放入
槽 0	神器石
槽 1	可强化的装备

• 附魔锋利 V / 保护 IV / 耐久 III / 经验修补 I，3 级以上额外获得天罚

⬆️ 6. 神器石升级（GODSTONE_UPGRADE）

槽位	放入
槽 0 / 1 / 2	3 个同等级神器石

• 3 个同等级神器石 → 1 个升 1 级（100% 成功），最高 5 级

🔄 7. 转移宝石（TRANSFER）

槽位	放入
槽 0	转移宝石
槽 1	源装备（已有强化数据）
槽 2	目标装备

• 将源装备的宝石 + 卷轴数据完整复制到目标装备

📦 8. 可强化装备清单

以下装备均可镶嵌宝石、强化卷轴、神器石附魔（共 60 种）：

类别	具体装备	数量
剑	木 / 石 / 铁 / 金 / 钻石 / 下界合金剑	6
重锤	重锤	1
三叉戟	三叉戟	1
弓弩	弓、弩	2
头盔	皮革 / 锁链 / 铁 / 金 / 钻石 / 下界合金 / 海龟帽	7
胸甲	皮革 / 锁链 / 铁 / 金 / 钻石 / 下界合金胸甲	6
鞘翅	鞘翅	1
护腿	皮革 / 锁链 / 铁 / 金 / 钻石 / 下界合金护腿	6
靴子	皮革 / 锁链 / 铁 / 金 / 钻石 / 下界合金靴	6
工具	斧 / 镐 / 锹 / 锄 × 木 / 石 / 铁 / 金 / 钻石 / 下界合金	24

合计 60 种。爆炸宝石仅限远程武器（弓 / 弩 / 三叉戟）。

💎 9. 装备 × 宝石适配表

「✅」表示镶嵌后效果生效；「❌」表示无效果或不可镶嵌。转移宝石不镶嵌（用于数据转移操作）。

装备类别	吸血	暴击	爆炸	经验	耐久
剑	✅	✅	❌	❌	✅
重锤	✅	✅	❌	❌	✅
三叉戟	✅	✅	✅	❌	✅
弓 / 弩	✅	✅	✅	❌	✅
工具（斧 / 镐 / 锹 / 锄）	✅	✅	❌	❌	✅
头盔	❌	❌	❌	✅	✅
胸甲	❌	❌	❌	✅	✅
护腿	❌	❌	❌	✅	✅
靴子	❌	❌	❌	✅	✅
鞘翅	❌	❌	❌	✅	✅

说明：吸血 / 暴击 / 爆炸由主手攻击触发，仅武器类有效；经验宝石由击杀触发，仅盔甲类（含鞘翅）有效；耐久宝石全装备有效。爆炸宝石有硬性限制，只能镶嵌远程武器（弓 / 弩 / 三叉戟）。

💎 三、宝石系统

宝石类型	效果	触发条件	CD	额外说明
吸血 (lifesteal)	攻击回血 = 伤害 × 10% × 等级	entityHurt（任意攻击）	3 秒	—
暴击 (crit)	额外伤害 = 原伤害 × 50% × 等级	entityHurt（30% 概率）	3 秒	延迟 1 tick 避免无敌帧
爆炸 (explosion)	爆炸威力 = 2 × 等级	entityHurt（弹射物，25% 概率）	5 秒	—
经验 (exp)	额外经验 = 10 × 等级	entityDie（50% 概率）	1 秒	遍历全部盔甲槽位
耐久 (durability)	耐久 < 10 时自动重置	轮询检测（每 4 tick）	—	被动生效
转移 (transfer)	复制强化数据到目标装备	合成台操作	—	需配合转移宝石

🎲 掉落来源

掉落机制说明：每个掉落条目独立进行概率判定，互不影响。例如破坏钻石矿时，卷轴（30%）和碎片（1.5%）各自独立判定，有可能同时掉落两种材料。

👾 怪物掉落（33 种）

🧟 主世界 · 僵尸系

怪物	掉落物及概率
僵尸 / 尸壳	吸血宝石 3%、碎片 0.5%
溺尸	吸血宝石 6%、碎片 1%

💀 主世界 · 骷髅系

怪物	掉落物及概率
骷髅 / 流髑	暴击宝石 3%、碎片 0.5%
凋灵骷髅	碎片 8%

🕷 主世界 · 蜘蛛系

怪物	掉落物及概率
蜘蛛	暴击宝石 3%、碎片 0.5%
洞穴蜘蛛	暴击宝石 2%、碎片 0.5%

🌍 主世界 · 其他

怪物	掉落物及概率
苦力怕	暴击 6%、爆炸 4%、碎片 1%
女巫	经验宝石 8%、碎片 2%
史莱姆	经验宝石 4%、碎片 0.5%
蠹虫 / 末影螨	经验宝石 2%
末影人	经验宝石 5%、碎片 3%
幻翼	经验宝石 5%、碎片 2%

🏹 灾厄村民

怪物	掉落物及概率
掠夺者	经验宝石 5%、碎片 2%
卫道士	经验宝石 8%、碎片 5%
唤魔者	经验宝石 10%、碎片 8%
劫掠兽	耐久宝石 8%、碎片 5%

🌊 海洋

怪物	掉落物及概率
守卫者	耐久宝石 5%、碎片 2%
远古守卫者	耐久宝石 10%、碎片 8%

🔥 下界

怪物	掉落物及概率
僵尸猪灵	碎片 5%
猪灵	爆炸宝石 4%、碎片 3%
猪灵蛮兵	碎片 8%
疣猪兽 / 僵尸疣猪兽	耐久宝石 4%、碎片 3%
烈焰人	爆炸宝石 5%、碎片 3%
恶魂	爆炸宝石 5%、碎片 4%
岩浆怪	爆炸宝石 5%、碎片 3%

🌌 末地

怪物	掉落物及概率
潜影贝	耐久宝石 8%、碎片 6%
末影龙	碎片 15%

👑 Boss

怪物	掉落物及概率
凋零	耐久宝石 12%、碎片 12%
循声守卫	耐久宝石 15%、碎片 15%

⛏️ 方块掉落（21 种）

🪨 常见方块

方块	掉落物及概率
石头 / 深板岩	卷轴 1%、碎片 0.1%

⛏️ 主世界矿物（含深层变体）

方块	掉落物及概率
煤矿	卷轴 2%、碎片 0.3%
铁矿 / 铜矿	卷轴 3%、碎片 0.5%
青金石矿	卷轴 2%、碎片 0.8%
红石矿	卷轴 3.5%、碎片 0.8%
金矿	卷轴 4%、碎片 1%
绿宝石矿	卷轴 8%、碎片 1%
钻石矿	卷轴 30%、碎片 1.5%

深层变体（deepslate_*）与对应矿石掉落概率一致。

💎 下界矿物

方块	掉落物及概率
下界金矿	碎片 4%
下界石英矿	碎片 4%
远古残骸	碎片 20%

📜 四、卷轴系统

📊 成功率

等级	成功率
1 级	100%
2 级	80%
3 级	60%
4 级	40%
5 级	20%

✨ BUFF 表（6 部位 × 5 级）

部位	1 级	2 级	3 级	4 级	5 级
头盔	水下呼吸 I	水下呼吸 II	水下呼吸 III	水下呼吸 IV + 夜视 I	水下呼吸 IV + 夜视 II
胸甲	抗性 I	抗性 II	抗性 III	抗性 III + 生命恢复 I	抗性 III + 生命恢复 II
护腿	力量 I	力量 II	力量 III	力量 III + 急迫 I	力量 III + 急迫 II
靴子	速度 I	速度 II	速度 III	速度 III + 跳跃 I	速度 III + 跳跃 II
工具	急迫 I	急迫 II	急迫 III	急迫 IV	急迫 V
剑	力量 I	力量 II	力量 III	力量 IV	力量 V

🧭 部位判断规则

• 头盔：所有头盔类物品
• 胸甲：所有胸甲类物品 + 鞘翅
• 护腿：所有护腿类物品
• 靴子：所有靴子类物品
• 工具：镐 / 斧 / 锹 / 锄
• 剑：所有剑类武器 + 三叉戟 + 重锤

🔮 五、神器石系统

⭐ 神器石等级与效果

等级	效果
Lv.1 ~ Lv.2	附魔：锋利 V + 保护 IV + 耐久 III + 经验修补 I
Lv.3 ~ Lv.5	附魔同上 + 天罚能力（伤害 / CD 随等级递增）

⚡ 天罚

等级	伤害	CD
Lv.3	15 点伤害	10 秒
Lv.4	25 点伤害	8 秒
Lv.5	40 点伤害	6 秒

天罚触发时有三阶段特效动画：

1. 法阵展开（约 1.5 秒）— 六芒星阵旋转展开，伴 beacon.power 音效
2. 能量汇聚（约 0.5 秒）— 六芒星收缩、粒子柱升起，伴 beacon.activate 音效
3. 激光打击（1 tick）— 激光束落下 + 爆炸粒子，伴 explode 音效

⚡ 六、BUFF 管理系统

• 每 4 tick 轮询检测玩家装备变化
• 通过快照比对（typeId + gems + scrolls hash），只在实际变化时重新施加 BUFF
• BUFF 一次性给予 9999 秒（约 2.7 小时），装备无变化时检查是否消失，消失则重新给予
• 死亡复活后自动清除快照并重新检测

🎯 七、保底机制

操作	保底次数	说明
宝石镶嵌	3 次失败后必成功	每宝石类型独立计数
卷轴强化	5 次失败后必成功	每部位独立计数
碎片合成	10 次失败后必成功	—

计数器存储在玩家的 dynamicProperty 中（enh:pity:gem、enh:pity:scroll:{slot}、enh:pity:debris）。

管理员的 incc 强制 100% 模式优先于所有概率判定。

📊 八、掉落统计系统

📈 统计机制

• 按「玩家 + 来源（怪物 / 方块）」独立维护环形缓冲区（容量 100），自动淘汰最旧记录
• 覆盖所有掉落类型：6 种宝石 + 卷轴 + 神器碎片，按怪物 / 方块来源分组显示
• 仅玩家击杀的怪物掉落才纳入统计（日光烧死 / 摔死 / 刷怪塔等非玩家击杀不计入）
• 统计数据保存在内存中，重启世界后清零

🖥️ 管理命令

命令	功能	权限
/enhance:intensify stats [玩家]	查看掉落统计（近 100 次 / 来源）。[玩家] 选择器决定查看谁的数据（默认自己），结果始终发给指令执行者	管理员
/enhance:intensify resetstats	清零所有统计重新开始	管理员

输出示例

聊天栏按「怪物掉落 / 方块掉落」分组，逐条显示物品名 + 命中/总数 + 实际率 + 配置率：

来源	物品	命中 / 总数	实际掉率	配置概率
僵尸 [zombie]	吸血宝石	3 / 100	3.00%	3.0%
石头 [stone]	卷轴	1 / 100	1.00%	1.0%
钻石矿 [diamond_ore]	卷轴	3 / 12	25.00%	30.0%

注：样本量较小时实际掉率波动较大属正常现象，样本量越大越接近配置概率。

💾 九、数据存储

• 物品数据：存储在 ItemStack 的 getLore() 中（Lore 行用 JSON 编码的隐形字符标记）
• 玩家数据：存储在 Player.dynamicProperty（如保底计数、BUFF 快照等）
• 掉落统计：存储在内存中（环形缓冲区，重启清零），通过 /enhance:intensify stats 查看
• 定时轮询：BUFF 刷新 + 耐久检测，每 4 tick 运行一次
• CD 系统：每个宝石实例通过 Date.now() 毫秒时间戳管理冷却

🚀 十、使用流程示例

1. 获取材料：打怪 / 挖矿掉落宝石和碎片、挖钻石矿 / 绿宝石矿获得卷轴
2. 合成神器石：9 个碎片放入投掷器槽 0 → 关闭 → 获得神器石（50% 概率）
3. 卷轴升级：3 张同等级卷轴放入投掷器 → 关闭 → 获得升 1 级卷轴（100%）
4. 镶嵌宝石：宝石 + 装备放入投掷器 → 关闭 → 宝石镶嵌到装备
5. 强化卷轴：卷轴 + 装备放入投掷器 → 关闭 → BUFF 施加到装备
6. 神器附魔：神器石 + 装备放入投掷器 → 关闭 → 附魔生效（3 级 + 带天罚）
7. 数据转移：转移宝石 + 源装备 + 目标装备 → 关闭 → 强化数据复制
8. 查看统计：/enhance:intensify stats 查看卷轴实际掉率，验证概率是否符合预期