Work safely with Inspector, Undo, validation, and reload
When to use
Follow these safeguards while editing a Grid Toolkit board, setup, structure, policy, or resolver asset.
Before you start
Start with an asset that already builds. If it does not, fix the first problem in its GridAuthoringBuildReport.
Procedure
- Select the board or GridBoardSetupAsset.
- Make one logical edit, such as painting cells, moving one placement, or changing one footprint.
- Read the validation report and correct blocking problems before judging the preview.
- Use Edit > Undo once. The complete logical edit should revert.
- Redo the edit when needed, then rebuild the runtime state. An existing state does not absorb later asset changes.
- After a script reload, reselect the asset if its preview is stale and rebuild GridBoardAuthoring state.
Built-in creation and renderer recipes group their changes for Undo. A project-owned editor adapter must record every serialized target that belongs to its logical edit.
Result
Validation reports no blocking problems, the preview matches the serialized asset, one Undo operation reverts one logical edit, and rebuilding creates a fresh runtime state.
Troubleshooting
| Symptom | Check |
|---|---|
| Undo changes only part of an edit | The custom adapter did not record every serialized target. |
| Preview differs from the asset | Reselect the asset and rebuild the derived preview. |
| Runtime state did not update | Rebuild it; authoring assets are not live state. |
| A managed reference is missing | Restore or migrate the renamed project-owned type. |
| Diagnostics repeat after reload | Make project-owned registration idempotent. |