Brobot
Get started

Get started ยท four steps

In your world in five minutes.

You need Minecraft Java with version 1.21.11 installed in the launcher, and Node.js 20 or newer. Brobot brings everything else.

  1. Install

    Open a terminal in Brobot's bot folder and install what he needs.

    npm install

  2. Start the world

    This runs a small Minecraft server on your computer. The first run downloads Mojang's official server and needs you to accept the Minecraft EULA, which is what the flag does.

    npm run server -- --accept-eula

  3. Join it

    Launch Minecraft 1.21.11, then Multiplayer, Direct Connection, and enter the address below. The first person to join becomes an operator.

    localhost

  4. Start Brobot

    In a second terminal, same folder. He joins, says hi, and waits for orders. Try "help", "follow me" or "build a house".

    npm start

Optional

Give him the Claude brain.

Without a key he runs on built-in rules, which cover every command on the Commands page. With one, free-form chat goes to Claude. Set the key before you start him.

export ANTHROPIC_API_KEY=your-key

The model and effort level are in config.json. The default is claude-opus-5-5 at low effort, which keeps replies quick.

Questions

Before you ask.

Why does he need a server?

Brobot is a separate player. A single-player world only lets in accounts that own the game, so he cannot join one. The bundled server runs in offline mode, which lets him in under his own name.

Can other people join that server?

No. It listens only on your own computer (127.0.0.1), because offline mode would otherwise let anyone join under any name.

Can I use a world I already have?

Yes. Stop the server and copy the world's folder from your Minecraft saves into bot/server/world. Your inventory will not carry over, because the server identifies players differently.

Which Minecraft versions work?

He is built and tested on Java Edition 1.21.11. Bedrock Edition is not supported.

Who can give him orders?

Anyone on the server, unless you list names under owners in config.json. With several players online he only answers when you start with his name.

He died. Now what?

He respawns, tells you where it happened, and remembers the spot. Say "get your stuff" and he walks back for it.