Compatibility and dependencies
Check these requirements before importing Grid Toolkit or when Package Manager reports a missing dependency.
Unity version support
The 1.0 release targets Unity 6.0 through 6.6. Certification is tied to the shipped artifact and exact editor versions. A historical pass does not certify a changed package.
Exact tested editor versions
Use the exact tested editor list in the live handbook or the accompanying release record. These records identify the frozen package that was tested.
The 1.0 validation targets are 6000.0.59f2, 6000.0.78f1, 6000.0.80f1, 6000.2.7f2, 6000.3.2f1, 6000.3.20f1, 6000.4.3f1, 6000.4.7f1, 6000.5.5f1, and 6000.6.3f1. Treat a target as tested only when it appears in a completed release record.
Update policy
Use the exact certified versions for a reproducible setup. Newer patches in the listed streams receive regression checks when a compatibility issue is reproduced. New Unity streams require a refreshed matrix before the support range is extended. Keep a project backup when upgrading. Unity 6.6 checks include repeated Play Mode entry with domain and scene reload enabled and disabled.
Required Unity package
Grid Toolkit requires com.unity.ugui in the range [2.0.0, 3.0.0). Package Manager normally
resolves this dependency during import.
If Unity reports missing UnityEngine.UI, Image, Graphic, or VertexHelper types, confirm that
uGUI 2.x is installed and resolved. The included Canvas renderer is provided by
GridCanvasBoardRenderer.
Optional Sample dependencies
The core toolkit and the minimal Playable Starter sample do not require Input System or Universal Render Pipeline. The 14 catalogued Samples and tutorials require both:
| Package | Supported range | Why Samples use it |
|---|---|---|
com.unity.inputsystem |
[1.8.1, 2.0.0) |
Sample controls and pointer input |
com.unity.render-pipelines.universal |
[17.0.1, 18.0.0) |
Sample materials, shaders, lighting, and presentation |
Samples also require a Universal Renderer as the active default renderer. Their intended presentation does not target the URP 2D Renderer. Open Anyway is useful for inspecting a scene, but configuring the Universal Renderer is required for the intended result.
Automatic board setup selects materials for the active Built-in or URP pipeline, including a quality-level pipeline override. Installing URP without activating it keeps Built-in materials. For another pipeline, provide compatible materials manually. Setup never changes the active pipeline or installs packages.
Troubleshooting
| Symptom | Check |
|---|---|
| Package Manager cannot resolve uGUI | Install a compatible uGUI 2.x package. |
| Grid Toolkit works but Sample scripts are unavailable | Install compatible Input System and URP packages. |
| A Sample is pink, dark, or visually incomplete | Make a Universal Renderer the active default renderer. |