gecs

# gecs — ECS Framework for Godot 4.x $ARGUMENTS gecs is the ECS backend for GodotMaker. It has **zero LLM training data coverage** — all API knowledge must come from this skill. ## Core Concept Mapping | gecs Class | Godot Base | Key Insight | |------------|-----------|-------------| | `Entity` | `extends Node` | Entity IS a Node — lives in scene tree, can have child nodes | | `Component` | `extends Resource` | Pure data, `@export` properties with defaults, no logic | | `System` | `extends Node` | Contains game logic, queries entities, placed in scene tree | | `World` | `extends Node` | Manages all entities/systems, archetype storage, query engine | | `QueryBuilder` | `extends RefCounted` | Chain API: `with_all`/`with_any`/`with_none`, auto-cached | | `Relationship` | `extends Resource` | Pair (relation_component, target), archetype-level indexing | | `Observer` | `extends Node` | Reactive: fires on component add/remove/change events | | `CommandBuffer` | `extends RefCounted` | Safe structural changes during iteration via `cmd` | | `ECS` | Autoload singleton | Global access: `ECS.world`, `ECS.process(delta, group)` | ## Quick Start ```gdscript # --- Component (pure data, extends Resource) --- class_name C_Health extends Component @export var current: float = 100.0 @export var maximum: float = 100.0 class_name C_Velocity extends Component @export var direction: Vector3 = Vector3.ZERO @export var speed: float = 100.0 # --- Entity (extends Node, define default components...