Lost Lily/Grid ToolkitDocs 1.0
Table of Contents
BeginnerValidated 1.0.0

Edit board assets and setups

When to use

Edit board assets and setups when designers need to change cells, topology-specific dimensions, setup references, or board-level configuration through Unity assets. Structure definitions, visuals, libraries, and starting placements have their own focused workflow.

Before you start

Start with the board created by the beginner path or another setup that validates successfully. Use matching authored asset families:

SquareGridBoardAsset is the Square board asset; Hex and Triangle provide matching topology-specific assets.

Family Coordinate model Orientation and layout
Square Integer x, y cells Quarter-turn footprint orientations; automatic topology layout available.
Hex Axial hex coordinates Six topology orientations; automatic topology layout available.
Triangle Integer coordinates with triangle-facing semantics Footprints preserve cell facing; automatic topology layout available.

Choosing a built-in topology does not require a custom layout.

Procedure

1. Edit the board definition

  1. Select the board asset and edit its topology-specific dimensions or cells.
  2. Select Validate Board and resolve definition or topology errors.

2. Configure the setup

  1. Select the setup asset and confirm it references the intended board.
  2. Assign board-level policy or resolver profiles only when this board differs from project defaults.
  3. Under Preview, inspect the resulting cells. Use Frame Setup and the topology-specific preview controls when needed.
  4. Select Validate Setup.

3. Rebuild the scene state

  1. On the scene host, assign the setup to GridBoardAuthoring. Keep Build On Awake enabled unless another owner calls Build() explicitly.
  2. Rebuild and confirm the authoring component reports ready at revision 0.
Authored square board Inspector with its eight by eight grid and Board Summary reporting Definition Valid and Cells 64
The board summary makes the built topology and 64-cell result observable before the setup creates runtime state.

Result

The setup builds one GridBoardState at revision 0. Rebuilding disposes the replaced state and notifies source-bound views that a replacement is available.

Troubleshooting

Symptom Check
Preview cannot create a layout Import the matching topology authoring adapter or register a supported preview provider.
Scene and setup previews disagree Confirm the scene host references the same setup and rebuild the authoring state.
A board-specific service is ignored Inspect the runtime-configuration trace for project or board precedence.
A starting structure is invalid Continue with the focused structure and placement workflow.