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
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)
The current release provides a real RakNet unconnected ping/pong flow, a reusable UDP transport, binary codecs, and server status parsing. Full authenticated login, encrypted Xbox sessions, reliable framed gameplay packets, and world/chunk decoding are being expanded behind tested APIs in upcoming releases rather than being presented as finished prematurely.
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
MIT licensed.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pybedrock_net-0.3.1.tar.gz.
File metadata
- Download URL: pybedrock_net-0.3.1.tar.gz
- Upload date:
- Size: 22.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
afd90bf3bee54a0aaf9f598d7dcb0b36ea478e7bbbf6c220c8e2921d51184997
|
|
| MD5 |
483f70885001cd58b71e4cd789e2793c
|
|
| BLAKE2b-256 |
1db903b65eb29b101f3afee8fdc2c61946c3f73a3bf6514dfd7f3ae771de3589
|
File details
Details for the file pybedrock_net-0.3.1-py3-none-any.whl.
File metadata
- Download URL: pybedrock_net-0.3.1-py3-none-any.whl
- Upload date:
- Size: 37.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f837061f652ed365bf523157428332482b62eaab0a7686f104ab096b6355d35d
|
|
| MD5 |
77006e2e1741c01a6bf77bc82890a39c
|
|
| BLAKE2b-256 |
dc2f07fc02d9e804ece2ec839c1bd571cbac926d287d75bf77f0f1472e9842ea
|
