GridBuilding Plugin

A powerful grid building system for Godot games.

🎯 Quick Start

Installation

1
2

# Add to your Godot project
cp -r GridBuilding /path/to/your/godot/project/addons/

Basic Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

// Add to your scene
var gridNode = new GridBuildingNode();
AddChild(gridNode);

// Place a building
var building = new BuildingData
{
    Name = "House",
    Size = new Vector2I(2, 2),
    GridPosition = new GridPosition(5, 3, new Vector2(64, 64))
};

await gridNode.PlaceBuildingAsync(building);

📚 Documentation

🚀 For Users

• Getting Started - Step-by-step tutorial
• API Reference - Complete API documentation
• Troubleshooting - Common issues and solutions
• Integration Example - Complete project example

🏗️ For Developers

• Service Architecture - Understanding the architecture
• GDScript to C# Migration - Why and how we’re migrating

✨ Features

• 🎮 Engine Agnostic - Works with Godot and Unity
• ⚡ High Performance - Optimized for real-time games
• 🔧 Extensible - Easy to customize and extend
• 🧪 Well Tested - Comprehensive test coverage
• 📚 Great Documentation - Complete guides and API reference

🏗️ Architecture (pre‑6.0)

The 5.0 line is best understood as a composition-container / injector era (with bridge-style integration patterns).

For the modern architecture target (ports/adapters over a Core service layer), see:

• ../v6-0/guides/service_architecture_and_adapters/
• ../v6-0/guides/core-godot-integration/

1
2
3
4
5

Godot nodes / scripts
  ↓
Composition container + injector
  ↓
Backend state + (legacy) bridge patterns

🎯 Use Cases

• City Builders - Place and manage buildings
• Strategy Games - Grid-based unit placement
• Puzzle Games - Grid-based mechanics
• RPG Games - Inventory and crafting systems
• Sandbox Games - Creative building tools

🚀 Getting Help

• GitHub Repository - Source code and issues
• Discussions - Community discussions
• Troubleshooting - Common issues and solutions

Ready to start building? Check out our Getting Started guide!