rexrainbow/phaser3-rex-notes/rexboard-match-and-puzzle

RexBoard Match And Puzzle

Use this skill for symbol and pattern matching on a RexBoard board.

Use This First

Choose the matching style:

Match reports tile coordinates. Game code still swaps pieces, removes chess, spawns replacements, and animates results.

Required Setup

This skill assumes a RexBoard Board or LogicBoard exists. If symbols live on chess objects, use rexboard-board-and-chess first.

References

Read these only when needed:

• references/match-config.md: setup, config fields, callbacks, and methods.
• references/match-patterns.md: fixed-length, array, wildcard, direction mask, and group matching.
• references/match-recipes.md: reduced recipes for matching symbols from chess, test swaps, and group rules.

Core Rules

• Keep board occupancy and match symbols in sync.
• Prefer refreshSymbols when symbols live on chess objects.
• Use null for empty/no symbol; use an explicit wildcard symbol for wildcard behavior.
• Use dirMask to limit which board directions are checked.
• Do not expect Match to animate, destroy, or spawn game objects.

Source File Map

• plugins/board/match/Match.d.ts: config, callbacks, methods, and result type.
• plugins/board/match/Factory.js: match factory signature.
• plugins/board/board/LogicBoard.d.ts: board traversal and chess lookup used by matching.

Related Skills

• rexboard-board-and-chess: chess lookup, swaps, removal, and occupancy.
• rexboard-grids-and-coordinates: direction masks depend on grid direction behavior.
• rexboard-rendered-tiles-and-pieces: rendered puzzle pieces.
• rexboard-movement-and-pathfinding: animated movement after match decisions.

Gotchas

• Direction indexes depend on grid mode; configure dirMask after choosing quad/hex grid behavior.
• Test-swap workflows must restore the board if the swap is rejected.