A lightweight Minecraft mod that leverages OpenAI's GPT models to generate small/medium-sized building blueprints (e.g., wooden cabins, huts) directly in-game for performance and stability with strict size constraints.
Project based on MCLLM.
- 🎯 LLM-Driven Building Generation: Generate Minecraft building blueprints via GPT models (GPT-3.5-Turbo default)
- 📏 Strict Size Constraints: Enforces small/medium building limits (max 15x15x8 blocks) to ensure performance
- 🎮 In-Game Commands: Intuitive chat commands to interact with the AI assistant
- 🔒 Secure Token Storage: AES-256 encryption for OpenAI API tokens
- ⚙️ Configurable Settings: Customize model, timeout, context level, proxy, and more
- 📝 Structured Output: Enforces consistent blueprint formatting to avoid parsing errors
- 🚀 Performance Optimized: Limits large/complex structures (e.g., cathedrals) to prevent lag Requirements Minecraft 1.21.11 (Fabric/NeoForge compatible) OpenAI API Key (with valid quota) Java 17+
The mod enforces double-layered size limits for building generation:
- Prompt-Level Restriction: LLM is explicitly instructed to only generate blueprints for small/medium structures (max 15x15x8 blocks)
- Code-Level Validation: Automatically corrects oversized blueprints to fit within 15(L) x 15(W) x 8(H) block limits
- Strict format: [Structure Name] | [LxWxH] | [Block List] | [Simple Layout]
- Use of common Minecraft blocks (wood, stone, glass) only
- No large structures (cathedrals, castles, etc.)
OpenAI API tokens are encrypted with AES-256 before storage Proxy support for restricted networks (no authenticated proxy support) Config file validation to prevent invalid settings
- This project is licensed under the MIT License - see the LICENSE file for details.
/auto-build <from> <to> <building-request>
/auto-build <confirm>