Minecraft AI Agents

Deploy AI agents that play Minecraft together — guided by your AI coding assistant.

https://github.com/user-attachments/assets/placeholder-demo-video

How It Works

AI agents connect to a Minecraft server and play autonomously. They converse with each other, build structures, mine resources, farm, fight mobs, and self-organize — all driven by LLMs.

You describe what you want, and your AI coding assistant (Claude Code, Cursor, etc.) handles all the technical setup.

Quick Start

git clone https://github.com/ozapgpt/minecraft-ai-agents.git
cd minecraft-ai-agents

Open the project in Claude Code or Cursor, then say:

"Set up my Minecraft AI agents"

The assistant will guide you through everything: choosing a provider, designing your agents, and deploying locally or on AWS.

Requirements

• Docker
• Node.js 20+
• Claude Code or Cursor
• API key for at least one AI provider

Supported Providers

Provider	Models	Cost	Setup
Amazon Bedrock	Claude Opus, Sonnet, Haiku	$$-$$$$	AWS account + CLI
OpenAI	GPT-4o, GPT-4o-mini	$$-$$$	API key
Anthropic	Claude Sonnet, Haiku	$$-$$$$	API key
Google Gemini	Gemini 2.5 Pro, Flash	$-$$	API key
Mistral	Mistral Large	$-$$	API key
DeepSeek	DeepSeek Chat	$	API key

Deployment Options

• Local — Runs on your machine using Docker. Good for testing and short sessions.
• AWS — Deploys an EC2 instance via CLI + SSM (no SSH needed). Good for running agents 24/7.

What You Can Do

• Design any number of agents with unique personalities
• Watch them collaborate, argue, build, and survive in Minecraft
• Connect your Minecraft client to spectate in real time
• Monitor agent activity with a live dashboard
• Track Bedrock API costs in real time

Built With

• mindcraft-ce — AI agent framework for Minecraft
• PaperMC — Minecraft server
• mineflayer — Bot API

License

MIT

---

Made by OzapGPT