finds.dev

py-mine/mcproto

Library providing easy low level interactions with minecraft protocol

View on GitHubHomepage ↗

★ 57PythonLGPL-3.0updated Oct 2026

// the take

A low-level Python library for talking the Minecraft protocol directly: packet encoding/decoding, handshake/login/status flows, auth (Microsoft/Yggdrasil), and encryption, meant as a building block for bots or server implementations rather than a finished client.

Clean separation between protocol-level IO, packet types, and auth concerns; type-annotated codebase with strict linting (ruff with ALL rules, basedpyright) and real unit test coverage per packet type; async-first design with asyncio-dgram support; handles the gnarly parts people usually get wrong themselves (NBT parsing, VarInt/VarLong, encryption handshake, Microsoft OAuth/Xbox auth chain).

README explicitly says it's pre-alpha and not production ready, and the packet coverage is thin - only handshaking/login/status packets exist, no play-state packets, so you can't actually build a working bot or server yet; only 57 stars and a single primary maintainer, so bus-factor risk is real; no higher-level abstractions (world state, entity tracking) meaning anyone adopting it still has a lot of protocol implementation work ahead; LGPL licensing may be a friction point for some commercial users.

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

search the same ground:

// at a glance

Stars
57
Forks
5
Language
Python
License
LGPL-3.0
Last commit
25 Oct 2026

// nearby

If mcproto isn't quite it.

All repos →