Hacking Minecraft

Build intelligent Minecraft bots — from simple followers to Claude-controlled agents.

Getting Started

1. Follow the Setup Guide to install Node.js, PaperMC, TLauncher, and Claude Desktop/Code
2. Head to the Curriculum for the tutorials

Project Structure

examples/
  bot-follow-a-player/          # Tutorial 1: Bot that follows a player
  bot-protect-a-player-from-hostile/  # Tutorial 2: Bot that protects from hostiles
mcp/                            # Tutorial 3: MCP server for Claude-controlled bot

Quick Start

Tutorial 1 — Bot Basics

cd examples/bot-follow-a-player
npx tsx src/index.ts -- --player <name>

Tutorial 2 — Smart Bot

cd examples/bot-protect-a-player-from-hostile
npx tsx src/index.ts -- --player <name>

Tutorial 3 — MCP Server

cd mcp
npm install
npm run build
npm start

See CURRICULUM.md for setup instructions with Claude Desktop and Claude Code.