AutoDig/README.md

AutoDig 自动挖矿模组

一个基于 Fabric + Baritone 的 Minecraft 客户端自动挖矿模组，内置 Baritone 1.13.1（无需另行安装），支持主世界鱼骨巷道挖矿与下界自动挖矿返程。

功能特性

挖矿任务

• 主世界模式：在指定 Y 层沿玩家朝向挖鱼骨巷道（主干 + 两侧侧支），自动返回地表；可自定义挖掘层、主干长度、支巷长度、目标矿物（默认钻石）。巷道推进同时会扫描周围 10 格的目标矿物并自动绕道挖掉，巷道壁旁的钻石不漏挖。
• 下界模式：自动进传送门进入下界，在配置的 Y 层（默认 15，远古残骸富集层）挖直巷逐点推进（巷道扫描式），主动挖方块暴露矿物——不依赖矿物扫描，服务器反作弊隐藏矿物时仍有效；巷道壁旁的目标矿物自动绕道挖掉；一条巷道挖完未挖够时方向旋转 90° 转移新区域继续，系统覆盖不乱走。挖够数量 / 背包满 / 血量低 / 装备耐久低时自动回主世界；支持无限挖（目标数量 -1）。
• 目标矿物 id：带不带 minecraft: 前缀均可识别（如 diamond_ore 与 minecraft:diamond_ore 等价）。

智能辅助（可逐项开关）

• 无路自动搭方块：开启后 Baritone 在没有路时（深渊、缺口、岩浆挡路）自动放置方块搭桥/垫脚；模组会自动把背包里的搭路方块（按清单）补进快捷栏供其使用，快捷栏物品永不自动丢弃。
• 工具自动选择：挖掘前校验手持工具能否采掘目标矿物（如远古残骸必须钻石镐以上，铁镐只会白挖不掉落），不适用时自动从背包换上能采掘且耐久最高的工具；没有合适工具时提示并暂停矿物挖掘，放入工具后自动恢复。
• 自动切换工具：由 Baritone 在挖掘途中自动选择最合适的工具。
• 自动进食：饥饿度低时自动吃背包食物，跳过金苹果等特殊/珍贵食物。
• 自动换备用装备：护甲/工具耐久过低时自动从背包换上同类备用装备。
• 提前丢垃圾：背包接近满（已用 ≥30 格）时就提前丢弃圆石、深板岩等垃圾，为矿物腾出空间，避免被误判"背包已满需返回"；快捷栏物品（搭路方块/工具/食物）永不丢弃。
• 杀戮光环：自动攻击附近真正敌对生物，不误伤铁傀儡、僵尸猪灵、末影人等中立生物。
• 保命优先：血线过低时暂停挖矿向上撤离，恢复后自动续任务。
• 装备耐久保护：护甲/工具耐久低于阈值时暂停或换装，下界模式直接返程。
• 死亡重生回点：重生后自动返回死亡地点继续任务。
• 实时状态 HUD：挖矿时屏幕左上角实时显示任务、状态、运行时长、血量、饥饿、背包、进度。

使用说明

1. 将 mod jar 放入 mods 文件夹（需 Fabric Loader 与 Fabric API）。
2. 进入游戏后按 Ctrl + R（或在按键设置中查看"打开 AutoDig 界面"）打开界面。
3. 选择任务（主世界 / 下界），按需调整设置，点击"开始"。

命令

命令	说明
/autodig gui	打开设置界面
/autodig start overworld / start nether	直接启动对应任务
/autodig stop	停止当前任务
/autodig status	查看实时状态（任务/状态/时长/死亡/血量/饥饿）

配置文件

配置文件位于 Fabric 配置目录下的 autodig.json，也可在游戏内 GUI 修改。

版本记录

• v2.2.5：下界改为巷道扫描式挖矿（替代 mineByName）：在 y=15 层挖直巷逐点推进，主动挖方块暴露远古残骸，不依赖矿物扫描（反作弊下仍有效）；巷道挖完未挖够时旋转 90° 转移新区域继续，不再漫无目的乱走；新增下界设置（挖掘层 Y、巷道长度）。
• v2.2.4：空闲状态彻底静默——不开挖矿任务时不触发任何自动行为（杀戮光环、自动进食、丢垃圾、搭路、换装全部暂停），完全不干扰玩家正常游玩。
• v2.2.3：修复下界多个问题——垃圾清单补充灵魂沙/灵魂土/岩浆块/沙砾/下界砖；进食时不再被工具切换打断（镐子/食物来回切换）；下界挖掘重构：挖矿中不再每秒重发指令（解决灵魂沙抽搐/来回折返不挖），寻路失败不再误判"任务完成"回主世界，而是空闲一段时间后自动转移到新矿区继续找矿。
• v2.2.2：新增无路自动搭方块（可开关）：Baritone 放置方块搭桥/垫脚，自动补给快捷栏搭路方块并喂给 Baritone 可放置物品清单；AutoTrash 不再丢弃快捷栏物品。
• v2.2.1：移除自动火把；新增主世界矿物绕道挖掘（附近 10 格目标矿物自动挖掉，不漏矿）；新增工具适用性检查（远古残骸等自动换钻石镐）；支巷长度可配置（默认 10）；矿物 id 兼容 minecraft: 前缀。
• v2.2.0：新增实时状态 HUD、/autodig status 命令；自动进食跳过特殊食物；背包接近满提前丢垃圾防误判返程；杀戮光环不再误伤中立生物；GUI 补全进食/保命/攻击范围等设置。
• v2.1.0：自动换备用装备 + 背包满自动丢垃圾。
• v2.0.x：GUI 响应式布局、主世界/下界模式分离、装备耐久保护、自定义矿物。