MinecraftBotClient MBC Minecraft Client Official website address

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. 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
🚶 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 / Linux / macOS, single-file exe distribution via PyInstaller

Quick Start

Use Releases (recommended)

Download en/MinecraftBotClient-en.exe from the releases/ directory, place it next to en/config.en.json, and double-click the exe.

Run from source

1bash
2pip install -r requirements.txt
3python main.py
4

Build exe

1bash
2python build.py
3

Artifacts go into releases// — Chinese and English builds are separate under zh/ and en/ subdirectories (exe + config + README).

Configuration

1json
2{
3  "version": "1.3.1",
4  "username": "",
5  "server_address": "localhost:25565",
6  "minecraft_version": "1.8.9",
7  "language": "en",
8  "fast_start": false,
9  "log_enabled": false,
10  "spam_enabled": false,
11  "spam_rate": 1.0,
12  "spam_messages": ["Hello!", "Anyone there?", "GG"],
13  "command_autocomplete": true,
14  "auto_eat": true,
15  "auto_eat_health_threshold": 10,
16  "auto_walk": false,
17  "auto_walk_waypoints": [],
18  "stop_walk_on_damage": true,
19  "proximity_alerts": true,
20  "proximity_distance": 5.0,
21  "human_actions": true,
22  "human_action_interval_min": 2.0,
23  "human_action_interval_max": 7.0
24}
25

| 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 | | autoeat / autoeathealththreshold | Auto-eat on damage toggle and health threshold | | autowalk / autowalk_waypoints | Auto-walk toggle and custom waypoints (relative coordinates) | | stopwalkon_damage | Stop walking automatically on damage/death | | proximityalerts / proximitydistance | Nearby player alerts toggle and distance | | humanactions / humanactionintervalmin/max | Human-like actions toggle and interval seconds | | log_enabled | Enable logging by default (toggle at runtime with .log on) | | spamenabled / spamrate / spam_messages | Auto-spam toggle, rate and message templates |

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 | Set messages per second | | .spam add / .spam remove / .spam list / .spam clear / .spam status | Spam message management | | .walk start/stop | Start/stop random auto-walk | | .walk add | Add a custom waypoint (relative coordinates, comma separated) | | .walk list / .walk clear | List/clear waypoints | | .eat on/off | Toggle auto-eat on damage | | .config [val] | View or modify any config key (ex: .config fast_start true) |

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.

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//:

1
2releases/
3├── 1.3.1/
4│   ├── zh/
5│   │   ├── MinecraftBotClient-zh.exe
6│   │   ├── config.zh.json
7│   │   └── README.zh.md
8│   └── en/
9│       ├── MinecraftBotClient-en.exe
10│       ├── config.en.json
11│       └── README.en.md
12└── ...
13

Project Structure

1
2MinecraftBotClient/
3├── main.py                      # Entry point
4├── build.py                     # Build script (versioned output, bilingual)
5├── requirements.txt             # Python dependencies
6├── README.md                    # 中文文档
7├── README.en.md                 # This file
8├── src/
9│   ├── i18n.py                  # Bilingual dictionary + t() translation function
10│   ├── logger.py                # SessionLogger for per-session log files
11│   ├── client/
12│   │   └── minecraft_bot_client.py  # Main client logic (connect/chat/commands/walk/alerts)
13│   ├── network/
14│   │   ├── connection_manager.py    # Minecraft protocol (handshake/login/chat/keepalive/SRV/human actions)
15│   │   └── version_checker.py       # Remote version check + announcements
16│   ├── features/
17│   │   └── spam.py                  # Auto-spam manager
18│   ├── settings/
19│   │   └── settings_manager.py      # Config read/write + persistence
20│   └── ui/
21│       └── console_ui.py            # Console UI (ANSI colors / autocomplete / mouse wheel)
22└── releases/                    # Build artifacts (versioned)
23

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

Help website:

For testing and development purposes only

©copyright

LICENSE View the address on GitHub.

LICENSE Check p.shit.pub for the address.

Creaddinscart.

Creaddinscart

MinecraftBotClient MBC Minecraft Client Official website address

Minecraft Bot Client (MBC)

Features

Quick Start

Use Releases (recommended)

Run from source

Build exe

Configuration

Commands

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

Vanilla-style Autocomplete

Server commands (`/` prefix, sent to server)

Plain text

Remote Version & Announcements

Version Folder Structure

Project Structure

Protocol Support

Dependencies

Notes

©copyright

Creaddinscart

MinecraftBotClient MBC Minecraft Client Official website address

Minecraft Bot Client (MBC)

Features

Quick Start

Use Releases (recommended)

Run from source

Build exe

Configuration

Commands

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

Vanilla-style Autocomplete

Server commands (/ prefix, sent to server)

Plain text

Remote Version & Announcements

Version Folder Structure

Project Structure

Protocol Support

Dependencies

Notes

©copyright

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

Server commands (`/` prefix, sent to server)