RexBoard Movement And Pathfinding
Use this skill for moving board chess and planning paths across RexBoard tiles.
Use This First
Choose the movement tool:
| Need |
Use |
| Animate a chess game object tile-by-tile |
MoveTo |
| Test one destination tile |
MoveTo.canMoveTo(...) |
| Find reachable area |
PathFinder.findArea(...) |
| Find a path to a destination |
PathFinder.findPath(...) |
| Use terrain costs or A* modes |
PathFinder with costCallback |
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.
1---2name: rexboard-movement-and-pathfinding3description: 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.4---56# RexBoard Movement And Pathfinding78Use this skill for moving board chess and planning paths across RexBoard tiles.910## Use This First1112Choose the movement tool:1314| Need | Use |15|---|---|16| Animate a chess game object tile-by-tile | `MoveTo` |17| Test one destination tile | `MoveTo.canMoveTo(...)` |18| Find reachable area | `PathFinder.findArea(...)` |19| Find a path to a destination | `PathFinder.findPath(...)` |20| Use terrain costs or A* modes | `PathFinder` with `costCallback` |2122Most tactical movement uses both: pathfind first, then move step-by-step.2324## Required Setup2526This skill assumes the moving chess is already on a RexBoard board. If not, use `rexboard-board-and-chess`.2728## References2930Read these only when needed:3132- `references/moveto-config.md`: `MoveTo` config, methods, runtime setters, and events.33- `references/pathfinder-config.md`: `PathFinder` config, path modes, cost callbacks, and query APIs.34- `references/blockers-and-costs.md`: occupied tests, blocker tests, moveable tests, and cost semantics.35- `references/movement-recipes.md`: reduced recipes for moving toward a tile, following a path, and reachable tiles.3637## Core Rules3839- `MoveTo` needs a chess game object already registered on a board.40- `PathFinder` can be constructed with a game object or config; call `setChess(gameObject)` when created detached.41- Keep `occupiedTest`, `blockerTest`, and custom tests separate.42- Use `PathFinder.BLOCKER`/`INFINITY` from the instance in callbacks instead of hard-coded sentinel values.43- Use board occupancy and `tileZ` conventions consistently between movement and pathfinding.4445## Source File Map4647- `plugins/board/moveto/MoveTo.d.ts`: movement config, methods, and callback types.48- `plugins/board/pathfinder/PathFinder.d.ts`: path config, path modes, costs, and query methods.49- `plugins/board/moveto/Factory.js`: `moveTo` factory signature.50- `plugins/board/pathfinder/Factory.js`: `pathFinder` factory signatures.51- `plugins/board/moveto/methods/*.js`: inspect only when movement behavior is unclear.5253## Related Skills5455- `rexboard-board-and-chess`: board occupancy, `tileZ`, and chess placement.56- `rexboard-grids-and-coordinates`: directions, neighbors, distance, and wrap behavior.57- `rexboard-visibility-and-routes`: LOS and Monopoly route traversal.58- `rexboard-miniboard-and-composite`: MiniBoard-specific movement workflows.5960## Gotchas6162- `sneak` affects movement occupancy behavior; do not use it unless game rules require passing through occupied tiles.63- `MoveTo` mutates board chess position before the visual tween completes; account for this when checking occupancy during movement.64- `wrap` can make a neighbor move render as split movement across board edges.
rexrainbow