Godot Idle Clicker

A complete idle/clicker game for Godot 4.7, built so your AI agent can turn it into your game.

What's inside

• "Crystal Mine": tap the glowing crystal for gems, and buy 8 machines that mine for you, from a pickaxe to a quantum rig.
• Upgrades and achievements: 8 upgrades (stronger taps, faster machines, global boosts) and 9 achievements with permanent bonuses.
• Offline and prestige: offline earnings with a welcome-back popup, and Ascend (prestige) for stardust that boosts everything forever.
• Quality of life: autosave, buy ×1, ×10, ×100 or MAX, number formatting (1.23M or 1.23e6), sound and music.
• Look and feel: juicy tap feedback (squash, glow, flying gems, popups), and a portrait, mobile-first layout.
• Content as data: every machine, upgrade and achievement lives in JSON files, the easiest content for an agent to edit.
• Free to ship: original placeholder art, sound and music.

For your agent

• AGENTS.md: the brief, with 9 step-by-step recipes and a full content reference.
• A pure economy core, with headless checks for every rule.
• A pacing simulator. A bot plays the game fast-forward, and the checks fail if the first machine, every machine, or the first ascend miss their target times.
• A screenshot tool that can fast-forward to mid-game, so the agent can see what it changed.

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 an idle game template. Read AGENTS.md, then let's make it mine: you tap a big cookie and buy grandmas, ovens and factories. First ascend after about 20 minutes.

Run it yourself

godot --path .

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.