# AutoDig 自动挖矿模组

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

## 功能特性

### 挖矿任务
- **主世界模式**：在指定 Y 层沿玩家朝向挖鱼骨巷道（主干 + 两侧侧支），自动返回地表；可自定义挖掘层、主干长度、支巷长度、目标矿物（默认钻石）。巷道推进同时会**扫描周围 10 格的目标矿物并自动绕道挖掉**，巷道壁旁的钻石不漏挖。
- **下界模式**：自动进传送门进入下界挖矿（默认远古残骸），挖够数量 / 背包满 / 血量低 / 装备耐久低时自动回主世界；支持无限挖（目标数量 -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.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 响应式布局、主世界/下界模式分离、装备耐久保护、自定义矿物。