OpenParable
Skip to content
← Back to skills

Rexboard Movement And Pathfinding

Development
rexboard-movement-and-pathfinding

Rexboard 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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:

NeedUse
Animate a chess game object tile-by-tileMoveTo
Test one destination tileMoveTo.canMoveTo(...)
Find reachable areaPathFinder.findArea(...)
Find a path to a destinationPathFinder.findPath(...)
Use terrain costs or A* modesPathFinder 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.