# Rexboard Board And Chess

> Rexboard Board And Chess is an Agent Skill for apps & automation 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 Board, LogicBoard, board data model, addChess, removeChess, moveChess, swapChess, tileZ layers, chess occupancy, board input events, wrap, infinity, blockers, or board-aware chess placement. Triggers on: RexBoard board, RexBoard chess, LogicBoard, addChess, moveChess, tileZ, board occupancy, board input.

- Skill name: `rexboard-board-and-chess`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/rexrainbow/phaser3-rex-notes/blob/HEAD/skills/rexboard/rexboard-board-and-chess/SKILL.md
- Repository: rexrainbow/phaser3-rex-notes (1,334 GitHub stars when collected)

## SKILL.md

# RexBoard Board And Chess

Use this skill for the core RexBoard data model: a board with a grid, dimensions, chess pieces, tile layers, occupancy, and optional input events.

## Use This First

Establish these before writing board logic:

| Need | Decide |
|---|---|
| Coordinate system | Which `QuadGrid` or `HexagonGrid` backs the board |
| Board extent | Fixed `width`/`height`, `wrap`, or `infinity` |
| Layers | What each `tileZ` value means |
| Chess type | Phaser game object or plain data object |
| Input | Whether `board.setInteractive()` is needed |

## Required Setup

This skill assumes RexBoard setup and a grid are already available. If not, use `rexboard-setup-and-factory` and `rexboard-grids-and-coordinates`.

## References

Read these only when needed:

- `references/board-config.md`: board construction, embedded grid configs, wrap/infinity settings.
- `references/chess-model.md`: tile/chess placement, `tileZ` layers, occupancy, blockers, and plain data pieces.
- `references/board-events.md`: interactive tile, game-object, pointer, tap, press, and swipe events.
- `references/chess-recipes.md`: reduced add/remove/move/swap/iterate recipes.

## Core Rules

- `Board` extends the logic board with scene input support; `LogicBoard` is the core data model.
- Always create or pass a grid before board operations that require coordinate conversion.
- Treat `tileZ` as part of the chess coordinate, not optional metadata.
- Use `align: true` when adding or moving rendered chess that should snap to grid world coordinates.
- Use `isEmptyTileXYZ`, `tileXYZToChess`, and `tileXYToChessArray` for occupancy checks.
- Keep plain data chess and Phaser game object chess workflows distinct.

## Source File Map

- `plugins/board/board/Board.d.ts`: board construction and input API.
- `plugins/board/board/LogicBoard.d.ts`: chess placement, occupancy, coordinate conversion, bounds, neighbors, and blockers.
- `plugins/board/chess/ChessData.d.ts`: chess metadata attached to board-aware objects.
- `plugins/board/board/Factory.js`: `board` factory signature.

## Related Skills

- `rexboard-setup-and-factory`: plugin setup and direct import mode.
- `rexboard-grids-and-coordinates`: grid configs, tile/world conversion, directions.
- `rexboard-rendered-tiles-and-pieces`: board-aware visible chess.
- `rexboard-movement-and-pathfinding`: movement constraints and path queries.

## Gotchas

- `wrap` and `infinity` change containment, neighbor, and movement behavior.
- Board input events require `board.setInteractive(...)`.
- Some emitted event names are only obvious in `plugins/board/board/input/*.js`; inspect source when documenting exact events.
- A tile can be occupied on one `tileZ` layer and empty on another.

---

Source: https://www.openparable.com/skill/apps-automation/rexboard-board-and-chess (OpenParable). Cite the canonical URL above.
