godot-architecture

Guides system design decisions for Godot 4.x projects including ownership, signals, and performance.

Updated May 22, 2026
One-click install
npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill godot-architecture-viniciuscs84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: godot-architecture
Source: https://github.com/viniciuscs84/sdd-toolkit/tree/main/skills/godot-architecture
Command: npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill godot-architecture-viniciuscs84

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designing large-scale Godot 4.x games often leads to tight coupling, signal spaghetti, and performance bottlenecks when developers lack clear rules for data ownership, signal topology, and scene boundaries. ## Core Features & Use Cases - Architecture Decision Framework: Provides a three-question ownership model, a layered signal topology (presentation, logic, data, infrastructure), and a decision matrix mapping project types (RPG, open world, multiplayer, mobile) to architecture strategies. - Performance Budgets & Gotchas: Supplies concrete mobile/desktop budgets for draw calls, physics bodies, and script time, plus documented Godot 4.x pitfalls like shared @export Resources and signal syntax changes. - Use Case: When building a complex RPG with combat and inventory systems, use this Skill to choose a component-driven architecture, define scoped signal buses, and apply expert patterns like state machine transition guards and async level loading. ## Quick Start Ask the AI to design the architecture for a Godot 4.x RPG with a combat system, defining data ownership, signal flow, and scene boundaries.

Frequently Asked Questions about godot-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure signals in a large Godot 4 project?

Use a tiered signal bus approach: a global autoload bus for lifecycle events only, scoped feature buses per feature folder, and direct signals only within a single scene. Signals should travel upward through layers, never downward.

When should I use Node vs Resource vs RefCounted in Godot?

Use Node only for entities needing _process, spatial transforms, or scene tree lifetime. Use Resource for designer-editable serializable data, and RefCounted for transient logic packets like damage requests that auto-free when unreferenced.

Why does my Godot 4 signal connection silently fail?

Godot 3 string-based connect syntax compiles but does nothing in Godot 4. Use the callable syntax signal_name.connect(callable) instead to ensure connections actually work.

What are Godot 4 performance limits for mobile games?

Mobile targets should stay under 100 draw calls in 2D, 100K visible triangles, 512MB texture VRAM, 4ms script time per frame, and 200 active physics bodies. Use MultiMeshInstance and Server APIs to stay within budget.

Is the Godot scene tree thread-safe for chunk loading?

No, the scene tree is not thread-safe. Generate content off the main thread, then attach it using call_deferred(). Server APIs like RenderingServer and PhysicsServer are thread-safe when enabled in Project Settings.