Loading MCBP…

Download now!

Download Source Code

Documentation

1. Installation

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:

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.

Running from source

Grab Node.js (v20 or newer) and run:

Terminal
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

2. Connecting & Using the Panel

3. Built-in Scripts

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.

Options: Reply to All Chat, Actions Model, Allowed Players, Allow Code

Stops idle kicks by doing your checked actions at random.

Options: Jump, Move, Rotate, Sneak

Puts on the best armor it has and keeps a totem or shield in the off-hand.

Options: Repeat, Offhand Shield/Totem

Builds a platform, wall, bunker, tower or bridge, or a .json schematic you give it.

Options: Template / File, Size [blocks]

Eats when hungry, and goes for golden apples when health gets low. Pauses combat while eating.

Options: Repeat, Eat on Low HP, Min Food [1-20]

Harvests grown crops, replants, uses bone meal and picks up the drops.

Options: Replant Seeds, Use Bone Meal, Collect Drops, Radius [blocks]

Casts toward water and reels in catches on its own.

Options: Auto Equip Rod, Anti-AFK Glance

Rejoins after a kick or disconnect and turns your scripts back on.

Options: Resume Scripts, Delay [sec]

Respawns after death and walks back to the work area or where it died.

Options: Return to Area, Work Area [X Y Z]

Swaps to the fastest tool when digging and the best weapon when fighting.

Options: Mine Tools, Combat Weapon, Save Durability

Keeps a Totem of Undying in the off-hand and can log out when HP gets too low.

Options: AutoLog Low HP, Min HP [1-20]

Talks back to players with your local Ollama model, paced so anti-spam plugins don't kick it.

Options: Reply to All Chat, Game State Context, Split Long Replies, Model, Cooldown [sec], Message Gap [sec], Persona / Prompt

Takes supplies out of nearby chests, barrels and shulkers, or dumps mined stuff into them.

Options: Steal Supplies, Deposit Mined, Repeat, Filter (optional)

Drops everything in the inventory on the ground.

Options: Repeat

Digs a straight tunnel or clears out a quarry layer by layer.

Options: Tunnel Mode, Auto Tool, Size / Width, Length / Depth

Keeps walking after a player, sprint-jumping and bridging or pillaring when it has to.

Options: Repeat, Sprint Jump, Pillar / Bridge, Player Name, Delay (optional)

Goes from punching trees all the way to iron or diamond tools and armor, crafting and smelting on the way.

Options: Tools & Sword, Full Armor, Craft Shield, Tier [wood/stone/iron/diamond]

Walks to coordinates. Can dig through stuff in the way and bridge or pillar. Leave Y empty to keep the current height.

Options: Repeat, Dig Obstacles, Pillar / Bridge, X, Y (optional), Z

Sticks with a player and fights off mobs or anyone attacking them.

Options: Hostile Mobs, Defend PvP, Auto Weapon, Protect Player, Radius [blocks]

Chases a player down and fights them with sprint-jumps and crits, eating when it needs to.

Options: Auto Weapon, Sprint Jump, Criticals, Target Player

Drops junk blocks when the inventory fills up, but keeps ores and gear.

Options: Drop Junk, Sort & Equip, Keep Free Slots, Extra Junk

Attacks whatever target types you pick within range, with jump crits.

Options: Hostile Mobs, Players, Passive Mobs, Auto Weapon, Criticals, Range [blocks]

Finds blocks by ID (like oak_log or stone), walks over and mines them.

Options: Repeat, Auto Tool, Block ID

Sneaks at edges so it doesn't fall off, and stays away from lava and fire.

Options: Sneak at Edges, Avoid Lava/Fire

Sends a chat message every few seconds. AntiKick adds a random tag at the end.

Options: Repeat, AntiKick, Message, Delay [ms]

Just plays on its own: swims, eats, gears up, deals with creepers, fights back and loots.

Options: Self Defense, Auto Gear & Eat, Collect Drops, Look Around

4. Local AI (ChatAI & AIAgent)

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).

5. Script Studio & Custom Scripts

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:

custom/scripts/hellobot.js
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 };

Scripts can do anything Node.js can, so only run ones you wrote yourself or got from someone you trust.

6. Custom Theme (CSS)

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:

custom/theme.css
: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;
}
Back to Home