finds.dev

ImWuMie/mc-proto-bot

Async Python Minecraft protocol client featuring online/offline authentication, vanilla physics, A* ground and flight navigation, inventory automation, hot-reloadable plugins, auto- reconnect, and optional in-game LLM tool calling.

View on GitHub

★ 5PythonMITupdated Oct 2026

// the take

A from-scratch async Python Minecraft protocol client implementing handshake through play state, with client-side physics, A* pathfinding, and a plugin system that includes an LLM-driven in-game agent. Aimed at people building bots/agents for Minecraft servers who want direct protocol control rather than wrapping a Java library.

Genuinely implements the protocol stack itself (encryption, SRV lookups, mod loader handshakes) rather than shelling out to another library, and the physics/navigation code (A*, VClip, flight path compression) shows real attention to matching vanilla behavior tick-for-tick. The plugin system with hot-reload, dependency ordering, and exception isolation is more thought-out than most hobby bot frameworks. The LLM agent integration goes well beyond a chat wrapper, with tool-based inventory/navigation control, scheduled tasks, and memory files.

Only 5 stars and 2 forks with one dominant contributor, so bus factor is essentially zero and there's no evidence of production use outside the author's own server. Supports a narrow set of pinned Minecraft versions with bundled block-state tables, meaning every new vanilla release requires a manual update. The anti-kick/packet-spoofing features (fake on-ground bit, Y-position jitter to dodge idle-kick) are explicitly working around anti-cheat/server rules, which is a liability on any server with actual moderation. The LLM agent plugin has a sprawling surface area (writes and reloads its own plugin code, manages QQ bridge, admin tooling) that is a lot of attack surface for a project this early and this thinly staffed.

We read the README, the directory tree and a key source file in November 2026. Nobody pays to be listed. How we judge →

search the same ground:

// at a glance

Stars
5
Forks
2
Language
Python
License
MIT
Last commit
2 Oct 2026

// nearby

If mc-proto-bot isn't quite it.

All repos →