gecs

What problem does it solve?

gecs eliminates unreliable, invented ECS API usage by providing an authoritative, reference-backed Entity-Component-System framework spec for Godot 4.x, so your agent can generate real, correct ECS code instead of guessing.

Core Features & Use Cases

• ECS API coverage for GodotMaker: Defines the expected behavior and relationships between Entity, Component, System, World, queries, observers, and safe structural mutation via CommandBuffer.
• Querying, relationships, and reactivity: Supports common patterns like component composition queries, entity-to-entity relationships, and observer callbacks for component lifecycle/property changes.
• Safety-focused ECS coding guidance: Includes mandatory gotchas and naming/file conventions to prevent common runtime and compilation failures (e.g., Resource export defaults, class vs instance usage, cmd for structural changes during iteration).

Use it when your task involves ECS architecture in Godot 4.x—creating entities with components, writing systems that process queried entities, setting up the ECS World and system groups, debugging query/caching behavior, or implementing observers/relationships.

Quick Start

Ask for gecs help like: "Using gecs for Godot 4.x, create the ECS components C_Health and C_Position, define a Player Entity that returns fresh component instances in define_components(), and write a HealthSystem that queries entities with both components and safely updates component data each frame."