nav-climb_skill

Overview

This skill attempts exactly one adjacent climb forward, moving into a neighboring cell that is approximately one block higher (+1 Y). It performs an atomic navigation operation suitable for composition and does not build or alter terrain. The skill aligns the agent to block center and cardinal yaw, tries a walk-up first, and falls back to a jump-up if needed.

How this skill works

Before attempting the climb the agent snaps to the block center and to the nearest cardinal yaw and sets pitch to 0°. The skill verifies overhead and adjacent clearance at both source and destination using precise block checks (use dirs.up.blk for overhead). It then attempts a single forward elevation gain (walk-up then jump-up) and returns success with mode and displacement or a structured failure reason with diagnostics on collisions.

When to use it

• To move forward onto an existing neighboring block that is one block higher (+1 Y).
• When composing stepwise climbs for multi-block elevation changes (call repeatedly).
• When you need deterministic, atomic navigation actions in a planner.
• Before changing direction use nav-turn to select the forward heading.
• When no building or terrain modification is allowed or desired.

Best practices

• Ensure forward column has a walkable support at destination (fwd, y) and clear body/head spaces at y+1 and y+2.
• Rely on automatic alignment—don’t pre-offset position or yaw before calling the skill.
• On repeated failures, change strategy: lateral escape, remove overhangs, or pillar up rather than retrying.
• Check extra.diagnostics for collision cases to decide recovery (up_block, clear_fwd_head, clear_up_head).
• Use a short step_duration for responsiveness but keep default (0.6s) if step mechanics need stability.

Example use cases

• Advance onto a single-block ledge while exploring a cave or structure.
• Compose three successive nav-climb calls to scale a three-block stair.
• Approach a doorway or platform that is one block higher without placing blocks.
• Automate corridor traversal where occasional +1 steps appear.