{"id":25500075,"url":"https://github.com/mrdav30/gridforge-unity","last_synced_at":"2026-04-16T07:02:16.649Z","repository":{"id":277938294,"uuid":"933959306","full_name":"mrdav30/GridForge-Unity","owner":"mrdav30","description":"A high-performance, deterministic spatial grid management system for simulations and game development. ","archived":false,"fork":false,"pushed_at":"2026-03-11T04:46:31.000Z","size":354,"stargazers_count":10,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-11T10:54:58.599Z","etag":null,"topics":["ai","deterministic","game-development","grid","lockstep","pathfinding","spatial","unity","voxel-engine"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrdav30.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-17T03:19:35.000Z","updated_at":"2026-03-11T04:46:34.000Z","dependencies_parsed_at":"2025-06-09T07:38:12.550Z","dependency_job_id":null,"html_url":"https://github.com/mrdav30/GridForge-Unity","commit_stats":null,"previous_names":["mrdav30/gridforge-unity"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/mrdav30/GridForge-Unity","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrdav30%2FGridForge-Unity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrdav30%2FGridForge-Unity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrdav30%2FGridForge-Unity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrdav30%2FGridForge-Unity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrdav30","download_url":"https://codeload.github.com/mrdav30/GridForge-Unity/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrdav30%2FGridForge-Unity/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31875183,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"online","status_checked_at":"2026-04-16T02:00:06.042Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","deterministic","game-development","grid","lockstep","pathfinding","spatial","unity","voxel-engine"],"created_at":"2025-02-19T03:36:29.338Z","updated_at":"2026-04-16T07:02:16.595Z","avatar_url":"https://github.com/mrdav30.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GridForge-Unity\n==============\n\n![GridForge Icon](https://raw.githubusercontent.com/mrdav30/GridForge/main/icon.png)\n\n**A high-performance, deterministic voxel grid system for spatial partitioning, simulation, and game development in Unity.**\n\nLightweight and optimized for lockstep engines.\n\nThis package is a Unity-specific implementation of the [GridForge](https://github.com/mrdav30/GridForge) library\n\n---\n\n## 🚀 Key Features\n\n- **Voxel-Based Spatial Partitioning** – Build efficient 3D **voxel grids** with fast access \u0026 updates.\n- **Deterministic \u0026 Lockstep Ready** – Designed for **synchronized multiplayer** and physics-safe environments.\n- **ScanCell Overlay System** – Accelerated **proximity and radius queries** using spatial hashing.\n- **Dynamic Occupancy \u0026 Obstacle Tracking** – Manage **moving occupants, dynamic obstacles**, and voxel metadata.\n- **Minimal Allocations \u0026 Fast Queries** – Built with **SwiftCollections** and **FixedMathSharp** for optimal performance.\n- **Multi-Layered Grid System** – **Dynamic, hierarchical, and persistent grids**.\n\n---\n\n## 📦 Installation\n\n### 🧩 Dependencies\n\nGridForge-Unity depends on the following Unity packages:\n\n- [FixedMathSharp-Unity](https://github.com/mrdav30/FixedMathSharp-Unity)\n- [SwiftCollections-Unity](https://github.com/mrdav30/SwiftCollections-Unity)\n\nThese dependencies must be installed before using GridForge-Unity.\n\n### Via Unity Package Manager (UPM)\n\n1. Open **Unity**.\n2. Go to **Window** → **Package Manager**.\n3. Click the **+** icon and select **\"Add package from git URL...\"**.\n4. Enter:\n\n    \u003chttps://github.com/mrdav30/GridForge-Unity.git\u003e\n\n5. Click **Add**.\n\n### Manual Installation\n\n1. Download the .unitypackage file from the [latest release](https://github.com/mrdav30/SwiftCollections-Unity/releases).\n2. Open Unity and import the package via **Assets → Import Package → Custom Package...**.\n3. Select the downloaded file and import the contents.\n\n---\n\n## 📖 Usage Examples\n\n### **🔹 Creating a Grid**\n\n```csharp\nGridConfiguration config = new GridConfiguration(new Vector3d(-10, 0, -10), new Vector3d(10, 0, 10));\nGlobalGridManager.TryAddGrid(config, out ushort gridIndex);\n```\n\n### **🔹 Querying a Grid for Nodes**\n\n```csharp\nVector3d queryPosition = new Vector3d(5, 0, 5);\nif (GlobalGridManager.TryGetGridAndVoxel(queryPosition, out VoxelGrid grid, out Voxel voxel)) {\n    Console.WriteLine($\"Voxel at {queryPosition} is {(voxel.IsOccupied ? \"occupied\" : \"empty\")}\");\n}\n```\n\n### **🔹 Adding a Blocker**\n\n```csharp\nBoundingArea blockArea = new BoundingArea(new Vector3d(3, 0, 3), new Vector3d(5, 0, 5));\nBlocker blocker = new Blocker(blockArea);\nblocker.ApplyBlockage();\n```\n\n### **🔹 Attaching a Partition to a Voxel**\n\n```csharp\nif (GlobalGridManager.TryGetGrid(queryPosition, out VoxelGrid grid, out Voxel voxel))\n{\n    PathPartition partition = new PathPartition();\n    partition.Setup(voxel.GlobalVoxelIndex);\n    voxel.AddPartition(partition);\n}\n```\n\n### **🔹 Scanning for Nearby Occupants**\n\n```csharp\nVector3d scanCenter = new Vector3d(0, 0, 0);\nFixed64 scanRadius = (Fixed64)5;\nforeach (IVoxelOccupant occupant in ScanManager.ScanRadius(scanCenter, scanRadius))\n{\n    Console.WriteLine($\"Found occupant at {occupant.WorldPosition}\");\n}\n```\n\n## 🎮 Unity Debugging Tools\n\nGridForge includes **editor utilities** for debugging:\n\n- **GridDebugger** – Visualizes **grids, voxels, and selected areas**.\n- **GridTracer Debuging** – Helps debug **line-of-sight \u0026 navigation**.\n- **Blocker Editor** – Allows **visual blocker placement** via Unity Inspector.\n\n---\n\n## 🔄 Compatibility\n\n- **Unity 2020+**\n- **Supports deterministic lockstep engines**\n- **Compatible with AI navigation and procedural world systems**\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the `LICENSE` file for details.\n\n---\n\n## 👥 Contributors\n\n- **David Oravsky** - Lead Developer\n- **Contributions Welcome!** Open a PR or issue.\n\n---\n\n## 💬 Community \u0026 Support\n\nFor questions, discussions, or general support, join the official Discord community:\n\n👉 **[Join the Discord Server](https://discord.gg/mhwK2QFNBA)**\n\nFor bug reports or feature requests, please open an issue in this repository.\n\nWe welcome feedback, contributors, and community discussion across all projects.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrdav30%2Fgridforge-unity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrdav30%2Fgridforge-unity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrdav30%2Fgridforge-unity/lists"}