FTB Ultimine Addition (Forge/NeoForge/Fabric)

✨ 关于

Ultimine 需要解锁才能使用。FTB Ultimine Addition 是 FTB Ultimine 的附加模组，让连锁挖矿成为一项需要逐步培养的技能：完成挖矿挑战，一次学会一种 Ultimine 形状，逐阶解锁全部能力。

• 🔒 默认锁定：玩家达成解锁条件前无法使用 Ultimine
• 🎯 完成挑战：为镐、斧、铲和锄头设置挖矿目标
• 📜 学习形状：每完成一个阶级，就能为对应工具学会一种 Ultimine 形状
• ✏️ 自定义形状：在形状设计器中绘制形状并分享
• ⭐ 专精与精通：每个阶级都会为对应工具提供一个专精；精通卡牌可重新开始，并获得永久加成
• 📅 全服务器每日挑战
• ↩️ 撤销 Ultimine：还原误挖的矿脉
• ⚙️ 专为整合包打造：服务器设置同步；挑战、卡牌类型、形状和奖励均可通过数据包配置

📸 截图请见画廊标签页。完整指南请查看Wiki。

⛏️ 运作方式

1. 制作技能记录册。它是一本剪贴板，可收纳采矿技能卡和笔，并记录你的进度。
2. 加入采矿技能卡。每种工具各有一张卡：镐、斧、铲和锄头。每张卡都会提供对应工具的挖矿挑战，例如“挖掘 48 个铁矿石”。
3. 挖矿完成挑战。随身携带技能记录册，并挖掘挑战要求的方块。随着进度推进，笔会消耗墨水，记得及时补充。
4. 提升阶级。完成某一阶级的挑战后，卡牌就会晋升：未学习 → 新手 → 学徒 → 熟练 → 精通。
5. 解锁 Ultimine。每完成一个阶级，都会获得一张形状证书，为对应工具解锁一种 Ultimine 形状。四张卡牌全部精通后，即可制作矿工证书，永久解锁所有形状。

📋 技能记录册

• 🗂️ 收纳所有物品：四张采矿技能卡、一支笔和一个墨水匣
• ⌨️ 按 R 打开，也可以直接使用
• 🗺️ 卡牌查看器：展示卡牌从未学习到精通的进度；可平移、缩放，并右键点击挑战或阶级打开菜单
• 🎨 16 种染色款式：与染料合成即可制作；每种款式都有专属图案、动态背景和 HUD 配色

🎯 挑战

• 📖 完整详情：每项挑战的描述、所需方块、进度、奖励以及完成时间
• 📌 固定挑战，挖矿时可在 HUD 上追踪进度
• 🎲 重抽一项尚未开始且不喜欢的挑战：每个阶级可重抽一次，消耗少量墨水
• 🔥 连胜和幸运发现会在挖矿时带来额外点数
• 🛠️ 其他模组的工具也会计入，包括模组作者未加入工具标签的工具

📜 形状证书

• 🏅 每张卡每个阶级都有一张证书，由你选择它要解锁的 Ultimine 形状
• 🧰 按工具分别学习：镐的形状不会解锁斧头的形状
• 🔀 形状选择器：选择当前使用的形状，并将常用形状标星，让切换时只循环这些形状

✏️ 形状设计器

• 🧱 从形状选择器绘制自己的形状，最多可设计五层，并可旋转查看 3D 预览
• 🗃️ 保存多个形状，并可加载、替换或删除
• 📋 以 JSON 格式复制和粘贴来分享形状；该 JSON 也是数据包形状文件
• 🔐 不能走捷径：你只能为本来就能使用 Ultimine 的工具学习自己的形状

⭐ 专精与声望

• 🎁 每个阶级都能选择一项专精：为卡片对应的工具从两项专精中选一项。新手阶级提供实用小便利（磁力、活力、饱腹、节俭），学徒阶级提供更强的专精（触及、时运、洞察），专家阶级则有（扩域、狂热、不倦）
• 🔁 声望：让一张已精通的卡片重新开始，使该工具的 Ultimine 每次多挖 5% 的方块，最多可进行五次
• 📈 工具亲和：工具会累计用它 Ultimine 挖掘的方块数量，并获得少量专属加成

