gamedev-godot
Godot Game Creation
Use this skill to take a Godot project from empty editor to a published, exported build using the engine, language, and tooling of the current stable Godot 4.x release. Look up the current stable minor and patch in the official release archive and release notes before starting or upgrading a project; the answer decides which node names, defaults, and export caveats apply. The skill covers the durable build spine (prototype → first playable → content → export) and fences the volatile engine layer (renderer names, minor-version API renames, physics-engine defaults, C# and web-export caveats) so you teach what is true for the pinned version, not what was true in Godot 3.
Version note: treat development snapshots as pre-release until the official archive marks them stable. Pin the exact patch level in CI, not just the minor. Before an upgrade, read the release notes of every minor between the project's version and the target, because defaults change between minors. Past examples: 4.6 made Jolt the default 3D physics engine for new projects, existing projects retain their configured physics engine; 4.7 integrated the Asset Store; legacy Asset Library links are not automatically broken. Check which addon source the target version uses before pointing contributors at a link.
Quick Reference
| Stage | Read or Run | Durable default (Godot 4.x) |
|---|---|---|
| Setup & project | references/setup-and-project.md |
One editor install per project via a version manager; commit project.godot + source, gitignore .godot/; pick GDScript unless you have a concrete reason for C# (heavier export; check whether the current stable supports C# web export, and if not, web means GDScript) |
| Language & architecture | references/gdscript-and-architecture.md |
class_name + @export + static typing (var x: int); signals up, calls down; autoload singletons for cross-scene state; _physics_process for physics-synchronized logic; _process(delta) for frame-based updates |
| Build the game | references/scenes-and-nodes.md |
Compose with scenes as reusable prefabs; keep the node tree shallow; instance scenes, don't deep-nest; CharacterBody2D/3D + move_and_slide() (velocity in units per second, not multiplied by delta); TileMapLayer for 2D grids (the monolithic TileMap was deprecated in 4.3 — use the editor's one-click migration); Jolt became the default 3D physics engine for new projects in 4.6 |
| Performance & traps | references/performance-and-traps.md |
Cache get_node results; free with queue_free(); pool only when measured spawning/destruction cost warrants it; profile with the built-in profiler + --verbose; avoid per-frame allocations in _process |
| Rendering & platforms | references/rendering-and-export.md |
Pick the renderer per target (Forward+ desktop, Mobile for phones, Compatibility for web/old GPUs); export needs matching export templates; test on-device, not just the editor |
| Ship & polish | references/rendering-and-export.md#shipping |
Export presets per platform; strip debug; sign/notarize per store rules (verify per platform); one-button build via godot --headless --export-release in CI |