feat: v2.2.1 主世界找矿绕道 + 工具适用性检查;移除自动火把

- 移除自动火把功能(按反馈不需要)
- 主世界挖矿新增矿物绕道:每秒扫描周围10格目标矿物并自动绕道挖掉,
  解决巷道壁旁钻石不挖的问题(此前只走巷道不主动找矿)
- 新增工具适用性检查:用 isSuitableFor 校验手持工具能否采掘目标矿物,
  远古残骸等自动换钻石镐;无合适工具时提示并暂停矿物挖掘
- 鱼骨支巷长度改为可配置 branchLength(默认10,原固定6)
- 目标矿物 id 兼容 minecraft: 前缀(带不带均可识别)
这个提交包含在:
lyizai
2026-08-31 12:47:26 +08:00
父节点 4135cdd117
当前提交 61c9384881
共修改 10 个文件,包含 294 行新增和 156 行删除
@@ -3,9 +3,15 @@ package autodig.client.miner;
import autodig.client.bridge.BaritoneBridge;
import autodig.client.config.DigConfig;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import net.minecraft.block.BlockState;
import net.minecraft.block.Blocks;
import net.minecraft.client.MinecraftClient;
import net.minecraft.entity.player.PlayerEntity;
import net.minecraft.registry.Registries;
import net.minecraft.util.Identifier;
import net.minecraft.util.math.BlockPos;
/**
@@ -13,9 +19,13 @@ import net.minecraft.util.math.BlockPos;
*
* <p>在指定的 Y 层,沿玩家朝向挖一条"主干隧道",并在主干上每隔
* {@code branchGap} 格向两侧各开一条侧支巷道,形成鱼骨状分布。
* 推进实现为:把鱼骨图案转成一串目标坐标 {@link GoalBlock},按顺序
* 派 Baritone 逐个前往;因为允许挖方块,Baritone 会走直线把挡路的方块
* 挖掉,从而挖出巷道。自动切换工具由 Baritone 的 {@code autoTool} 负责。</p>
* 推进实现为:把鱼骨图案转成一串目标坐标,按顺序派 Baritone 逐个前往;
* 因为允许挖方块,Baritone 会走直线把挡路的方块挖掉,从而挖出巷道。
* 自动切换工具由 Baritone 的 {@code autoTool} 负责。</p>
*
* <p>智能找矿:推进巷道的同时,周期性扫描玩家周围(默认 10 格)的目标矿物;
* 发现后临时绕道前往该矿物将其挖掉,再回到巷道计划继续推进。
* 这样巷道壁旁暴露的钻石等目标矿不会漏挖。</p>
*
* <p>遇到背包已满时提前结束,把控制权交还控制器(用于返回地表)。</p>
*/
@@ -37,9 +47,26 @@ public final class OverworldMiner {
private long lastLog;
/** 背包满连续持续的 tick 数(去抖:给自动丢垃圾留出腾位时间) */
private int fullTicks;
/** 矿物绕道目标;非 null 时优先前往挖掘该矿物 */
private BlockPos detourTarget;
/** 绕道已持续的 tick 数(超时放弃,避免卡死) */
private int detourTicks;
/** 上一次扫描附近矿物的时间戳(节流) */
private long lastOreScan;
/** 上次放弃的绕道点与时间(同一点短时间内不再重试,避免卡在不可达矿上) */
private BlockPos abandonedTarget;
private long abandonedAt;
/** 背包满去抖阈值(tick):连续这么久都满才认定为真满 */
private static final int FULL_DEBOUNCE_TICKS = 20;
/** 矿物扫描间隔(毫秒) */
private static final long ORE_SCAN_INTERVAL_MS = 1000;
/** 矿物扫描半径(方块) */
private static final int ORE_SCAN_RADIUS = 10;
/** 单次绕道超时(tick):超过则放弃该矿点回到巷道计划 */
private static final int DETOUR_TIMEOUT_TICKS = 400;
/** 同一矿点放弃后的重试冷却(毫秒) */
private static final long ABANDON_COOLDOWN_MS = 30_000;
public OverworldMiner(BaritoneBridge bridge) {
this.bridge = bridge;
@@ -59,7 +86,7 @@ public final class OverworldMiner {
this.yLevel = config.overworldLevel;
BlockPos stop = player.getBlockPos();
this.start = new BlockPos(stop.getX(), this.yLevel, stop.getZ());
int branchLen = 6;
int branchLen = Math.max(1, config.branchLength);
int branchGap = 8;
// 用玩家水平朝向(而非移动方向)确定挖矿方向,站着不动时也稳定
net.minecraft.util.math.Direction facing = player.getHorizontalFacing();
@@ -70,6 +97,10 @@ public final class OverworldMiner {
this.done = false;
this.full = false;
this.fullTicks = 0;
this.detourTarget = null;
this.detourTicks = 0;
this.abandonedTarget = null;
this.abandonedAt = 0;
}
private List<BlockPos> buildPlan(BlockPos base, int y, int trunkLen, int branchLen, int branchGap, int axis, int sign) {
@@ -100,9 +131,10 @@ public final class OverworldMiner {
/**
* 每帧推进一次。背包已满或走完全程则返回已完成。
*
* @param config 挖矿配置
* @param config 挖矿配置
* @param canMineOres 手持工具是否足以挖目标矿物(false 时跳过矿物绕道,避免白挖不掉落)
*/
public boolean tick(DigConfig config) {
public boolean tick(DigConfig config, boolean canMineOres) {
if (this.done) {
return true;
}
@@ -128,6 +160,12 @@ public final class OverworldMiner {
System.out.println("[AutoDig] overworld 结束:计划完成 step=" + this.step + " size=" + this.plan.size());
return true;
}
// ---- 矿物绕道挖掘:优先把附近暴露的目标矿物挖掉 ----
if (this.handleOreDetour(config, client, player, canMineOres)) {
return false; // 绕道期间不推进巷道
}
BlockPos target = this.plan.get(this.step);
double dist = this.distanceSq(player, target);
long now = System.currentTimeMillis();
@@ -152,6 +190,101 @@ public final class OverworldMiner {
return false;
}
/**
* 处理矿物绕道挖掘。
*
* @return true 表示当前正在绕道挖矿(调用方应暂停巷道推进)
*/
private boolean handleOreDetour(DigConfig config, MinecraftClient client, PlayerEntity player, boolean canMineOres) {
long now = System.currentTimeMillis();
if (this.detourTarget != null) {
BlockState state = client.world.getBlockState(this.detourTarget);
if (!this.isTargetOre(config, state)) {
// 已挖掉或目标失效:回到巷道计划
this.detourTarget = null;
return false;
}
this.detourTicks++;
if (this.detourTicks > DETOUR_TIMEOUT_TICKS) {
// 太久没挖到(不可达等):放弃该点并冷却
System.out.println("[AutoDig] overworld 绕道超时,放弃矿点: " + this.detourTarget);
this.abandonedTarget = this.detourTarget;
this.abandonedAt = now;
this.detourTarget = null;
return false;
}
if (now - this.lastIssue > 250) {
this.bridge.gotoBlock(this.detourTarget);
this.lastIssue = now;
}
return true;
}
// 节流扫描附近目标矿物
if (!canMineOres || now - this.lastOreScan < ORE_SCAN_INTERVAL_MS) {
return false;
}
this.lastOreScan = now;
BlockPos ore = this.findNearbyOre(config, client, player);
if (ore != null) {
this.detourTarget = ore;
this.detourTicks = 0;
this.bridge.gotoBlock(ore);
this.lastIssue = now;
System.out.println("[AutoDig] overworld 发现目标矿物,绕道挖掘: " + ore);
return true;
}
return false;
}
/** 在玩家周围扫描最近的目标矿物方块。 */
private BlockPos findNearbyOre(DigConfig config, MinecraftClient client, PlayerEntity player) {
Set<String> targets = this.targetOrePaths(config);
if (targets.isEmpty()) {
return null;
}
BlockPos best = null;
double bestDist = Double.MAX_VALUE;
for (BlockPos pos : BlockPos.iterateOutwards(player.getBlockPos(),
ORE_SCAN_RADIUS, ORE_SCAN_RADIUS, ORE_SCAN_RADIUS)) {
String path = Registries.BLOCK.getId(client.world.getBlockState(pos).getBlock()).getPath();
if (!targets.contains(path)) {
continue;
}
// 最近放弃过的矿点在冷却期内不再尝试
if (pos.equals(this.abandonedTarget)
&& System.currentTimeMillis() - this.abandonedAt < ABANDON_COOLDOWN_MS) {
continue;
}
double d = pos.getSquaredDistance(player.getBlockPos());
if (d < bestDist) {
bestDist = d;
best = pos.toImmutable();
}
}
return best;
}
/** 判断方块状态是否为配置中的目标矿物(按 path 匹配,兼容命名空间前缀)。 */
private boolean isTargetOre(DigConfig config, BlockState state) {
if (state.isOf(Blocks.AIR)) {
return false;
}
String path = Registries.BLOCK.getId(state.getBlock()).getPath();
return this.targetOrePaths(config).contains(path);
}
/** 目标矿物 path 集合(去命名空间,兼容 "minecraft:" 前缀写法)。 */
private Set<String> targetOrePaths(DigConfig config) {
Set<String> set = new HashSet<>();
for (String ore : config.getOverworldOreList()) {
String path = ore.contains(":") ? ore.substring(ore.indexOf(':') + 1) : ore;
if (!path.isBlank()) {
set.add(path);
}
}
return set;
}
private double distanceSq(PlayerEntity player, BlockPos target) {
double dx = player.getX() - (target.getX() + 0.5);
double dy = player.getY() - target.getY();
@@ -218,14 +351,4 @@ public final class OverworldMiner {
this.full = false;
this.fullTicks = 0;
}
/**
* 派发矿脉挖掘指令(用于在鱼骨巷道推进过程中遇到目标矿物时挖掉)。
* 由控制器在合适时机调用。
*/
public void mineOres(DigConfig config) {
if (!config.getOverworldOreList().isEmpty()) {
this.bridge.mineByName(-1, config.getOverworldOreList().toArray(String[]::new));
}
}
}