pathing: stabilize 0-replan round-trip on ledge/descend runs

Fix a cluster of execution-layer issues that caused replans and void
falls when traversing narrow ledges and multi-block descents between
(251.5,141,210.5) and (252.5,138,220.5):

- WalkTemplate / GroundedSegmentController: suppress the pre-rotation
  bias toward the next segment's exit heading on stable-footing Turn
  exits where the next segment is not a jump.  The next template
  snaps yaw on its first tick anyway, and pre-rotating mid-stride on
  a 1-block walkway pushes sprint drift perpendicular to the path and
  walks the bot off the edge.  Turn exits into a jump still get the
  bias so the takeoff direction stays aligned.

- GroundedSegmentController.ShouldComplete: relax the headingReady
  gate for Turn exits with stable footing so the segment can complete
  once yaw is aligned with either the current or the next segment
  heading (within 25/15 deg).  Without this the removed bias would
  leave the bot stuck at the end of a walkway waiting for a rotation
  that never happens.

- DescendTemplate: restrict the airborne exit-heading bias so it only
  kicks in when the footprint is inside the landing block, or on
  single-step drops where the fall is too short for lateral drift to
  miss the landing column.  On 2+ block drops the bot now keeps yaw
  pointed at the landing center for the whole fall.

- DescendTemplate: add a multi-block overshoot guard on PrepareJump
  exits.  Once airborne and past the landing end-plane on a 2+ Y
  drop, release forward/sprint and press back briefly so air drag
  pulls the bot back into the 1x1 landing column instead of sailing
  one block past it into the neighbouring void.

Live round-trip between the two goal coordinates now completes with
zero replans in three consecutive runs in each direction.  Full unit
test suite is unchanged from the pre-existing baseline (22 failing
tests, all orthogonal to this change).

Made-with: Cursor
This commit is contained in:
BruceChen 2026-04-22 16:43:43 +00:00
parent d002930a6a
commit 5de169db64
19 changed files with 1418 additions and 171 deletions

View file

@ -3528,6 +3528,42 @@ namespace MinecraftClient {
}
}
/// <summary>
/// Looks up a localized string similar to Planning path in background (budget: {0}ms)... result will appear in the log.
/// </summary>
internal static string cmd_goto_planning {
get {
return ResourceManager.GetString("cmd.goto.planning", resourceCulture);
}
}
/// <summary>
/// Looks up a localized string similar to toggle verbose pathing diagnostics (full plan dump, failure trace).
/// </summary>
internal static string cmd_pathdiag_desc {
get {
return ResourceManager.GetString("cmd.pathdiag.desc", resourceCulture);
}
}
/// <summary>
/// Looks up a localized string similar to Pathing diagnostics enabled. Run /pathdiag off to disable.
/// </summary>
internal static string cmd_pathdiag_enabled {
get {
return ResourceManager.GetString("cmd.pathdiag.enabled", resourceCulture);
}
}
/// <summary>
/// Looks up a localized string similar to Pathing diagnostics disabled.
/// </summary>
internal static string cmd_pathdiag_disabled {
get {
return ResourceManager.GetString("cmd.pathdiag.disabled", resourceCulture);
}
}
/// <summary>
/// Looks up a localized string similar to [PathMetric] routeStart segments={0}.
/// </summary>

View file

@ -1252,6 +1252,18 @@ Change EnableEmoji=false in the settings if the display is confusing.</value>
<data name="cmd.goto.failed" xml:space="preserve">
<value>No path found ({0} nodes explored in {1}ms)</value>
</data>
<data name="cmd.goto.planning" xml:space="preserve">
<value>Planning path in background (budget: {0}ms)... result will appear in the log.</value>
</data>
<data name="cmd.pathdiag.desc" xml:space="preserve">
<value>toggle verbose pathing diagnostics (full plan dump, failure trace).</value>
</data>
<data name="cmd.pathdiag.enabled" xml:space="preserve">
<value>Pathing diagnostics enabled. Run /pathdiag off to disable.</value>
</data>
<data name="cmd.pathdiag.disabled" xml:space="preserve">
<value>Pathing diagnostics disabled.</value>
</data>
<data name="pathing.metric.route_start" xml:space="preserve">
<value>[PathMetric] routeStart segments={0}</value>
</data>