📅 每日挑战

• 🌍 整个服务器每天（或每周）共享一项挑战，无需卡片
• 🤝 队伍成员共享进度：一名成员完成的内容，也会计入在线队友的进度（支持 FTB Teams 或原版队伍）
• 🏆 专属奖励：经验，以及一段时间内可供对应工具使用的 Mine-Go Juice

🧪 Mine-Go Juice

• ⚗️ 用你的卡片酿造的药水，效果持续期间可使用对应工具进行 Ultimine
• 🎁 升阶时可短暂体验，让你立即试用新能力

↩️ 撤销 Ultimine

• 👻 先预览：按 Ctrl + Z，即可看到方块以半透明幽灵的形式返回
• 🌱 再次按 Ctrl + Z即可恢复方块；它们会依次重新长回原位
• ⚖️ 不会复制物品：会收回方块掉落的物品和经验，恢复的方块也不会再次计入挑战
• 📜 撤销历史：按 Ctrl + H查看仍可撤销的操作；剥皮、耕地和铺路也可以撤销
• 🕔 最近 5 分钟内的最后 5 次操作均可撤销，所有设置都可配置

⚙️ 服务器与整合包

• 🖥️ 游戏内配置界面：输入 /ultimine_addition config，或从模组列表 / Mod Menu 打开
• 🌐 服务器设置会同步给所有玩家，更改即时生效
• 🧩 数据包：可添加或修改挑战（包括条件、链式挑战和阶段）、适用于其他工具的 Mining Skill Card 类型、Ultimine 形状和奖励
• 🪝 钩子：提供函数标签和 KubeJS 事件，覆盖玩家进度的每个步骤
• 📊 统计数据：使用 /ultimine_addition stats查看统计和排行榜，并通过里程碑进度获得进度挑战

🎮 游玩模式

服务器所有者可以选择玩家解锁 Ultimine 的方式（general.playstyle_mode）：

服务器运行期间也可以更改模式，且更改会立即生效。

📦 所需内容

Fabric 版本还需要 Fabric API。

CoolCatLib 现在是一个模组。它以前分为两个模组：CoolCatLib: Core 和 CoolCatLib: Canvas；更新时请删除这两个旧版 jar 文件。从 8.0.0 版本起，此模组需要 CoolCatLib 8.0.0 或更高版本，请同时更新这两个模组。

FTB Ultimine：在 26.1.2 版本中，8.0.1 及更高版本需要 FTB Ultimine 26.1.2.6 或更高版本。

可选：JEI（查看所有物品的配方和信息）、Curios（NeoForge/Forge）或 Trinkets（Fabric）（用于技能记录栏位）、FTB Teams（用于团队每日挑战），以及 KubeJS（用于脚本事件）。

🐞 崩溃与错误报告

请在这里报告问题，不要向 FTB 报告。FTB Ultimine Addition 通过 mixin 更改了 FTB Ultimine 的运作方式。因此，如果崩溃或错误信息中提到了来自 ultimine_addition 的 mixin（例如 ultimine_addition.common.mixins.json 或 FTBUltimineMixin），或者安装此模组后 Ultimine 才出现异常，那么问题出在此模组，而不是 FTB Ultimine。

• 📝 在 GitHub 提交问题，并附上崩溃报告或 latest.log，以及你的 Minecraft、加载器、FTB Ultimine 和 FTB Ultimine Addition 版本。你也可以在 Discord 上提问。
• 🔄 请先检查是否有更新：FTB Ultimine 的新版本可能会导致此模组暂时无法正常工作，直到此模组完成适配。
• 🙏 请勿在 FTB Ultimine 的问题追踪器中报告这些问题：FTB 团队无法修复此模组导致的错误。

⌨️ 按键

所有按键都可以在控制菜单中更改。