A desktop app for running Minecraft bots without writing code. Log in, join a server, and then drive the bot yourself, turn on one of the 26 built-in scripts, or just ask it to do stuff in chat with a local AI. Built on Mineflayer.
- Log in your way. Microsoft accounts work through an in-app window or your browser (the device code gets copied for you), and accounts you've used before are remembered. Offline mode works with any name.
- Drive it yourself. WASD, jump, sneak and sprint from the keyboard or the on-screen pad. You see HP, hunger, coords and the held item, plus a radar of nearby players, mobs and signs. Signs show their text and have Click, Hit and Go buttons, which is great for joining minigames on lobby servers.
- Full inventory. All 46 slots with counts and durability, one-click Auto-Gear, and whatever chest, shop or menu the server opens. You can left, right or shift-click through those just like in game.
- 26 built-in scripts. Farming, fishing, mining, tunneling, building, chest looting, combat, auto-eat, auto-armor, reconnecting, a full wood-to-diamond GearUp and a Survival mode that just plays on its own. Your settings stick between sessions. Full list below.
- Local AI chat. Hit Auto-Setup and it downloads Ollama and a model that fits your PC (Qwen 3, Gemma 3, Llama, Phi-4 Mini...). The bot then chats like a normal player and splits long replies into a few messages with small random gaps, so anti-spam plugins don't kick it. Nothing goes to the cloud.
- AI Agent. Turn on Actions and players can say "come here", "follow me", "mine 10 oak logs" or "turn on killaura and autoeat" and the bot does it. It can switch any module on or off, change module options and read its own logs to work out why something failed. Clear orders run straight away without asking the model at all, so even tiny models like
llama3.2:1bget them right. On lobby servers it can "join kitpvp" by opening the compass menu and clicking the game. It thinks in a private space that only shows up in the console, then checks its own work (did that actually do what was asked? if not, it tries once more another way) before writing a short reply to whoever asked, so in chat it just talks like a normal player. When it gets stuck it jumps, re-paths, digs or bridges, and if something fails it tries another way. You choose who's allowed to give it orders, and if you really trust them, you can let it write its own Mineflayer code. - AI fixes modules. Once the local AI is set up, every module gets an AI Fixes Errors option. When that module gets stuck or reports a problem, the AI reads the logs and tries to fix it (changes the module's options, restarts it, moves somewhere better). What it tried shows up in the console, never in server chat.
- Script Studio. Start from a template, read the Mineflayer docs right next to the editor (downloaded for your version, with an offline copy built in), or describe what you want and let your local AI write it. It checks for errors and drops the script straight into the Scripts tab.
- Chat and console. Server chat with all its colors and formatting,
/commandswith arrow-key history, and!bot commands:!do <commands>,!help,!pos,!hp,!gear,!gearup [wood|stone|iron|diamond],!signs,!sign <text>,!ai <msg>,!logs,!close,!weapon,!tool <block>,!goto <x> <y> <z>,!follow <player>,!guard <player>,!hunt <player>,!stop,!dropall,!respawn. - Keeps up with Minecraft. It checks npm in the background for newer
mineflayer,minecraft-dataandmineflayer-pathfinder, so new Minecraft versions usually work without a new MCBP build. Leave the version onAutoand it detects the server version. - Session logs. Every session writes a Markdown log you can open with
!logs. Handy for bug reports. - Make it yours. Drop
.jsfiles intocustom/scriptsand restyle the whole app withcustom/theme.css.
| Script | Options | Description |
|---|---|---|
| AIAgent | Reply to All Chat, Model, Allowed Players, Allow Code |
Lets the local AI run bot actions (move, follow, mine, attack, toggle scripts) from chat |
| AntiAFK | Jump, Move, Rotate, Sneak |
Performs randomized movement actions to prevent idle kicks |
| AutoArmor | Repeat, Offhand Shield/Totem |
Equips the highest-tier armor pieces from inventory and keeps a totem or shield in off-hand |
| AutoBuild | Template / File, Size [blocks] |
Builds structures (platform, wall, bunker, tower, bridge, or .json schematic files) |
| AutoEat | Repeat, Eat on Low HP, Min Food [1-20] |
Pauses combat to eat high-saturation food when hungry or golden apples when health drops |
| AutoFarm | Replant Seeds, Use Bone Meal, Collect Drops, Radius [blocks] |
Harvests mature crops, replants seeds on farmland/soul sand, applies bone meal, and loots drops |
| AutoFish | Auto Equip Rod, Anti-AFK Glance |
Casts a fishing rod toward water and reels in catches automatically |
| AutoReconnect | Resume Scripts, Delay [sec] |
Automatically rejoins the server after a disconnect or kick and resumes active scripts |
| AutoRespawn | Return to Area, Work Area [X Y Z] |
Automatically respawns upon death and paths back to the work area or death coordinates |
| AutoTool | Mine Tools, Combat Weapon, Save Durability |
Switches to the fastest harvesting tool when breaking blocks and best weapon in combat |
| AutoTotem | AutoLog Low HP, Min HP [1-20] |
Keeps a Totem of Undying in the off-hand slot and optionally disconnects on critical HP |
| ChatAI | Reply to All Chat, Context, Split Replies, Model, Cooldown, Persona |
Replies to players in chat with a local Ollama model, paced to avoid anti-spam kicks |
| ChestStealer | Steal Supplies, Deposit Mined, Repeat, Filter |
Withdraws supplies from nearby chests/barrels/shulkers or deposits mined resources into storage |
| ClearInv | Repeat |
Drops all stacks from the bot's inventory |
| Excavator | Tunnel Mode, Auto Tool, Size / Width, Length / Depth |
Digs straight tunnels or clears 3D quarry volumes layer by layer using the best tool |
| Follow | Repeat, Sprint Jump, Pillar / Bridge, Player Name, Delay |
Continuously paths to a target player with sprint-jump and Baritone-style bridging |
| GearUp | Tools & Sword, Full Armor, Craft Shield, Tier [wood/stone/iron/diamond] |
Full progression from chopping wood to smelting iron and mining/crafting diamond armor & tools |
| GoTo | Repeat, Dig Obstacles, Pillar / Bridge, X, Y, Z |
Paths to world coordinates with optional obstacle digging, pillaring, and bridging |
| Guard | Hostile Mobs, Defend PvP, Auto Weapon, Protect Player, Radius |
Escorts a target player and attacks threats with jump-criticals and combat eating pauses |
| Hunt | Auto Weapon, Sprint Jump, Criticals, Target Player |
Relentlessly pursues and attacks a target player with sprint-jumps, falling crits, and auto-eat |
| InvManager | Drop Junk, Sort & Equip, Keep Free Slots, Extra Junk |
Keeps inventory clean by dropping junk blocks when slots fill while preserving ores and gear |
| KillAura | Hostile Mobs, Players, Passive Mobs, Auto Weapon, Criticals, Range |
Aims at and attacks selected target types within range with jump-critical hits |
| Mine | Repeat, Auto Tool, Block ID |
Finds nearby blocks matching Block ID, paths to them, selects the best tool, and mines them |
| SafeWalk | Sneak at Edges, Avoid Lava/Fire |
Prevents walking off ledges (>1 block drop) or into lava/fire by crouching at block edges |
| Spam | Repeat, AntiKick, Message, Delay [ms] |
Sends chat messages on a configurable interval with an optional random suffix |
| Survival | Self Defense, Auto Gear & Eat, Collect Drops, Look Around |
Plays autonomously: swims in water, eats, equips gear, blocks creepers, crits attackers, loots |
The AI Agent and the !do console command both understand simple commands and turn them into Mineflayer code for you. Put one per line or split them with ; or then, and they run in order (it waits to arrive before moving on).
walk to ancymon follow me stop
walk 100 64 -20 look at ancymon come here
mine 10 oak_log attack zombie attack hostile
eat · gear · hold diamond_sword · drop 5 dirt · drop all
say hello · wait 3s · jump twice · sneak on · forward 2
turn on killaura players=on range=4 turn off killaura
turn on killaura and autoeat stop all scripts
set spam message hi there status · logs 20 error · scripts
join kitpvp use compass click kitpvp close hotbar 3 /server kitpvp
Module names are forgiving (aura, auto eat, fishing all work), and so are block names (oak logs, wood, diamonds). The console shows the JavaScript each command became. Lines that are already JavaScript only run when Allow Code is on.
Grab the latest build for your system from the Releases page:
- Windows:
MCBPv<version>-win.x64-setup.exe(installer) or the.zip - Ubuntu / Debian / Mint / Pop!_OS:
MCBPv<version>-linux.amd64.deb - Fedora / openSUSE / RHEL:
MCBPv<version>-linux.x86_64.rpm - Arch / Manjaro / EndeavourOS:
MCBPv<version>-linux.x64.pacman(sudo pacman -U <file>) - Any other distro:
Minecraft-Bot-Panel-<version>-x86_64.AppImageor the.tar.gz - macOS (Intel & Apple Silicon):
MCBPv<version>-mac.<arch>.dmg. The app isn't notarized, so the first time right-click it and pick Open (on newer macOS: System Settings → Privacy & Security → Open Anyway).
You don't need Node.js for any of these. Mineflayer, Ollama and the docs all get downloaded by the app when it needs them.
Updates are optional and the app asks first. Windows, 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.
- Install Node.js (v20+ recommended) and install dependencies:
npm install npm start
- Build packages into
dist/:On Linuxnpm 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
npm run makebuilds all the Linux packages plus the Windows installer. rpm needsrpmbuildand pacman needsbsdtar; if one is missing that package just gets skipped. macOS builds only work on a Mac (Apple's tools don't run anywhere else); there it builds the Mac, Linux and Windows packages.
The easiest way is the Studio tab: pick a template or describe what you want and let your local AI write it, then hit Save & Load. If you'd rather do it 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 };bot: Active Mineflayer bot instance (bot.pathfinderis preloaded on spawn).log(text): Logs a timestamped message to the Console Logs panel. Prefixing withModuleName: messageformatsModuleNameas a colored badge.clearLog(matchText): Removes existing log rows containingmatchTextso status updates replace cleanly in place.await getOption(id, info.name): Reads the current value of an option ("on"/"off"for checkboxes, or string value for text inputs).await scriptRepeater(fn, intervalMs): Runsfn()everyintervalMswhile the script remains toggled on and resolves once toggled off.libs: Runtime libraries{ goals, Movements, Vec3, mcData }(6th argument), so scripts don't need torequireMineflayer packages.- Option types:
checkbox,input(optionalplaceholder), andselectwithchoices: ["a", "b"]or[{ value, label }].
Scripts get full Node.js access, so only run ones you wrote or trust.
Not a fan of purple? Override the colors (or anything else) in 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;
}No analytics, no accounts, nothing sent to me. Logins, settings, logs and AI models stay on your machine. The full policy is on the website.
GPL-3.0. Found a bug? Open an issue.
