Skip to content

Latest commit

 

History

20 Commits

Folders and files

Repository files navigation

Minecraft Bot Panel

Version License Mineflayer MC Versions Website

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.

Banner

What it can do

  • 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:1b get 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, /commands with 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-data and mineflayer-pathfinder, so new Minecraft versions usually work without a new MCBP build. Leave the version on Auto and 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 .js files into custom/scripts and restyle the whole app with custom/theme.css.

Built-in Scripts

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

Plain Commands

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.

Installation

Prebuilt releases

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.AppImage or 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.

Running from source

  1. Install Node.js (v20+ recommended) and install dependencies:
    npm install
    npm start
  2. 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
    On Linux npm run make builds all the Linux packages plus the Windows installer. rpm needs rpmbuild and pacman needs bsdtar; 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.

Writing your own scripts

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 };

Script API

  • bot: Active Mineflayer bot instance (bot.pathfinder is preloaded on spawn).
  • log(text): Logs a timestamped message to the Console Logs panel. Prefixing with ModuleName: message formats ModuleName as a colored badge.
  • clearLog(matchText): Removes existing log rows containing matchText so 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): Runs fn() every intervalMs while the script remains toggled on and resolves once toggled off.
  • libs: Runtime libraries { goals, Movements, Vec3, mcData } (6th argument), so scripts don't need to require Mineflayer packages.
  • Option types: checkbox, input (optional placeholder), and select with choices: ["a", "b"] or [{ value, label }].

Scripts get full Node.js access, so only run ones you wrote or trust.

Custom theme

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;
}

Privacy

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.

License

GPL-3.0. Found a bug? Open an issue.