Troubleshooting

intermediate troubleshooting

This page covers the most common issues users encounter with Grids 2D and how to resolve them.

Symptom	You added the Grids2D prefab but no grid appears.
Cause	The camera may not be facing the grid plane, or the grid is hidden.
Solution	Select the Grids2D GameObject and press F in the Scene view to frame it. The grid renders on the XY plane. Ensure your camera looks down the Z-axis (for 2D) or is positioned appropriately. Check that Hide Objects is not enabled in the Inspector. Verify the prefab was dragged from `Grids2D/Resources/Prefabs`.

Symptom	Moving the mouse over the grid does not highlight cells or territories.
Cause	Selection mode is set to None, or a UI element is blocking input.
Solution	Set Selection Mode to Cells or Territories in the Grid Behavior section. If Respect Other UI is enabled, ensure no uGUI Canvas element is covering the grid area. Confirm the correct Camera is assigned (or left blank for main camera).

Symptom	Noticeable lag when the grid is created or during runtime with territories active.
Cause	Territory mesh generation is expensive with high cell counts.
Solution	Reduce the number of cells or territories. Disable Show Territories and Colorize Territories if not needed. Pre-warm the geometry at load time using the API to avoid runtime lag. Ensure Internal Territories is disabled unless you specifically need enclave detection.

Symptom	The Irregular (Voronoi) grid generates a different layout on each play.
Cause	The randomization seed is not fixed.
Solution	Set a fixed Seed value in the Grid Configuration section. Using the same seed guarantees identical cell layouts across plays.

Symptom	`FindPath()` returns null, an empty list, or a non-optimal path.
Cause	Cells may be blocked, the cost limit is too low, or the wrong algorithm is selected.
Solution	Verify that cells on the desired path have `canCross = true` (use `CellSetCanCross()`). Increase Max Search Cost and Max Steps. Try a different Algorithm — Euclidean typically gives the best results. Check cell groups: `FindPath()` can accept a group mask to filter traversable cells.

Symptom	Textures assigned to cells look stretched or warped.
Cause	Cell shapes (especially Voronoi) are irregular, causing UV mapping issues.
Solution	Use Box or Hexagonal topologies for more uniform UV mapping. For Irregular topology, increase the Relaxation level to create more regular cell shapes. Use the Canvas Texture feature for seamless texturing across the entire grid.

If your issue is not listed here, visit the Kronnect Support and post your question. The team typically responds within 24 hours.

Was this page helpful? |