Godot Platformer

A complete pixel-art 2D platformer for Godot 4.7, built so your AI agent can turn it into your game.

What's inside

• Movement: responsive running and jumping, tuned to feel good, with coyote time, jump buffering, variable jump height, apex hang, and corner and ledge correction. Double jump and wall jump are ready behind config switches. Every number is in one config file, in tiles and seconds.
• Levels: 8 levels in 2 worlds (meadow and cavern), each with coins, 3 hidden stars, checkpoints and a goal portal.
• Hazards: springs, moving platforms, crumbling blocks, one-way ledges, spikes and pits.
• Enemies: walkers to stomp, flyers, and spikers that you mustn't stomp.
• Screens: title, level select (one page per world), HUD with hearts, coins, stars and timer, pause, and results with best times. Progress is saved.
• Look and sound: original pixel art, a pixel font, parallax backgrounds, 16 sound effects and 3 music loops, all free to ship.
• Levels are plain-text ASCII maps, the format AI agents edit best.

For your agent

• AGENTS.md: the brief, with 14 step-by-step recipes.
• A deterministic simulation with 49 headless checks, covering movement against config, collision, every actor, every screen, and real input.
• A reach linter: can the player get to every star with the current jump settings?
• An autopilot bot: it finishes every level, and its recorded runs are re-played on every check run.
• Tools to see the game and its numbers: screenshots of any spot in a level, a feel report (jump distance, air time) and replay traces.

Use it with your agent

1. Unzip this folder where your project will live.
2. Install Godot 4.7.
3. Open the folder with your agent and say something like:

> This is a platformer template. Read AGENTS.md, then let's make it my game: a frog hopping through a swamp called "Lily Leap". My sprites are in ~/art/frog (32 px). Make jumping a bit floatier and turn on double jump.

Run it yourself

godot --path .

Arrows or WASD move, Space or Z jumps, and Esc pauses. A gamepad works too.

License

You can use, modify and ship games made from this template, including commercially, with no attribution. You can't resell the template itself. See LICENSE.md. The placeholder assets are listed in assets.json and CREDITS.md.

Made by CodePlate.