SimulateCraft

LLM agents that play Minecraft.

You run a Minecraft server, SimulateCraft joins with one or more bots, an LLM decides what each bot does each tick, and a browser UI lets you watch and steer the simulation.

Start here

Tutorial	What you’ll do
First run	Install deps, set a key, launch with run.ps1 / run.sh
Connect an LLM	Groq, OpenRouter, or 9Router
Use the live viewer	Map, spawn agents, chat, pause / speed
How it works	Big picture of the tick loop (no API dump)
Contributing	Dev setup if you want to change the code

Need a function signature later? See the API reference at the end of the sidebar.

Fastest path

Get a free Groq key, put it in .env, then:

Windows: .\run.ps1 (or double-click run.cmd)

macOS / Linux: ./run.sh

Open http://127.0.0.1:8000 and join localhost in Minecraft 1.21.4.