GodotMaker  by RandallLiuXin

Autonomous pipeline generates Godot games from text

Created 2 months ago
351 stars

Top 79.4% on SourcePulse

GitHubView on GitHub
Project Summary

Autonomous text-to-game pipeline for Godot, powered by AI agents, GodotMaker transforms game ideas into playable projects. It addresses common AI game development issues by offering a local-first, source-available framework that generates complete, modifiable Godot projects. This enables rapid prototyping and iteration on 2D game concepts without platform lock-in or extensive manual intervention, making game creation more accessible.

How It Works

A CLI (godotmaker-cli) orchestrates AI agents to refine user-inputted game ideas into Game Design Documents (GDDs). The pipeline autonomously handles planning, GDScript implementation, unit and end-to-end testing, gameplay simulation, screenshot generation, and iterative bug fixing. This "no-human-in-the-loop" approach runs for hours, producing a standard Godot project ready for local development, debugging, and publishing.

Quick Start & Requirements

  • Install: npm install -g godotmaker-cli
  • Project Setup: mkdir my-game && cd my-game && godotmaker
  • Prerequisites: Godot 4.5+, Claude Code or Codex, Node.js 18+, Python 3.10+, Git 2.30+. API keys may be needed for specific providers.
  • Learn More: Links to "Installation", "Your first game", "How it works", "Common problems", "Roadmap", "Full docs", and "Status" are referenced within the README.

Highlighted Details

  • Fully autonomous, "no-human-in-the-loop" game generation by default.
  • Outputs a complete, standard Godot project with all source files, assets, tests, and reports.
  • Supports design-driven iteration by refining the initial idea or GDD.
  • Features a local-first workflow and a source-available framework for transparency and modification.
  • Orchestrated end-to-end via a dedicated CLI tool.

Maintenance & Community

Community engagement is encouraged via starring the repo and opening issues for desired features or improvements. Specific community channels (e.g., Discord, Slack) or direct contributor information are not detailed in the README. Links to "Roadmap" and "Status" pages are available for further information.

Licensing & Compatibility

The framework uses the Business Source License 1.1 (BSL 1.1), which converts to Apache License 2.0 four years after each version's public release. Generated games are fully owned by the user, subject to any third-party engine, asset, model-provider, runtime, or dependency terms. Permitted uses under BSL 1.1 are free.

Limitations & Caveats

The Codex runner and art-production pipeline are currently in preview, with potential needs for manual asset review and replacement. The pipeline exclusively targets 2D games; 3D development is not supported. Audio generation is also not included, requiring manual asset integration. External agent runtimes may experience transient issues, though the workflow is designed for resilient resumption from local project state.

Health Check
Last Commit

18 hours ago

Responsiveness

Inactive

Pull Requests (30d)
42
Issues (30d)
16
Star History
351 stars in the last 30 days

Explore Similar Projects

Starred by Peter Norvig Peter Norvig(Author of "Artificial Intelligence: A Modern Approach"; Research Director at Google).

codev by cluesmith

1.4%
278
AI-powered OS for human-agent software co-development
Created 9 months ago
Updated 1 day ago
Feedback? Help us improve.