PyBedrock Net

PyBedrock Net is a Python networking toolkit for building Minecraft Bedrock Edition clients, bots, server tools, and protocol experiments. It is created and maintained by ZENKAI with a focus on a clean API, simple scripts, and protocol code that can grow without becoming difficult to use.

The project is organized around the complete Bedrock client journey:

• Client and sessions — simple client configuration, connection lifecycle, and reusable sessions.
• RakNet and transport — UDP transport, connection handling, reliability, fragmentation, compression, and packet flow.
• Protocol and packets — codecs, VarInts, readers, writers, registries, version resolution, handshakes, login, gameplay, movement, chat, commands, inventory, player, and world packets.
• Authentication — offline mode plus the foundations for Microsoft/Xbox account sessions and token management.
• World data — chunks, subchunks, palettes, blocks, cache, and world state.
• Entities and players — entity models, metadata, tracking, and player state.
• Bots and automation — movement, navigation, actions, and controllers.
• Events and discovery — event dispatching, server ping, and protocol detection.

The package is intentionally built in tested layers: low-level binary primitives first, then transport and protocol packets, then high-level client and bot APIs. This makes it useful for both a quick server script and a larger Bedrock automation project.

Install

pip install pybedrock-net

The package is published on PyPI at https://pypi.org/project/pybedrock-net/.

To create a signed login payload:

from pybedrock_net.auth import LoginChainBuilder

login = LoginChainBuilder().build(
    server_address="play.example.com:19132",
    display_name="PyBot",
)
session.begin_login(2169, login.payload())

Offline bot

For an offline-mode server, the username is selected locally and no Microsoft account is used:

from pybedrock_net.bot import BedrockBot

bot = BedrockBot("127.0.0.1", 19132, "AnyName")
bot.login(protocol=685)
bot.chat("hello")
bot.command("/say hello")

Telegram controller

The package includes a dependency-free Telegram long-polling controller:

export TELEGRAM_BOT_TOKEN="set-this-as-a-Replit-Secret"
# Optional: restrict access to comma-separated Telegram chat IDs.
export TELEGRAM_ALLOWED_CHAT_IDS="123456789"
bedrock-telegram

Send /server HOST PORT USERNAME in Telegram, then use the interactive buttons to connect, check status, send chat, send commands, or disconnect.

Command line

bedrock-ping play.example.com
bedrock-ping play.example.com --port 19132 --timeout 5

Python

from pybedrock_net import BedrockClient

client = BedrockClient("play.example.com", 19132)
status = client.ping()
print(status.description, status.players_online, "/", status.players_max)

Discovery ping is available through client.ping(), but connection setup skips it by default because some proxies and firewalls block unconnected RakNet pings. To require discovery before the RakNet handshake:

client = BedrockClient("play.example.com", skip_ping=False)
session = client.connect()

The current release provides a real RakNet unconnected ping/pong flow, a reusable UDP transport, binary codecs, server status parsing, connected RakNet batch send/receive, Microsoft/Xbox device-code authentication, and client/bot session foundations. A signed login-chain payload is intentionally passed into ClientSession.begin_login() so applications can choose their identity provider without the library fabricating credentials.

Author

ZENKAI

• TikTok: https://www.tiktok.com/@s_xwn?_r=1&_t=ZS-994W6rldVjQ
• YouTube: https://www.youtube.com/@szewq
• Telegram: https://t.me/s_xwn

Development

python -m pytest
python -m build

For local development, install the optional tooling with:

pip install -e ".[dev]"

MIT licensed.