version: "1.0.0" name: rexboard-movement-and-pathfinding description: "Use this skill when working with RexBoard moveTo, pathFinder, MoveTo, PathFinder, moveToward, moveToRandomNeighbor, board paths, A, occupiedTest, blockerTest, moveableTest, path costs, reachable areas, or tile-by-tile board movement. Triggers on: RexBoard moveTo, RexBoard pathFinder, board path, A, occupiedTest, blockerTest, moveableTest, findArea, findPath."

RexBoard Movement And Pathfinding

Use this skill for moving board chess and planning paths across RexBoard tiles.

Use This First

Choose the movement tool:

Most tactical movement uses both: pathfind first, then move step-by-step.

Required Setup

This skill assumes the moving chess is already on a RexBoard board. If not, use rexboard-board-and-chess.

References

Read these only when needed:

• references/moveto-config.md: MoveTo config, methods, runtime setters, and events.
• references/pathfinder-config.md: PathFinder config, path modes, cost callbacks, and query APIs.
• references/blockers-and-costs.md: occupied tests, blocker tests, moveable tests, and cost semantics.
• references/movement-recipes.md: reduced recipes for moving toward a tile, following a path, and reachable tiles.

Core Rules

• MoveTo needs a chess game object already registered on a board.
• PathFinder can be constructed with a game object or config; call setChess(gameObject) when created detached.
• Keep occupiedTest, blockerTest, and custom tests separate.
• Use PathFinder.BLOCKER/INFINITY from the instance in callbacks instead of hard-coded sentinel values.
• Use board occupancy and tileZ conventions consistently between movement and pathfinding.

Source File Map

• plugins/board/moveto/MoveTo.d.ts: movement config, methods, and callback types.
• plugins/board/pathfinder/PathFinder.d.ts: path config, path modes, costs, and query methods.
• plugins/board/moveto/Factory.js: moveTo factory signature.
• plugins/board/pathfinder/Factory.js: pathFinder factory signatures.
• plugins/board/moveto/methods/*.js: inspect only when movement behavior is unclear.

Related Skills

• rexboard-board-and-chess: board occupancy, tileZ, and chess placement.
• rexboard-grids-and-coordinates: directions, neighbors, distance, and wrap behavior.
• rexboard-visibility-and-routes: LOS and Monopoly route traversal.
• rexboard-miniboard-and-composite: MiniBoard-specific movement workflows.

Gotchas

• sneak affects movement occupancy behavior; do not use it unless game rules require passing through occupied tiles.
• MoveTo mutates board chess position before the visual tween completes; account for this when checking occupancy during movement.
• wrap can make a neighbor move render as split movement across board edges.