Bifrost

A high-performance Minecraft: Bedrock Edition proxy written in Zig, built for fast networking, low overhead, and extensibility.

Bifrost uses NetherNet and Bedwire to handle Bedrock connections over WebRTC.

Features

• Xbox-verified logins - Checks every login against Microsoft's keys and logs in to trusting backends on the player's behalf.
• Routing - Join pools, fallbacks, capacity limits and draining, with health checks.
• Seamless transfers - Switch servers without reconnecting.
• Native plugins - Zig, C, or C++23 with a thin header-only wrapper.
• Operations - Console commands, Prometheus metrics and categorized logs.

Building

Requires Zig 0.17.0, Git, CMake, and a C/C++ toolchain. (Depending on your usecase)

git clone https://github.com/Bedrock-Phanatics/Bifrost.git
cd Bifrost

# Linux
sh tools/setup-native.sh

# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -File tools/setup-native.ps1

zig build -Doptimize=ReleaseSafe

Running

./zig-out/bin/bifrost

Configure Bifrost in config/bifrost.toml.

Linux x86_64 builds are on the releases page. They need glibc 2.35 or newer (Debian 12, Ubuntu 22.04). Extract the archive and start it with ./run.sh.

For Pterodactyl hosting, use the Bifrost egg. Set BIFROST_REF to main or a release tag such as v1.0.0.

Documentation

• Setup Guide
• Running Bifrost
• Backend Support
• Plugin Development
• Plugin API
• Configuration & Limits
• Testing
• Known Issues

Development

zig build test
zig build bench -Doptimize=ReleaseFast