mindcraft-bots /mindcraft

Minecraft AI with LLMs+Mineflayer

★ 6,011⑂ 1,002👁 72⑃ 448● 396▤ 5
JavaScriptMITCreated 2023-08-16
Download: Mindcraft v0.1.4 | General MaintenanceMindcraft-0.1.4 ↓0.1.42026-03-20
+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

Latest release

Mindcraft v0.1.4 | General Maintenance v0.1.4 2026-03-20
Bug 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON