Ultimine Unchained

每个加载器各有一个文件，适用于 FTB Ultimine 支持的 Minecraft 1.20.1 至 1.21.1 版本。需要安装 FTB Ultimine。

⭐ 功能介绍

这是 FTB Ultimine 的 Mixin 补丁，并非独立的脉矿挖掘模组。所有形状、按键和目标仍由 FTB Ultimine 提供。它会改变操作的三项行为。

• 遵循你选择的形状 – FTB Ultimine 会将每个方块与第一个被选中的方块比较，并跳过硬度更高的方块，即使你的工具完全可以挖掘它们。此检查默认会被禁用。
• 真正无法破坏的方块仍会跳过 – 例如基岩、屏障，以及任何破坏速度为负数的方块，无论设置如何。
• 耐久消耗由你决定 – 可以为整个操作设置一个固定消耗量，单位为等效方块破坏次数；也可以按实际破坏的方块数量百分比计算。
• 耐久附魔仍然生效 – 每一点计算出的伤害都会按附魔效果进行判定，与原版工具损耗机制相同。
• 单次操作不会让工具耐久大幅缩水 – 消耗量上限设为最大耐久度的一定百分比，默认为 25%，因此耐久度为 2000 的工具单次最多损失 500 点耐久。
• 而且绝不会损坏 – 消耗量最多只会让工具损失到剩余 1 点耐久。创造模式玩家不会消耗耐久。

📋 所需条件

• Fabric 上的 Minecraft 1.20.1、1.20.4、1.20.5、1.20.6、1.21 或 1.21.1。
• Forge 上的 Minecraft 1.20.1 或 1.20.4；也包括 NeoForge 的 1.20.1 分支。
• NeoForge 上的 Minecraft 1.20.4、1.20.6、1.21 或 1.21.1。
• 不支持 Minecraft 1.20.2、1.20.3，也不支持 NeoForge 上的 1.20.5：FTB Ultimine 没有这些版本的构建。
• 与你的 Minecraft 版本和加载器相匹配的 FTB Ultimine。没有它，此模组无法运行。FTB Ultimine 也有自己的依赖项，包括 FTB Library 和 Architectury API。
• Fabric 上需要 Fabric API 和 Cloth Config；Minecraft 1.20.1 需要 Fabric Loader 0.14.23 或更高版本，1.20.4 至 1.20.6 需要 0.15.11 或更高版本，1.21 和 1.21.1 需要 0.19.2 或更高版本。
• Minecraft 1.20.1 需要 Forge 47.1 或更高版本；1.20.4 需要 49 或更高版本。
• Minecraft 1.20.4 的 NeoForge 需要 20.4 或更高版本；1.20.6 需要 20.6 或更高版本；1.21 和 1.21.1 需要 21.0 或更高版本。
• Minecraft 1.20.1 至 1.20.4 需要 Java 17 或更高版本；从 1.20.5 起需要 Java 21 或更高版本。

📥 安装

1. 安装加载器和 FTB Ultimine 及其依赖项；如果使用 Fabric，还要安装 Fabric API 和 Cloth Config。
2. 使用 Modrinth App 安装，或将适用于你的加载器的 jar 文件下载到 mods 文件夹。每个加载器对应的 jar 都适用于上文列出的该加载器支持的所有 Minecraft 版本。
3. 对硬度不同的方块使用 Ultimine。整个形状都会被破坏，而工具最多只损失 1 点耐久。

⚙️ 配置

在 Fabric 上，编辑 config/ultimineunchained.json。在 Forge 和 NeoForge 上，编辑 <world>/serverconfig/ultimineunchained-server.toml（按世界单独配置并同步至客户端），以及 config/ultimineunchained-common.toml 中的 check_for_updates。所有加载器都没有游戏内设置界面。

| 设置 | 默认值 | 作用 |
|—|—|—|
| allow_harder_blocks | true | 忽略对较难破坏方块的跳过处理，因此形状范围内所有工具可破坏的方块都会被破坏。 |
| durability_percentage | 0 | 计入耐久消耗的已破坏方块比例。大于 0 时会覆盖固定消耗。 |
| durability_flat_blocks | 1 | 每次操作的固定消耗，以破坏方块数计，范围为 0 到 32768。百分比为 0 时使用此值。 |
| durability_cap_percent | 25 | 单次操作最多可消耗的耐久占最大耐久的百分比，无论上述设置要求消耗多少。 |
| check_for_updates | true | 每次启动游戏时检查一次 https://alkeari.com/updates/ultimine-unchained.json；仅当有适用于你当前 Minecraft 版本和加载器的更新版 Ultimine Unchained 时，才会在聊天栏中提示并附上链接。不会发送其他信息；关闭此项即可跳过检查。 |

Fabric 将相同设置命名为 allowHarderBlocks、durabilityPercentage、durabilityFlatBlocks、durabilityCapPercent 和 checkForUpdates。Fabric 会将百分比写成整数，因此 50 表示 50%；Forge 和 NeoForge 会将其写成小数，因此 0.5 表示相同的值。将固定方块数、百分比和上限都设为 0，即可完全移除耐久消耗。

🖥️ 兼容性

• 现有地图。 可以随时添加或移除此模组。在 Forge 和 NeoForge 上，它只会将设置文件写入地图的 serverconfig 文件夹；在 Fabric 上，不会向地图写入任何内容。
• 客户端或服务器。 它会改变操作的效果，因此应安装在运行 FTB Ultimine 的位置：服务器，或单人游戏中的集成服务器。
• 它适用于 FTB Ultimine 支持的所有工具类型和形状。
• 它不会影响 FTB Ultimine 的右键操作、耕地、剥皮和收割，也不会改变掉落物的计算方式。它只决定形状范围内哪些方块会被破坏，以及该操作的消耗。
• 在创造模式之外，无法用当前工具获得掉落物的方块会被跳过，而不会被破坏。
• 如果未来版本的 FTB Ultimine 更改了此模组所修改的方法，游戏将拒绝加载，而不会静默地无效运行。

🐛 支持

• 请在此模组的 Nexus Mods 页面报告错误并提出问题，所有报告都会得到跟进。
• 请提供 Minecraft 版本、加载器及其版本、模组版本、FTB Ultimine 版本，以及你安装的其他模组。

📄 许可

许可条款请参阅 Alkeari 许可协议。

所有版本、更新内容和反馈方式都可在项目页面查看：alkeari.com/projects/ultimine-unchained。

如果你想了解其工作原理，可以阅读源代码：github.com/Alkeari/UltimineUnchained-PUBLIC。