godot-platformer-specs

name	godot-platformer-specs
description	Implements or changes the Super Mario–style Godot platformer by following project specs in specs/. Use when adding mechanics, levels, enemies, blocks, UI, or when the user asks to implement or fix something in the platformer game.

Godot Platformer — Specs-First Implementation

When to use

• User asks to implement a feature, fix a bug, or add content to the platformer.
• User mentions player, enemies, levels, blocks, power-ups, HUD, or game flow.
• User says "follow the specs" or "per spec."

Workflow

1. Identify scope: Which spec(s) apply? (mechanics, characters, levels, technical, UI/audio.)
2. Read the spec: Open the relevant file under specs/ (see list below).
3. Implement: Match behavior and structure to the spec. Use existing scenes/scripts where they exist; create only what’s missing.
4. Stay consistent: Use project structure from specs/04-technical-godot.md, physics layers and groups from the same file, and tuning ranges from specs/01-mechanics-physics.md.

Spec index

Topic	File
Scope, features, core loop	specs/00-overview.md
Movement, jump, gravity, camera, blocks, goal, death	specs/01-mechanics-physics.md
Player states, enemies, power-ups, scoring, lives	specs/02-characters-enemies.md
Level layout, tiles, objects, design	specs/03-levels-world.md
Project structure, nodes, layers, signals	specs/04-technical-godot.md
HUD, menus, SFX, BGM, save	specs/05-ui-audio.md

Conventions

• GDScript only for gameplay unless otherwise specified; Godot 4.x (CharacterBody2D, TileMapLayer, etc.).
• Tile size: 16×16 px (or 32×32); keep level and collision aligned.
• Signals: Prefer signals for player death, goal reached, score/coins; use GameManager (or equivalent) autoload for lives, score, level list.
• No new mechanics that contradict the specs without updating the spec first.

Quick reference

• Player: CharacterBody2D; coyote time + jump buffer; small/big/fire; invincibility frames.
• Enemies: enemy group; stomp = from above; fireball kills; Goomba/Koopa turn at edges.
• Blocks: Head bump from below; ? block spawns item; brick breaks when big.
• Levels: TileMapLayer(s), spawn marker, goal Area2D, camera limits, kill Y.

For full details, always read the relevant spec file.