pybedrock-net ⛏️🚀

The 100% Pure Python, Non-Native Engine for Minecraft Bedrock (MCPE) & RakNet Networking.
Developed and maintained by zenkai.

⚡ Why pybedrock-net?

If you have ever attempted to build or run a Minecraft Bedrock bot in Docker, Linux containers, or cloud servers, you likely encountered the infamous compilation nightmare:

Error: Could not locate the bindings file. Tried: .../node-raknet.node
ERR! C++ Compiler toolset is not available.

pybedrock-net solves this completely. It is built from the ground up using pure asynchronous Python UDP networking, meaning:

• Zero C++ Compilers Required: No gcc, no cmake, no native binary bindings that crash across different Node or Python ABI versions.
• Runs Everywhere: Works on Linux, Windows, macOS, Docker, Cloud Run, Raspberry Pi, and Android Termux out of the box.
• Production-Tested In-World Protocol: Handles the entire Bedrock connection lifecycle—RakNet MTU negotiation, login tokens, multi-phase resource pack verification, game spawn, real-time coordinate tracking, and automated keepalive.

🚀 Installation

Install the latest release from PyPI:

pip install pybedrock-net

Or install directly from the source repository:

git clone https://github.com/zenkai/pybedrock-net.git
cd pybedrock-net
pip install -e .

💻 CLI Usage (pybedrock-bot)

pybedrock-net comes bundled with a full-featured terminal CLI client:

# Ping a Bedrock server
pybedrock-bot --ping --host play.example.com --port 19132

# Connect a bot to a server with Anti-AFK enabled
pybedrock-bot --host play.example.com --port 19132 --username ZENKAI_Bot --anti-afk

CLI Arguments

🐍 Python API Examples

1. Ping and Query Server Status

import asyncio
from pybedrock_net import BedrockServerPing

async def main():
    info = await BedrockServerPing.query("play.example.com", port=19132, timeout=3.0)
    if info.online:
        print(f"MOTD: {info.motd}")
        print(f"Version: {info.version} (Protocol {info.protocol})")
        print(f"Players: {info.players_online}/{info.players_max}")
        print(f"Latency: {info.latency}ms")
    else:
        print("Server is offline or unreachable.")

asyncio.run(main())

2. Spawning a Bot into the World

import asyncio
from pybedrock_net import BedrockClient

async def main():
    bot = BedrockClient(
        host="play.example.com",
        port=19132,
        username="ZENKAI_Agent",
        anti_afk=True
    )

    @bot.on("connect")
    async def on_connect():
        print("Connected to RakNet UDP layer!")

    @bot.on("login")
    async def on_login():
        print("Authentication succeeded! Negotiating resource packs...")

    @bot.on("spawn")
    async def on_spawn(data):
        print(f"Bot spawned into the world! Dimension: {data.dimension}")
        print(f"Position: X={data.position.x}, Y={data.position.y}, Z={data.position.z}")
        # Send a greeting into the server chat
        await bot.send_chat("Hello everyone! Powered by pybedrock-net.")

    @bot.on("chat")
    async def on_chat(sender, message):
        print(f"[{sender}] {message}")
        if message == "!ping":
            await bot.send_chat("Pong!")

    await bot.start()

asyncio.run(main())

🏛️ Architecture & Protocol Stack

┌───────────────────────────────────���──────────┐
│           High-Level Bot API                 │
│      (Events, Chat, Actions, Anti-AFK)       │
├──────────────────────────────────────────────┤
│         Bedrock Protocol Layer (v1.20+)      │
│  (Login, Packs, StartGame, TickSync, Latency)│
├──────────────────────────────────────────────┤
│           Pure Python RakNet Engine          │
│    (MTU Discovery, Encapsulation, ACK/NACK)  │
├──────────────────────────────────────────────┤
│           Asyncio Datagram Socket (UDP)      │
└──────────────────────────────────────────────┘

📦 Publishing to PyPI

To build and publish new distributions to PyPI:

# 1. Install build dependencies
python -m pip install --upgrade build twine

# 2. Build distribution archives
python -m build

# 3. Upload to PyPI
twine upload dist/*

📄 License

Distributed under the MIT License. See LICENSE for details.

Developed with precision by zenkai.