Quick Start
beginner quick startGrids 2D · Quick Start
Quick Start — First result in 5 minutes
Follow these steps to add a 2D grid to your Unity scene. No scripting required.
Step 1 — Import the package
Open Window > Package Manager, locate Grids 2D in My Assets and click Import. If you downloaded the .unitypackage manually, double-click it and import all files.
Step 2 — Add the grid to your scene
Drag the Grids2D prefab from Grids2D/Resources/Prefabs into your scene hierarchy. A grid will appear in the Scene view with default settings.
Tip: The grid renders as a flat plane. Position your camera to look straight down (Y-axis) for the clearest 2D view, or use an orthographic camera.
Step 3 — Choose a topology
Select the Grids2D GameObject and find the Topology dropdown in the Inspector. Try each option:
- Irregular — organic Voronoi cells (set cell count).
- Box — rectangular grid (set rows and columns).
- Hexagonal — hexagonal grid (set rows and columns).
Step 4 — Enable interaction
Under Grid Behavior, set Selection Mode to Cells or Territories. Enter Play Mode and hover over the grid — cells will highlight. Click to select.
Step 5 — Explore the demo scenes
Open scenes under Grids2D/Demos/ to see pathfinding, territory colorization, texture painting, and more. Each demo has a script you can study for API usage.
Checklist
- ☑ Package imported successfully
- ☑ Grids2D prefab added to scene
- ☑ Topology selected (Irregular, Box, or Hexagonal)
- ☑ Cell highlighting working in Play Mode
Next steps
Now that your grid is running, explore the Settings reference for all Inspector parameters, or jump to the Scripting guide to control the grid from C# code.
Suggest an improvement
Help us improve this documentation page.