godot-scene-arch

Builds Godot 4 scenes programmatically with GDScript node hierarchies and minimal .tscn files.

Updated Aug 11, 2026
One-click install
npx skills add https://github.com/zerox-core/AI_Game --skill godot-scene-arch-zerox-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: godot-scene-arch
Source: https://github.com/zerox-core/AI_Game/tree/main/.claude/skills/godot-scene-arch
Command: npx skills add https://github.com/zerox-core/AI_Game --skill godot-scene-arch-zerox-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Hand-written .tscn scene files are fragile for AI-generated Godot projects, with frequent errors in load_steps, quoting, and parent paths. This Skill provides patterns for building scenes in GDScript code instead, producing reliable node hierarchies for players, enemies, bullets, UI, timers, and cameras. ## Core Features & Use Cases - Programmatic Scene Building: Construct CharacterBody2D, Area2D, CanvasLayer UI, Timer, and Camera2D nodes entirely in _ready() with collision layers, shapes, and visuals. - Minimal .tscn Templates: Use 5-line root scenes that only attach a builder script, plus rules for prefab .tscn files when reuse justifies them. - Hierarchy Patterns: Ready-made node tree layouts for top-down games, platformers, and menu screens. - Use Case: When generating a new Godot 4 game, apply these patterns to create the main scene, player, enemy spawner, and HUD in GDScript without touching error-prone .tscn text. ## Quick Start Ask the AI to create a Godot 4 main scene with a player, enemy spawner, and score UI built programmatically in GDScript.

Frequently Asked Questions about godot-scene-arch

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

FAQPage Schema
How do I create a Godot 4 scene programmatically in GDScript?

Create nodes with .new() inside _ready(), configure properties like collision_layer and position, add CollisionShape2D and visual children, then call add_child(). Attach behavior with set_script(load(...)) and keep the .tscn file as a minimal root that only references the builder script.

Should I use .tscn files or GDScript for Godot scene creation?

Prefer GDScript for AI-generated scenes because .tscn text is fragile with load_steps counts, quoting, and parent paths. Reserve .tscn for reusable prefabs instantiated many times, simple static layouts under five nodes, and root scenes that only attach a script.

How do I set up collision layers for player and enemies in Godot 4?

Assign each CharacterBody2D or Area2D a collision_layer identifying what it is, and a collision_mask listing what it detects. For example, layer 1 for the player with mask 4|6 detects enemies and walls, while bullets on layer 2 use mask 4 to hit enemies.

What is the correct load_steps value in a Godot 4 .tscn file?

Set load_steps equal to the number of ext_resources plus sub_resources plus one. Use format=3 for Godot 4, omit the parent attribute on the root node, use parent="." for direct children, and quote all strings in double quotes.

How do I add a UI health bar and score label in Godot?

Create a CanvasLayer, then add a Label for the score with add_theme_font_size_override and a ProgressBar for health with max_value and value set. Position them with the position and size properties, then add the CanvasLayer to your main scene.