fix(runtime): wander/explore.far probe-then-go (bot actually moves)

Ground-truth finding (diag.physics):
  forward N:0.03 E:3.38 S:0 W:3.26  → forward WORKS in unobstructed dirs
  jump ΔY=1.25                       → jump WORKS (vanilla height)
  dig untested (no soft block within 6 of spawn)

So the bot CAN move and jump — the previous "stands still" symptom was
our wander/explore code picking blocked random angles and trusting a
pathfinder that times out on this server's terrain. Each retry just
picked another random direction, often the same blocked one.

- runtime/actions.js wander: probe 4 cardinal yaws for 800ms each,
  measure actual Δ, commit to the best one for the remaining budget.
  Falls back to "wedged-jump" (forward+jump 2.5s) only when ALL four
  cardinals are <0.5 blocks.
- runtime/skills/explore-far.js: same probe-then-go shape, scaled to a
  ~48-block long walk in the best direction. Replaces the static
  NE/SE/SW/NW quadrant rotation that ignored what was actually
  walkable.
- runtime/movement-profiles.js: canDig back to true on gather/travel/
  flee. The earlier "everything false" defensive default was based on
  a wrong hypothesis (silent dig failure) — diag.physics + server-side
  inspection (no anti-cheat plugin, spawn-protection=0) showed dig is
  fine.
- runtime/compat.test.js: assertions follow profile defaults.
- runtime/skills/diagnose-physics.js: forward probe now tries 4
  cardinals and returns trials + bestDir + bestDist so it can be used
  to debug "wedged" reports later.

Verified live: bot now actually walks 47 blocks north after
probe.cardinal showed N:2.4 free. First end-to-end real movement on
play.xmatic.team since this session started.

npm test 124/124.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-26 12:05:14 +03:00
co-authored by Claude Opus 4.7
parent 86f0c1799e
commit 0aae5e2e68
5 changed files with 190 additions and 93 deletions
+40 -13
View File
@@ -21,19 +21,45 @@ function withTimeout(promise, ms, label) {
return Promise.race([promise, timeout]).finally(() => clearTimeout(timer));
}
async function probeForward(bot, durationMs = 2_000) {
// Probe forward by trying every cardinal direction in sequence and
// keeping the BEST result. If the bot is wedged on a single side
// (treetop with leaves on one side, open air on the other) we still
// get a true positive instead of a false "BROKEN".
async function probeForward(bot, durationMsPerDir = 1_200) {
const before = bot.entity.position.clone();
try {
bot.setControlState("forward", true);
await new Promise((r) => setTimeout(r, durationMs));
} finally {
bot.setControlState("forward", false);
const trials = [];
const yaws = [
{ name: "N", yaw: Math.PI }, // -Z
{ name: "E", yaw: -Math.PI / 2 }, // +X
{ name: "S", yaw: 0 }, // +Z
{ name: "W", yaw: Math.PI / 2 }, // -X
];
for (const { name, yaw } of yaws) {
try { await bot.look(yaw, 0, true); } catch {}
const t0 = bot.entity.position.clone();
try {
bot.setControlState("forward", true);
await new Promise((r) => setTimeout(r, durationMsPerDir));
} finally {
bot.setControlState("forward", false);
}
const t1 = bot.entity.position;
const dx = t1.x - t0.x;
const dz = t1.z - t0.z;
const dist = Math.hypot(dx, dz);
trials.push({ dir: name, dist });
// settle gravity
await new Promise((r) => setTimeout(r, 300));
}
const after = bot.entity.position;
const dx = after.x - before.x;
const dz = after.z - before.z;
const dist = Math.hypot(dx, dz);
return { before, after: after.clone(), dist, works: dist > 0.5 };
const best = trials.reduce((b, t) => (t.dist > b.dist ? t : b), { dir: "?", dist: 0 });
const after = bot.entity.position.clone();
return {
before, after,
trials,
bestDir: best.dir,
bestDist: best.dist,
works: best.dist > 0.5,
};
}
async function probeJump(bot) {
@@ -88,7 +114,8 @@ export const skill = Object.freeze({
info("action", "diag.physics: starting probe");
const fwd = await probeForward(bot);
info("action", `diag.physics: forward Δ=${fwd.dist.toFixed(2)} (${fwd.works ? "OK" : "BROKEN"})`);
const trialsStr = fwd.trials?.map((t) => `${t.dir}:${t.dist.toFixed(1)}`).join(" ") ?? "?";
info("action", `diag.physics: forward bestΔ=${fwd.bestDist.toFixed(2)} (${fwd.bestDir}) trials=[${trialsStr}] (${fwd.works ? "OK" : "BROKEN"})`);
const jmp = await probeJump(bot);
info("action", `diag.physics: jump ΔY=${jmp.deltaY.toFixed(2)} (${jmp.works ? "OK" : "BROKEN"})`);
@@ -96,7 +123,7 @@ export const skill = Object.freeze({
const dig = await probeDig(bot);
info("action", `diag.physics: dig ${dig.before ?? "?"}${dig.after ?? "?"} (${dig.works ? "OK" : "BROKEN"}: ${dig.reason ?? ""})`);
const summary = `physics probe: forward=${fwd.works ? "ok" : "BROKEN"}(Δ${fwd.dist.toFixed(1)}) jump=${jmp.works ? "ok" : "BROKEN"}(Δy${jmp.deltaY.toFixed(1)}) dig=${dig.works ? "ok" : "BROKEN"}(${dig.before ?? "no-target"}${dig.after ?? "?"})`;
const summary = `physics probe: forward=${fwd.works ? "ok" : "BROKEN"}(best=${fwd.bestDir}@${fwd.bestDist.toFixed(1)}) jump=${jmp.works ? "ok" : "BROKEN"}(Δy${jmp.deltaY.toFixed(1)}) dig=${dig.works ? "ok" : "BROKEN"}(${dig.before ?? "no-target"}${dig.after ?? "?"})`;
appendDiary(summary);
return {