Loading MCBP…
Hit Download up top. It figures out what system you're on and points you at the right file, but here's the full list if you'd rather pick yourself:
MCBPv<version>-win.x64-setup.exe (installer) or
the .zip if you don't want to install anything.
MCBPv<version>-linux.amd64.deb
MCBPv<version>-linux.x86_64.rpm
MCBPv<version>-linux.x64.pacman, install it with
sudo pacman -U <file>
.AppImage or the
.tar.gz
MCBPv<version>-mac.<arch>.dmg. It isn't
notarized, so the first time you open it right-click the app and
pick Open (on newer macOS go to System Settings →
Privacy & Security → Open Anyway).
You don't need Node.js for any of these. Mineflayer, Ollama and the Mineflayer docs all get downloaded by the app when it needs them, so new Minecraft versions usually work without waiting for a new MCBP release.
Updates are optional and the app always asks first. The Windows installer, AppImage, deb, rpm and pacman builds update themselves (Linux packages ask for your password once). On macOS and the zip / tar.gz builds it just downloads the new version or opens the release page for you.
Grab Node.js (v20 or newer) and run:
npm install
npm start
# build packages into dist/
npm run make # everything your OS can build
npm run make:linux # AppImage, deb, rpm, pacman, tar.gz
npm run make:win # setup.exe + zip
npm run make:mac # dmg + zip, needs a Mac
host or
host:port (port defaults to 25565). Leave
Version on Auto and it'll detect the
server version, or pick one from the list.
WASD, Space, Shift,
Ctrl and the arrow keys, or the on-screen pad. You get
live HP, hunger, coordinates and held item, plus lists of nearby
Players, Mobs and
Signs. Signs show their text and have
Click, Hit and
Go buttons, which is handy for joining minigames on
lobby servers.
/commands for the server (arrow keys go through your
history), or start with ! for bot commands:
!help, !pos, !hp,
!gear, !gearup [tier],
!signs, !sign <text>,
!ai <msg>, !logs,
!close, !weapon,
!tool <block>,
!goto <x> <y> <z>,
!follow <player>,
!guard <player>,
!hunt <player>, !stop,
!dropall, !respawn.
MCBP ships with 26 scripts. Fill in the options first, then click the title bar to turn it on (green) or off. Your settings are saved between sessions. Click the titles below to see how it looks:
Lets players ask the bot to do things in chat (come here, follow me, mine some logs, turn on a script). Needs the local AI set up first.
Stops idle kicks by doing your checked actions at random.
Puts on the best armor it has and keeps a totem or shield in the off-hand.
Builds a platform, wall, bunker, tower or bridge, or a .json schematic you give it.
Eats when hungry, and goes for golden apples when health gets low. Pauses combat while eating.
Harvests grown crops, replants, uses bone meal and picks up the drops.
Casts toward water and reels in catches on its own.
Rejoins after a kick or disconnect and turns your scripts back on.
Respawns after death and walks back to the work area or where it died.
Swaps to the fastest tool when digging and the best weapon when fighting.
Keeps a Totem of Undying in the off-hand and can log out when HP gets too low.
Talks back to players with your local Ollama model, paced so anti-spam plugins don't kick it.
Takes supplies out of nearby chests, barrels and shulkers, or dumps mined stuff into them.
Drops everything in the inventory on the ground.
Digs a straight tunnel or clears out a quarry layer by layer.
Keeps walking after a player, sprint-jumping and bridging or pillaring when it has to.
Goes from punching trees all the way to iron or diamond tools and armor, crafting and smelting on the way.
Walks to coordinates. Can dig through stuff in the way and bridge or pillar. Leave Y empty to keep the current height.
Sticks with a player and fights off mobs or anyone attacking them.
Chases a player down and fights them with sprint-jumps and crits, eating when it needs to.
Drops junk blocks when the inventory fills up, but keeps ores and gear.
Attacks whatever target types you pick within range, with jump crits.
Finds blocks by ID (like oak_log or
stone), walks over and mines them.
Sneaks at edges so it doesn't fall off, and stays away from lava and fire.
Sends a chat message every few seconds. AntiKick adds a random tag at the end.
Just plays on its own: swims, eats, gears up, deals with creepers, fights back and loots.
The AI runs on your own PC through Ollama. No API keys, nothing sent to the cloud. Open the AI tab and hit Auto-Setup: it downloads Ollama if you don't have it and pulls a model that fits your hardware (Qwen 3, Gemma 3, Llama 3, Phi-4 Mini and a few others).
!ai in the console to check the status, or
!ai <message> to make it reply to something.
The Studio tab is the easiest way to make your own script. Start from a template (chat commands, announcer, welcome messages, look at players, collect blocks, health alert, auto sleep...), read the Mineflayer docs right next to the editor (they download for your version, and there's an offline copy built in), or describe what you want and let your local AI write it. It checks the code for errors, and Save & Load drops it straight into the Scripts tab.
You can also write them by hand. Click Folder in the
Scripts tab (or open custom/scripts/) and add a
.js file that exports info and
script:
const info = {
name: "HelloBot",
default: { interval: 3000 },
options: [
{ type: "checkbox", label: "Repeat", id: "repeat" },
{ type: "input", label: "Greeting", id: "greeting" },
],
};
async function script(bot, log, clearLog, getOption, scriptRepeater) {
if (!bot) return log("HelloBot: Connect a bot first");
async function sendGreeting() {
const greeting = await getOption("greeting", info.name);
bot.chat(greeting || "Hello!");
}
await sendGreeting();
if ((await getOption("repeat", info.name)) === "on") {
await scriptRepeater(sendGreeting, info.default.interval);
}
}
module.exports = { info, script };
name, optional
default values and the options list.
Options can be "checkbox", "input" (with
an optional placeholder) or "select" with
choices: ["a", "b"] or [{ value, label }].
null if
you're not connected. bot.pathfinder is already loaded.
log adds a line to the console (start it with
Name: ... to get a colored badge),
clearLog removes old lines containing
match so status updates don't flood it.
"on" / "off", inputs give
a string.
fn() on a loop while the script is on, and returns when
you turn it off or disconnect.
{ goals, Movements, Vec3, mcData }, so you don't have
to require anything.
Scripts can do anything Node.js can, so only run ones you wrote yourself or got from someone you trust.
Don't like purple? Edit custom/theme.css. Anything in
there gets loaded on every screen, so you can override the colors or
restyle whatever you want:
:root {
--bg-dark: #16131f;
--panel-bg: #1e1a2b;
--background-color: #9171f8;
--dark-main-color: #6b4ce6;
--main-color: #b197fc;
--light-main-color: #d3c2ff;
--title-color: #f2edff;
--accent-dark-bg: #2b2342;
--accent-dark-hover: #362c54;
--accent-border: #a488ff;
}