Rexboard Movement And Pathfinding
Developmentrexboard-movement-and-pathfindingRexboard Movement And Pathfinding is an Agent Skill for development published in the rexrainbow/phaser3-rex-notes repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/rexrainbow/phaser3-rex-notes/blob/HEAD/skills/rexboard/rexboard-movement-and-pathfinding/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/rexboard-movement-and-pathfinding, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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:MoveToconfig, methods, runtime setters, and events.references/pathfinder-config.md:PathFinderconfig, 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
MoveToneeds a chess game object already registered on a board.PathFindercan be constructed with a game object or config; callsetChess(gameObject)when created detached.- Keep
occupiedTest,blockerTest, and custom tests separate. - Use
PathFinder.BLOCKER/INFINITYfrom the instance in callbacks instead of hard-coded sentinel values. - Use board occupancy and
tileZconventions 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:moveTofactory signature.plugins/board/pathfinder/Factory.js:pathFinderfactory 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
sneakaffects movement occupancy behavior; do not use it unless game rules require passing through occupied tiles.MoveTomutates board chess position before the visual tween completes; account for this when checking occupancy during movement.wrapcan make a neighbor move render as split movement across board edges.