Advanced Dislocator Modify

A Minecraft Forge 1.20.1 mod that modifies Draconic Evolution's Advanced Dislocator fuel mechanic through Mixins.

Instead of the vanilla behavior (ender pearls only, +1 fuel each, no XP cost), this mod lets you fully customize which items can fuel the Advanced Dislocator, how much fuel each one gives, and how much XP (fixed or percentage) is consumed.

Features

• Configurable fuel items — define your own list of fuel items, each with its own fuel amount and XP cost.
• Fixed or percentage XP cost — consume a fixed number of XP points (e.g. 5), a percentage of the player's current XP (e.g. 10%), or a combined cost (e.g. 100&5%).
• Full XP accuracy — XP is computed from the player's current level + progress (same as the XP bar), not the unreliable totalExperience field.
• Client GUI enhancements — hover tooltips on the "Add Fuel" buttons (±1 / ±16 / All) show exactly what each operation will consume.
• "Fuel full" guard — when the dislocator is already full, the client blocks sending the add-fuel request and shows a toast.
• Bilingual — English and Simplified Chinese in-game messages.

Configuration

The config file is SERVER-side (used by the server and applied to the fuel logic).

The single setting is advancedDislocatorFuels — a list of strings in the format:

itemId|fuelAmount|xpCost

XP cost syntax

• Fixed: 5 — deducts 5 XP points.
• Percentage: 10% — deducts 10% of the player's current XP.
• Combined: 100&5% — deducts 5% of current XP, then 100 fixed XP.

Example configuration:

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

This means: ender pearls give +1 fuel with no XP cost; ender eyes give +4 fuel and consume 10% of the player's current XP.

Default value: ["minecraft:ender_pearl|1|0"] — keep this entry if you want the original vanilla behavior preserved.

Validation rules

• Each entry must contain exactly 3 parts separated by |.
• The item ID must exist in the registry.
• Fuel amount and XP values must be non-negative integers; percentages must be between 0 and 100.
• Invalid entries are logged as WARN and skipped — the mod will not crash.

Requirements

FAQ

Q: Does this work server-side only? A: The config is SERVER-side. While it runs on both client and server, the fuel logic and the authoritative config live on the server, so make sure the server (and clients, for correct predictions) have the mod installed.

Q: Can multiple items be fuel at once? A: Yes. List as many itemId|fuelAmount|xpCost entries as you want.

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

经验消耗语法

• 固定值: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 日志并跳过 —— 模组不会崩溃。

环境要求

常见问题

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

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