OpenCode Minecraft Bot

A completely hackable, docker-compose Minecraft bot that writes its own code on the fly.

Powered by Bun and OpenCode.

View on GitHub

Key Features

🤖

Self-Coding

The bot can write new TypeScript behaviors for itself while running, adapting to new challenges instantly.

âš¡

Hot Reloading

New behaviors are automatically loaded without restarting the bot. Zero downtime for updates.

💬

Natural Language

Control the bot with plain English. Just say "Follow me" or "Build a house" and watch it happen.

Get Started

Prerequisites

  • • Docker & Docker Compose
  • • OpenCode CLI (log in locally)

Installation

Clone the repository:

git clone https://github.com/bcjordan/bun-ai-minecraft.git
cd bun-ai-minecraft

Configuration

Set up your environment variables:

cp .env.example .env

Edit .env: Set MC_HOST (use host.docker.internal for local server) and MC_PORT.

Run

Start the bot and OpenCode server:

docker-compose up --build