高级位移器修改

高级传送符咒修改 (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|燃料添加量|经验消耗 配置即可。