MinecraftBotClient MBC Minecraft Client Official website address

• Github
• Discord
• QQ
• Official Website
• Our Minecraft Servers
• Search Official Support Documentation
• View all versions

Minecraft Bot Client (MBC)

---

MBC (Minecraft Bot Client) is a pure-protocol Minecraft bot client written in Python. No game assets required — it connects to servers, sends chat messages, and runs commands directly. Features include a bilingual UI, SRV record resolution, vanilla-style command autocomplete, auto-spam, session logging, and more.

Features

• 🔌 All versions supported — Auto-detects the server protocol; any Minecraft version between 1.8 and 26.2
• 🌐 SRV records — Auto-resolves _minecraft._tcp.<domain> SRV records, no need to specify port
• 🗣️ Bilingual UI — Chinese / English, picked automatically from the exe suffix (-zh / -en)
• ⌨️ Vanilla-style autocomplete — Type . or / for a grey inline preview, Tab to complete, ↑/↓ or mouse wheel to cycle, Esc to clear
• 💬 Chat & server commands — Plain text for chat, / prefix for server commands
• 🎛️ . client commands — .help .esc .connect .respawn .log .walk .eat .spam .config .exit (legacy // prefix still works)
• 🤖 Human-like actions — Head turns and arm swings with random delays and Bézier trajectories, mimicking a real mouse to bypass common anti-cheat checks
• 🤖 Multi-bot mode — Launch any number of bots from the config (20, 100, ...) with random usernames, staggered joins and automatic /register or /login after joining
• 🚶 Random auto-walk — Random roaming or custom waypoints; stops automatically on damage/death
• 🍖 Auto-eat on damage — Attempts to eat when health drops below a threshold, toggleable
• 🔔 Proximity & path alerts — Announces nearby players and missing blocks ahead; invisible to other players
• 📨 Auto-spam — Configurable rate and message list, persisted in config
• 📝 Session logging — Auto-creates timestamped .log files in the log/ folder when enabled
• 🔔 Remote version check & announcements — Shows remote txt content 1:1 on startup; skip with fast_start
• ⚡ Fast start — Enable fast_start in config to skip network checks and reduce resource usage
• 🌙 Offline mode — Designed for online-mode=false (cracked/offline) servers
• 💻 Cross-platform — Windows / macOS / Linux native builds. Autocomplete, history and mouse-wheel input work on both the Windows console API and POSIX terminals. Each platform is built on its own OS with python build.py

Quick Start

Use releases (recommended)

Download the package for your platform from the releases/ directory — windows/en.zip, macos/en.zip or linux/en.zip — and extract it anywhere. Keep config.en.json next to the client binary.

• Windows: double-click MinecraftBotClient-en.exe
• macOS / Linux: chmod +x MinecraftBotClient-en once, then ./MinecraftBotClient-en

On macOS an unsigned binary may be blocked by Gatekeeper. Right-click the binary and choose Open, or run xattr -d com.apple.quarantine MinecraftBotClient-en before launching.

Run from source

pip install -r requirements.txt
python main.py

Windows, macOS and Linux all work with Python 3.8 or newer.

Build

python build.py

PyInstaller cannot cross-compile, so run the script once on each operating system you want to ship. Artifacts go into releases/<version>/<platform>/ — windows, macos and linux — each holding zh/ and en/ folders (binary + config + README) plus zh.zip and en.zip packages. macOS builds target the architecture of the Python running the script, so use a universal2 or Intel Python if you need to cover older Macs.

Configuration

{
  "version": "2.1.0",
  "username": "",
  "server_address": "localhost:25565",
  "minecraft_version": "1.8.9",
  "language": "en",
  "fast_start": false,
  "log_enabled": false,
  "spam_enabled": false,
  "spam_rate": 1.0,
  "spam_messages": ["Hello!", "Anyone there?", "GG"],
  "command_autocomplete": true,
  "auto_eat": true,
  "auto_eat_health_threshold": 10,
  "auto_walk": false,
  "auto_walk_waypoints": [],
  "stop_walk_on_damage": true,
  "proximity_alerts": true,
  "proximity_distance": 5.0,
  "human_actions": true,
  "human_action_interval_min": 2.0,
  "human_action_interval_max": 7.0,
  "multi_bot_enabled": false,
  "bot_count": 10,
  "bot_name_prefix": "Bot",
  "bot_name_digits": 4,
  "bot_join_delay": 0.5,
  "bot_auth_enabled": false,
  "bot_auth_mode": "register",
  "bot_auth_password": "",
  "bot_auth_delay": 1.5,
  "bot_auth_register_command": "/register {password} {password}",
  "bot_auth_login_command": "/login {password}"
}

Field	Description
username	Player name, leave empty for a random one
server_address	Server address, SRV domains supported (e.g. mc.example.com) or explicit port (e.g. mc.example.com:25565)
minecraft_version	Server version, any value between 1.8 and 26.2
language	UI language: zh / en
fast_start	Skip version/announcement checks on startup
command_autocomplete	Toggle command autocomplete
auto_eat / auto_eat_health_threshold	Auto-eat on damage toggle and health threshold
auto_walk / auto_walk_waypoints	Auto-walk toggle and custom waypoints (relative coordinates)
stop_walk_on_damage	Stop walking automatically on damage/death
proximity_alerts / proximity_distance	Nearby player alerts toggle and distance
human_actions / human_action_interval_min/max	Human-like actions toggle and interval seconds
log_enabled	Enable logging by default (toggle at runtime with .log on)
spam_enabled / spam_rate / spam_messages	Auto-spam toggle, rate and message templates
multi_bot_enabled / bot_count	Multi-bot mode and how many bots to launch (e.g. 20, 100)
bot_name_prefix / bot_name_digits	Random username prefix and the number of random digits appended
bot_join_delay	Seconds between bot connections
bot_auth_enabled / bot_auth_mode	Auto-login toggle and mode: register, login or both
bot_auth_password	Password used in the auth commands
bot_auth_delay	Seconds to wait after a bot joins before sending the auth command
bot_auth_register_command / bot_auth_login_command	Command templates; {password} is replaced with bot_auth_password

Commands

Client commands (. prefix, not sent to the server; legacy // still works)

Command	Description
.help	Show all commands and open the help website
.esc	Leave the server but keep the client open (standby mode)
.connect	Reconnect in standby mode
.exit	Disconnect and close the client
.respawn	Send a respawn packet after dying
.log on/off	Toggle logging (written to the log/ folder with timestamps)
.spam on/off	Toggle auto-spam
.spam rate <n>	Set messages per second
.spam add <msg> / .spam remove <i> / .spam list / .spam clear / .spam status	Spam message management
.walk start/stop	Start/stop random auto-walk
.walk add <x,y,z>	Add a custom waypoint (relative coordinates, comma separated)
.walk list / .walk clear	List/clear waypoints
.eat on/off	Toggle auto-eat on damage
.config <key> [val]	View or modify any config key (ex: .config fast_start true)

Multi-bot commands (available while multi_bot_enabled is on)

Command	Description
.status	Show how many bots are connected
.say <text>	Broadcast a chat message from every connected bot
.exit	Disconnect all bots and quit

Vanilla-style Autocomplete

• Type . or / to see a grey inline preview of the command
• Tab accepts the preview; press Tab repeatedly to cycle suggestions
• ↑ / ↓ arrow keys or the mouse wheel cycle suggestions
• Enter sends, Esc clears the input, ↑ also browses command history

Server commands (/ prefix, sent to server)

Type /list, /msg player hello, /tp ... etc., same as in-game.

Plain text

Sent as a chat message directly.

Multi-bot mode

Set multi_bot_enabled to true and pick a bot_count (for example 20 or 100). The client then:

1. Probes the server protocol once and reuses it for every bot
2. Generates unique random usernames from bot_name_prefix + bot_name_digits (e.g. Bot4821)
3. Connects the bots one by one with bot_join_delay seconds between joins
4. When bot_auth_enabled is on, each bot waits bot_auth_delay seconds after joining and then sends the configured /register and/or /login command with bot_auth_password — the command templates are fully editable so it works with AuthMe or any other login plugin

The console switches to swarm control: .status, .say <text> and .exit. Every bot keeps its own connection, keepalive handling and disconnect state, and bots that fail to connect are reported and skipped.

Use this only on servers you own or are allowed to test — mass-joining public servers usually violates their rules.

Remote Version & Announcements

On startup the client fetches and displays the txt content 1:1:

• Version check: https://shit.pub/s/developer/minecraft/client/MinecraftBotClient-MBC/verify/txt.txt
• Announcements: https://shit.pub/s/developer/minecraft/client/MinecraftBotClient-MBC/announcement.txt

Enable fast_start to skip these checks.

Version Folder Structure

Each build is placed in its own folder under releases/<version>/<platform>/:

releases/
└── 2.1.0/
    ├── windows/
    │   ├── zh/  MinecraftBotClient-zh.exe  config.zh.json  README.zh.md
    │   ├── en/  MinecraftBotClient-en.exe  config.en.json  README.en.md
    │   ├── zh.zip
    │   └── en.zip
    ├── macos/
    │   ├── zh/  MinecraftBotClient-zh  config.zh.json  README.zh.md
    │   ├── en/  MinecraftBotClient-en  config.en.json  README.en.md
    │   ├── zh.zip
    │   └── en.zip
    └── linux/
        └── ...

Releases 1.3.1 and older keep the original Windows-only layout without a platform folder.

Project Structure

MinecraftBotClient/
├── main.py                      # Entry point (POSIX console setup + signal handling)
├── build.py                     # Per-platform build script (versioned output, bilingual)
├── requirements.txt             # Python dependencies
├── README.md                    # This file
├── src/
│   ├── i18n.py                  # Bilingual dictionary + t() translation function
│   ├── logger.py                # SessionLogger for per-session log files
│   ├── client/
│   │   └── minecraft_bot_client.py  # Main client logic (connect/chat/commands/walk/alerts)
│   ├── network/
│   │   ├── connection_manager.py    # Minecraft protocol (handshake/login/chat/keepalive/SRV/human actions)
│   │   └── version_checker.py       # Remote version check + announcements
│   ├── features/
│   │   └── spam.py                  # Auto-spam manager
│   ├── settings/
│   │   └── settings_manager.py      # Config read/write + persistence
│   └── ui/
│       └── console_ui.py            # Console UI (ANSI colors, autocomplete, mouse wheel; Windows console API + POSIX terminal)
└── releases/                    # Build artifacts (versioned)

Protocol Support

Range	Examples	Protocol ID
1.8	1.8, 1.8.9	47
1.9 - 1.12	1.9, 1.10.2, 1.11, 1.12.2	47 - 340
1.13 - 1.16	1.13.2, 1.14.4, 1.15.2, 1.16.5	340 - 754
1.17 - 1.18	1.17, 1.18.2	755 - 758
1.19	1.19, 1.19.2, 1.19.4	759 - 760
1.20	1.20 - 1.20.6	763 - 766
1.21	1.21 - 1.21.8	767 - 773
25.x - 26.x	25.1 - 26.2	774 - 777

Any unlisted version within a range is auto-mapped to the nearest known protocol ID; the actual server protocol is probed before login.

Dependencies

Library	Purpose
requests	HTTP requests (version check, announcements)
cryptography	AES/RSA encryption (online-mode login flow, not triggered in offline mode)
dnspython	SRV record resolution
pyinstaller	Packaging into exe

Notes

• This client runs in offline mode. Use it on servers with online-mode=false
• Please note that the official account mode is still under development; please be patient or subscribe to our GitHub repository
• Help website: https://shit.pub/s/developer/minecraft/client/MinecraftBotClient-MBC/MBC/
• For testing and development purposes only

©copyright

MBC is released under the GNU General Public License v3.0.

1. LICENSE View the address on GitHub.
2. LICENSE Check p.shit.pub for the address.