物品升级系统
玩家可以解绑、拆解、修理和附魔精英物品。本指南说明所需物品、费用和可能的结果。
卷轴、废料和幸运券必须是已启用的自定义物品，材质与定义一致，且 consumable.type 为 unbind、repair_scrap 或 lucky_ticket。修理废料还需要 1 到 5 的整数 consumable.tier；其他两种类型不接受 tier。仅有相同的名称或说明文字并不能让物品生效。无效的消耗品配置会禁用该自定义物品。
系统消耗一览
| 系统 | 所需物品 | 货币消耗 | 成功率 |
|---|---|---|---|
| 拆解 | 精英物品 | 无 | 75%（默认） |
| 解绑 | 精英物品 + 解绑卷轴 | 无 | 100% |
| 修理 | 精英物品 + 废料 | 无 | 100% |
| 附魔 | 精英物品 + 附魔书（+ 可选幸运券） | (附魔权重+1)^4 金币 | 可变（见公式） |
解绑物品
如果你拥有一张物品解绑卷轴，就可以使用解绑员 NPC 把 1 张卷轴与 1 件物品结合，从而解除该物品的绑定。
卷轴使用一次即消耗。解绑会移除 Soulbind 所有者和旧版声望标签，之后物品可以出售或赠予其他玩家。菜单接受具有耐久元数据的精英物品，并检查卷轴的所有权。
拆解物品
精英物品可以在拆解员 NPC 处被拆解。拆解物品时，根据物品的等级，你会获得如下废料：
- 0-49 级：微小废料（
elite_scrap_tiny.yml） - 50-99 级：小型废料（
elite_scrap_small.yml） - 100-149 级：中型废料（
elite_scrap_medium.yml） - 150-199 级：大型废料（
elite_scrap_large.yml） - 200 级及以上：巨型废料（
elite_scrap_huge.yml）
在 Soulbind 生效时，拆解员会检查精英物品是否属于你。如果对应废料缺失、被禁用或没有定义预期的修理废料层级，原物品会留在菜单中，并记录警告。
废料层级使用四舍五入后的物品等级。100 级会产出中型废料；服务器有哪些层级，取决于它提供的物品。
废料是物品系统其余部分的基础。
拆解成功率：默认对每个提交的物品逐一进行 75% 的判定，即使它们在同一堆叠中。一旦所需废料可以生成，提交的所有物品都会消耗，包括失败的部分。菜单会报告成功和失败的数量。背包装不下的废料会掉在玩家位置。
修理精英物品
精英物品可以在修理匠 NPC 处使用废料修理。物品的受损程度决定了修好它所需废料的数量和大小。
修理量：每种废料修复固定数量的耐久：
- 微小废料：100 点耐久
- 小型废料：200 点耐久
- 中型废料：300 点耐久
- 大型废料：400 点耐久
- 巨型废料：500 点耐久
每次修理消耗一个废料，最多恢复表中所列耐久，且不会超过满耐久。严重受损的物品可能需要多次修理或更高层级的废料。确认修理未受损的物品也会消耗废料。
为精英物品附魔
在我们开始描述如何为物品附魔之前，建议你先熟悉附魔所需的物品并了解它们的作用。
精英物品
精英物品泛指 EliteMobs 商店中出售的、精英怪掉落的、或作为完成任务奖励获得的任何战利品，等等。
附魔书
附魔书通常由精英怪掉落，或在竞技场和任务中作为奖励授予玩家。它们包含玩家可以转移到目标物品上的附魔。
幸运券
幸运券通常从精英怪处获得，或在竞技场和任务中作为奖励获得，它能让玩家在为物品附魔时的成功几率翻倍。
玩家可以通过前往冒险者公会中的附魔师 NPC，或使用 /em 菜单来打开附魔界面。
同时拥有一件精英物品和一本附魔书时，玩家就可以尝试把书中存储的附魔添加到物品上。每次尝试都会消耗玩家一定数量的精英金币。如果他们拥有幸运券，还可以用它让几率翻倍。
附魔消耗：价格是 (附魔权重 + 1)^4 精英金币。权重统计的是附魔等级，而不是不同名称的数量：包括原生附魔或书中存储的等级、自定义效果等级，以及支持的强化原生附魔超过原版上限的部分。例如锋利 III 贡献三个原生等级。菜单显示实际物品的报价。
示例：
- 权重 0：1 金币
- 权重 1：16 金币
- 权重 2：81 金币
- 权重 5：1,296 金币
- 权重 10：14,641 金币
成功率：基础成功率为 min(1, 4 / (附魔权重 + 1))，在随机判定前保留两位小数。例如：
- 权重 0：400%（上限为 100%）
- 权重 1：200%（上限为 100%）
- 权重 5：67%
- 权重 10：36%
默认情况下，幸运券会在应用上限和舍入之前，将未舍入的成功率乘以二。它也会将配置的致命失败系数减半。最终销毁概率还取决于剩余概率和舍入，因此并非简单地将未使用幸运券时显示的概率减半。
附魔叠加：等级相加，例如锋利 III + 锋利 II = 锋利 V。完整结果必须通过配置的等级限制和兼容性检查。原生附魔必须启用；自定义效果需要有效的提供方，并符合目标的装备或魔法武器类型。无效组合会在付款前被拒绝。原生附魔书不需要 EliteMobs 自定义物品 ID，但必须包含有效且受支持的附魔。
在菜单中放入一件精英物品、一本附魔书以及可选的一张幸运券，然后确认。每次以正常游戏结果结束的尝试都会消耗书、付款和投入的幸运券，结果如下：
- 成功： 附魔被添加到物品上。（几率取决于当前附魔）
- 失败： 尝试未成功，损失附魔书和精英金币。物品会安全返还。（在成功、致命失败和挑战之后剩下的几率）
- 致命失败： 失去书、金币和物品。配置系数为成功后剩余概率的 1%，幸运券将该系数减半；所得概率保留两位小数。
- 挑战： 进入一场 Boss 战，失败时有 10% 的几率触发致命失败。若玩家获胜，物品就会被附魔。（在计算成功和致命失败之后剩余几率的 30%）
附魔权重大于 10 的物品可能触发全服公告。当前实现同时将 successAnnouncement 作为布尔值和消息字符串读取，没有单独的 announceImportantEnchantments YAML 键。这种类型冲突使该设置无法作为可靠的独立公告开关。
如果抽到挑战但没有可用的已安装挑战，或其启动事件被取消，尝试立即成功。挑战启动进入队列后的故障则会中止尝试，并尝试退还物品和付款。挑战是私人实例，不接受队伍进入或额外玩家。系统会在挑战期间和结算前检查提供方的兼容性。
购买会在扣币前后检查当前投入物品和提供方兼容性。购买前关闭菜单会退还投入物品。结算时背包装不下的物品会掉在玩家位置；无法确定或玩家离线时的交付会记录下来供恢复处理。
如果无法安全确定付款、退款或物品交付状态，服务器会在 plugins/EliteMobs/enchantment_recovery/ 下写入交易记录，并告知玩家参考 ID。管理员必须手动核对付款和物品状态，不能盲目重复结果不明的交付或扣款。基础设施故障导致的中止会尝试退还原物品、书、幸运券和付款；普通游戏失败则会消耗已购买的尝试。
附魔相关配置
附魔设置位于 SpecialItemSystems.yml，拆解成功率位于拆解员菜单配置中。
| 键 | 文件 | 默认值 | 效果 |
|---|---|---|---|
luckyTicketMultiplier | SpecialItemSystems.yml | 2.0 | 使用幸运券时应用于成功几率的倍率 |
criticalFailureChanceV2 | SpecialItemSystems.yml | 0.01 | 剩余（非成功）几率中变成致命失败的比例。幸运券会将其减半 |
challengeChance | SpecialItemSystems.yml | 0.30 | 在成功和致命失败之后剩余几率中变成 Boss 挑战的比例 |
criticalFailureChanceDuringChallengeChance | SpecialItemSystems.yml | 0.10 | 挑战战斗失败时丢失物品的几率 |
scrapChance | 拆解员菜单配置 | 0.75 | 拆解物品时实际产出废料的几率 |
概率按顺序计算，每一步都保留两位小数：成功、从非成功剩余部分计算致命失败、从下一剩余部分计算挑战，最后是普通失败。一次随机抽样决定结果。默认设置、权重 10、无幸运券时，报价为成功 36%、致命失败 1%、挑战 19%、失败 44%。100% 的成功率保证成功。概率设置无效或价格超出支持的整数范围时，购买会被阻止。
视觉示例
MagmaGuy 讲解部分系统的视频。
制作你自己的附魔书
下面是一份简短的指南，说明你可以如何制作自己的附魔书。
isEnabled
设置该物品是否启用。
| 键 | 取值 | 默认值 |
|---|---|---|
isEnabled | 布尔值 | true |
示例
isEnabled: true
name
设置物品的名称。支持 Color Codes。
| 键 | 取值 | 默认值 |
|---|---|---|
name | 字符串 | 无 |
示例
name: '&aElite Custom Enchanted Book'
lore
设置物品的说明文字。支持 Color Codes。
| 键 | 取值 | 默认值 |
|---|---|---|
lore | 字符串列表 | 无 |
示例
lore:
- '&2Use this custom book to'
- '&2enchant items at the enchanter!'
material
使用 ENCHANTED_BOOK。附魔师需要真正的附魔书，不接受带有附魔元数据的普通 BOOK。
| 键 | 取值 | 默认值 |
|---|---|---|
material | ENCHANTED_BOOK | 无 |
示例
material: ENCHANTED_BOOK
enchantments
设置该物品应携带哪些附魔。
| 键 | 取值 | 默认值 |
|---|---|---|
enchantments | Minecraft 附魔 或 EliteMobs 附魔 | 无 |
示例
enchantments:
- elitemobs:earthquake,1
itemType
设置你可以从哪里获得该物品。如果你想让你的书由随机精英怪掉落并在商店中出售，可以把它设为 custom。
否则你可以把它设为 unique，让它只从配置的战利品表中掉落。
| 键 | 取值 | 默认值 |
|---|---|---|
itemType | 取值 | 无 |
示例
itemType: custom
soulbound
设置书是否绑定给接收者。设为 false 可允许交易。
| 键 | 取值 | 默认值 |
|---|---|---|
soulbound | 布尔值 | true |
示例
soulbound: true
附魔书示例
附魔书配置示例
isEnabled: true
material: ENCHANTED_BOOK
name: '&5Excellent Mining Enchanted Book'
lore:
- '&2Used to enchant items at the enchanter!'
enchantments:
- MENDING,1
- elitemobs:drilling,1
itemType: UNIQUE
soulbound: false
如你所见，制作你自己的附魔书并不复杂。大多数设置都是你在创建物品时会用到的常规设置。
示例书包含原生附魔 MENDING 和自定义效果 elitemobs:drilling。
这会让我们的示例书成为一本你会很想用在镐上的优秀书籍。
致服务器管理员：表中列出可配置的概率。当前实现中的四次方价格公式和修理量是固定的。玩家应在确认前检查菜单报价和服务器设置。