BuilderGPT

* Structure in the banner is generated by BuilderGPT with model gemini-2.5-pro.

⚠️ Project Status: Development Paused

Thank you to everyone who has supported this project! As we continued to explore the intersection of AI and Minecraft, we discovered a much more elegant and native solution. Therefore, active development on this project has been paused. We highly recommend all users check out our brand-new, next-generation project: MineClawd.

Compared to this project (which requires out-of-game generation, tedious setups, and external schematic imports), MineClawd brings the highly autonomous OpenClaw AI agent framework directly into Minecraft!

Why switch to MineClawd?

• 🧠 Ultimate Freedom: Accomplish almost anything in-game by executing instant or persistent KubeJS code.
• 📦 In-game generation: Generate Minecraft buildings in-game, with enhanced quality.
• ⚡ Seamless Experience: Runs smoothly as a Server-only mod with immediate effects. An optional Client mod is also available for a user-friendly GUI.

Everything this old project tried to achieve, MineClawd does better, faster, and seamlessly in-game.

🌟 Discover and Support MineClawd:

• Modrinth: Download here (Supports NeoForge 1.21.1 | Forge 1.20.1 | Fabric 1.20.1)
• GitHub: Zhou-Shilin/MineClawd (If you like the concept, please drop a ⭐ Star!)

A generative Minecraft structure tool for the Cynia Agents framework.

BuilderGPT lets you describe a building and have a language model produce a ready-to-use schematic. The component outputs either a .schem file or a .mcfunction script that can be imported into the game with tools like WorldEdit.

Installation

1. Install the Cynia Agents framework by following the instructions in its repository.
2. Copy this BuilderGPT folder into the framework's components/ directory.
3. Install the requirements in the same Python environment:

   pip install -r components/BuilderGPT/requirements.txt

4. Start the Cynia Agents UI (python -m streamlit run web.py).
5. Enable BuilderGPT from the Component Center page.

Usage

After enabling, a new BuilderGPT page appears in the sidebar. Select your Minecraft version, choose an export format and describe the structure you want. The component will call the configured LLM provider and save the resulting file inside the generated/ folder.

Features

• Generate structures using natural language
• Export as .schem or .mcfunction
• Works entirely within Cynia Agents

Credits

• MCBench (mcbench.ai) — BuilderGPT’s support for a JavaScript-based building/structure representation and elements of its prompting approach are inspired by MCBench. The JavaScript parsing and integration code used here was implemented independently for this project.

License

This project is licensed under the Apache 2.0 License. See LICENSE for details.