+12
Daily
6,011
stars
1,002
forks
72
watchers
448
prs
396
issues
5
releases
README
🧠mindcraft⛏️ Crafting minds for Minecraft with LLMs and Mineflayer! FAQ | Discord Support | Video Tutorial | Blog Post | Paper Website | MineCollab [!Caution] Do not connect this bot to public servers with coding enabled. This project allows an LLM to write/execute code on your computer. The code is sandboxed, but still vulnerable to injection attacks. Code writing is disabled by default, you can enable it by setting allow_insecure_coding to true in settings.js. Ye be warned. Getting Started Requirements - Minecraft Java Edition (up to v1.21.11, recommend v1.21.6) - Node.js Installed (Node v18 or v20 LTS recommended. Node v24+ may cause issues with native dependencies) - At least one API key from a supported API provider. See supported APIs. OpenAI is the default. [!Important] If installing node on windows, ensure you check Automatically install the necessary tools If you encounter npm install errors on macOS, see the FAQ for troubleshooting native module build issues Install and Run 1. Make sure you have the requirements above. 2. Download the latest release and unzip it, or clone the repository. 3. Rename keys.example.json to keys.json and fill in your API keys (you only need one). The desired model is set in andy.json or other profiles. For other models refer to the table below. 4. In terminal/command prompt, run npm install from the installed directory 5. Start a minecraft world and open it to LAN on localhost port 55916 6. Run node main.js from the installed directory If you encounter issues, check the FAQ or find support on discord. We are currently not very responsive to github issues. To run tasks please refer to Minecollab Instructions Configuration Model Customization You can configure project details in settings.js. See file. You can configure the agent's name, model, and prompts in their profile like andy.json. The model can be specified with the model field, with values like model: "gemini-2.5-pro". You will need the correct API key for the API provider you choose. See all supported APIs below. ⭐ VIEW SUPPORTED APIs ⭐ | API Name | Config Variable| Docs | |------|------|------| | openai | OPENAI_API_KEY | docs | | google | GEMINI_API_KEY | docs | | anthropic | ANTHROPIC_API_KEY | docs | | xai | XAI_API_KEY | docs | | deepseek | DEEPSEEK_API_KEY | docs | | ollama (local) | n/a | docs | | qwen | QWEN_API_KEY | Intl./cn | | mistral | MISTRAL_API_KEY | docs | | replicate | REPLICATE_API_KEY | docs | | groq (not grok) | GROQCLOUD_API_KEY | docs | | huggingface | HUGGINGFACE_API_KEY | docs | | novita | NOVITA_API_KEY | docs | | openrouter | OPENROUTER_API_KEY | docs | | hyperbolic | HYPERBOLIC_API_KEY | docs | | vllm | n/a | n/a | | cerebras | CEREBRAS_API_KEY | docs | | mercury | MERCURY_API_KEY | docs | For more comprehensive model configuration and syntax, see Model Specifications. For local models we support ollama and we provide our own finetuned models for you to use. To inst
Top issues
#424{ errno:-4079,代码:'ECONNABORTED',系统调用:'write' }错误事件!{ errno:-4079,代码:'ECONNABORTED',系统调用:'write' }28 comments · 2025-01-31#268Bot don't see my messages13 comments · 2024-10-29#741Bot constantly crashing10 comments · 2026-03-20#627Other free APIs9 comments · 2025-09-25#613Does the account own minecraft?8 comments · 2025-09-16#800Problem about Items Putting6 comments · 2026-07-04#798Code execution triggered catch: PathStopped: Path was stopped before it could be completed! Thus, the desired goal was not reached.6 comments · 2026-06-18#436Failed to initialize examples6 comments · 2025-02-06
Latest release
Mindcraft v0.1.4 | General Maintenance v0.1.4 2026-03-20Bug fixes, documentation updates, and stability. What's Changed added "goToSurface" skill/action by @Lawtro37 Pathfinder improvments by @Ninot1Quyi Docker improvments by @htqkeku-eftc @Wuodan @uukelele Fix custom OpenAI endpoints by @uukelele in https://github.com/mindcraft-bots/mindcraft/pull/646 Revise installation instructions in minecollab.md by @icwhite in https://github.com/mindcraft-bots/mindcraft/pull/701 Improve connection stability for Paper/Spigot servers by @atiweb in https://github.com/mindcraft-bots/mindcraft/pull/704 Updated default models Many general docume