Advanced Dislocator Modify

高级传送符咒修改

一个 Minecraft Forge 1.20.1 模组，通过 Mixins 修改 Draconic Evolution 的 Advanced Dislocator 燃料机制。

原版行为是只接受末影珍珠、每个 +1 燃料、不消耗经验；本模组则让你完全自定义哪些物品可以为 Advanced Dislocator 提供燃料、每个物品提供多少燃料，以及消耗多少经验（固定值或百分比）。

---

特性

• 可配置燃料物品——自定义燃料物品列表，每个物品可单独设置燃料量和经验消耗。
• 固定或百分比经验消耗——可消耗固定经验点数（例如 5）、玩家当前经验的百分比（例如 10%），或组合消耗（例如 100&5%）。
• 精确经验计算——经验根据玩家当前等级 + 进度计算（与经验条一致），而不是使用不可靠的 totalExperience 字段。
• 客户端 GUI 增强——将鼠标悬停在“添加燃料”按钮（±1 / ±16 / 全部）上时，会显示该操作将消耗的具体内容。
• “燃料已满”保护——当传送符咒已满时，客户端会阻止发送添加燃料请求并显示提示。
• 双语——游戏内消息支持英文和简体中文。

---

配置

配置文件位于服务端（由服务端使用并应用于燃料逻辑）。

唯一的设置项是 advancedDislocatorFuels——一个字符串列表，格式如下：

itemId|fuelAmount|xpCost

字段	说明	示例
itemId	用作燃料的已注册物品 ID	minecraft:ender_pearl
fuelAmount	每消耗一个物品增加的燃料量（非负整数）	1
xpCost	每个物品消耗的经验：固定值、百分比或组合	0、5、10%、100&5%

经验消耗语法

• 固定：5——扣除 5 点经验。
• 百分比：10%——扣除玩家当前经验的 10%。
• 组合：100&5%——先扣除当前经验的 5%，再扣除 100 点固定经验。

示例配置：

minecraft:ender_pearl|1|0
minecraft:ender_eye|4|10%

这表示：末影珍珠提供 +1 燃料且不消耗经验；末影之眼提供 +4 燃料并消耗玩家当前经验的 10%。

默认值： ["minecraft:ender_pearl|1|0"]——如果想保留原版行为，请保留此条目。

校验规则

• 每个条目必须恰好包含 3 个部分，以 | 分隔。
• 物品 ID 必须存在于注册表中。
• 燃料量和经验值必须为非负整数；百分比必须在 0 和 100 之间。
• 无效条目会以 WARN 级别记录并跳过——模组不会崩溃。

---

需求

项目	值
Minecraft	1.20.1
加载器	Forge 47.x
必需依赖	Draconic Evolution（draconicevolution [3.1.2,)）

---

常见问题

问：这个模组只能服务端使用吗？
答：配置位于服务端。虽然它同时运行在客户端和服务端，但燃料逻辑和权威配置都在服务端，因此请确保服务端（以及客户端，以便正确预测）都安装了该模组。

问：可以同时使用多个物品作为燃料吗？
答：可以。你可以添加任意数量的 itemId|fuelAmount|xpCost 条目。

---

高级传送符咒修改(Advanced Dislocator Modify)

一个 Minecraft Forge 1.20.1 模组，通过 Mixin 修改 Draconic Evolution（龙之研究） 的「高级传送符咒」（Advanced Dislocator）燃料机制。

与原版「只能用末影珍珠、每次 +1 燃料、不耗经验」不同，本模组允许你 完全自定义 哪些物品可以为高级传送符咒添加燃料、每个物品增加多少燃料、以及每次消耗多少经验（固定值或百分比）。

---

功能特性

• 可自定义燃料物品 — 自行定义燃料物品列表，每个物品可单独设置燃料量与经验消耗。
• 固定值或百分比经验消耗 — 可扣除固定经验值（如 5），或扣除玩家当前经验的百分比（如 10%），也支持两者组合（如 100&5%）。
• 经验计算精准 — 经验按玩家当前等级 + 进度（与经验条一致）计算，而非不可靠的 totalExperience 字段。
• 客户端 GUI 增强 — 「添加燃料」按钮（±1 / ±16 / 全部）的悬停提示会明确显示本次操作将消耗什么、消耗多少。
• 「燃料已满」保护 — 燃料已满时，客户端会拦截发送「添加燃料」请求，并弹出 toast 提示。
• 双语支持 — 游戏内提示支持简体中文与英文。

---

配置文件

配置文件为 SERVER 类型（由服务端持有并作用于燃料添加逻辑）。

唯一的配置项为 advancedDislocatorFuels —— 字符串列表，每项格式：

物品id|燃料添加量|经验消耗

字段	说明	示例
物品id	作为燃料的物品注册名	minecraft:ender_pearl
燃料添加量	每次消耗 1 个物品增加的燃料值（非负整数）	1
经验消耗	每次消耗该物品扣除的经验：固定值、百分比或组合	0、5、10%、100&5%

经验消耗语法

• 固定值：5 —— 固定扣除 5 点经验。
• 百分比：10% —— 扣除玩家当前经验的 10%。
• 组合：100&5% —— 先扣当前经验的 5%，再固定扣 100 点经验。

配置示例：

minecraft:ender_pearl|1|0
minecraft:ender_eye|4|10%

以上表示：末影珍珠每次 +1 燃料、不耗经验；末影之眼每次 +4 燃料、消耗玩家当前经验的 10%。

默认值： ["minecraft:ender_pearl|1|0"] —— 如需保留原版行为，请保留这一条配置。

校验规则

• 每条必须恰好 3 段，用 | 分隔。
• 物品 id 必须存在于游戏注册表中。
• 燃料量、经验值为非负整数；百分比经验必须在 0–100 之间。
• 非法条目会记录 WARN 日志并跳过 —— 模组不会崩溃。

---

环境要求

项目	值
Minecraft	1.20.1
加载器	Forge 47.x
必装前置	Draconic Evolution（draconicevolution [3.1.2,)）

---

常见问题

问：只在服务端生效吗？
答：配置文件是 SERVER 类型。模组在客户端与服务端都会加载，但燃料逻辑与权威配置在服务端，请确保服务端（以及用于正确预测的客户端）都安装了本模组。

问：可以同时设置多种燃料吗？
答：可以。按需列出任意多条 物品id|燃料添加量|经验消耗 配置即可。