DreamerTheory-GridSystem

The DreamerTheory Grid System is a powerful, extensible, and editor-friendly framework for building grid-based games and tools in Unity. Designed for both 2D and 3D workflows, this package provides a robust foundation for level design, procedural generation, and gameplay mechanics that rely on grids. ### Key Features: * **Generic Grid Architecture:** Create grids of any size and shape, supporting any type of object as grid content. Easily customize cell size, grid dimensions, and storage. * **World/Grid Position Conversion:** Seamlessly convert between world coordinates and grid positions, enabling precise placement and interaction of objects within your grid. * **Advanced Rule-Based Tile Placement:** Place tiles using flexible rules that automatically select the correct prefab and rotation based on neighboring cells. Supports isolated tiles, edges, corners, inverted corners, and more. * **Dual Grid Tiling Support:** Offset the visual tile placement by half a cell relative to the logical data grid. Automatically computes a 4-bit mask for the 16 combinations of surrounding cells to simplify asset requirements and eliminate alignment seams. * **Editor Integration & Snapping Tools:** Includes custom editor scripts for snapping GameObjects to the grid, toggling snapping modes, and visualizing the grid directly in the Unity Editor. Streamline your level design workflow with intuitive handles and menu shortcuts. * **Visual Grid Gizmos:** Draw grid lines, cell highlights, and optional cell indices in the Scene view for easy debugging and design. * **Pathfinding Support:** Built-in pathfinding algorithms allow you to find optimal paths between grid cells, supporting both 2D and 3D navigation. Easily integrate pathfinding into your gameplay, AI, or puzzle mechanics. * **Events and Extensibility:** Includes UnityEvents for grid updates and a modular, generic design that makes it easy to extend for custom behaviors, such as dynamic obstacles, custom tile logic, or procedural content. ### Perfect For: * Strategy and tactics games * Tilemaps and dungeon generators * Puzzle and board games * Level editors and in-game construction tools * Any Unity project requiring a robust, customizable grid foundation ### Package Structure: * **Core:** Core grid logic and base classes * **Ruletile:** Rule-based and dual-grid tile placement systems * **Scripts:** Editor tools for snapping and visualization ### Get Started: With comprehensive documentation, clear API, and editor tooling, DreamerTheory Grid System helps you build, visualize, and manage complex grid-based worlds with ease.