文件
AutoDig/README.md
T
lyizai 61c9384881 feat: v2.2.1 主世界找矿绕道 + 工具适用性检查;移除自动火把
- 移除自动火把功能(按反馈不需要)
- 主世界挖矿新增矿物绕道:每秒扫描周围10格目标矿物并自动绕道挖掉,
  解决巷道壁旁钻石不挖的问题(此前只走巷道不主动找矿)
- 新增工具适用性检查:用 isSuitableFor 校验手持工具能否采掘目标矿物,
  远古残骸等自动换钻石镐;无合适工具时提示并暂停矿物挖掘
- 鱼骨支巷长度改为可配置 branchLength(默认10,原固定6)
- 目标矿物 id 兼容 minecraft: 前缀(带不带均可识别)
2026-08-31 12:47:26 +08:00

48 行
3.6 KiB
Markdown

# AutoDig 自动挖矿模组
一个基于 Fabric + Baritone 的 Minecraft 客户端自动挖矿模组,内置 Baritone 1.13.1(无需另行安装),支持主世界鱼骨巷道挖矿与下界自动挖矿返程。
## 功能特性
### 挖矿任务
- **主世界模式**:在指定 Y 层沿玩家朝向挖鱼骨巷道(主干 + 两侧侧支),自动返回地表;可自定义挖掘层、主干长度、支巷长度、目标矿物(默认钻石)。巷道推进同时会**扫描周围 10 格的目标矿物并自动绕道挖掉**,巷道壁旁的钻石不漏挖。
- **下界模式**:自动进传送门进入下界挖矿(默认远古残骸),挖够数量 / 背包满 / 血量低 / 装备耐久低时自动回主世界;支持无限挖(目标数量 -1)。
- **目标矿物 id**:带不带 `minecraft:` 前缀均可识别(如 `diamond_ore` 与 `minecraft:diamond_ore` 等价)。
### 智能辅助(可逐项开关)
- **工具自动选择**:挖掘前校验手持工具能否采掘目标矿物(如远古残骸必须钻石镐以上,铁镐只会白挖不掉落),不适用时自动从背包换上能采掘且耐久最高的工具;没有合适工具时提示并暂停矿物挖掘,放入工具后自动恢复。
- **自动切换工具**:由 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.1**:移除自动火把;新增主世界矿物绕道挖掘(附近 10 格目标矿物自动挖掉,不漏矿);新增工具适用性检查(远古残骸等自动换钻石镐);支巷长度可配置(默认 10);矿物 id 兼容 `minecraft:` 前缀。
- **v2.2.0**:新增实时状态 HUD、`/autodig status` 命令;自动进食跳过特殊食物;背包接近满提前丢垃圾防误判返程;杀戮光环不再误伤中立生物;GUI 补全进食/保命/攻击范围等设置。
- **v2.1.0**:自动换备用装备 + 背包满自动丢垃圾。
- **v2.0.x**:GUI 响应式布局、主世界/下界模式分离、装备耐久保护、自定义矿物。