A Minecraft proxy for Java and Bedrock, written from scratch in C++. No JVM required.
Basalt Proxy sits in front of your Minecraft servers, gives players a single address and moves them between servers. Java Edition and Bedrock Edition players connect to the same proxy, and it works with whatever is behind it: vanilla, Paper, Spigot, Fabric or Basalt Server.
| Edition | Version | Connection |
|---|---|---|
| Java Edition | 26.3 (older clients from 1.21.5 are translated) | Native |
| Bedrock Edition | 26.60 | Native, bridged to Java servers |
- Native and light. One binary and a
config/folder. No JVM to install. - Built-in protection. Antibot, secure forwarding to backends, rate limits and a remote administration API.
- Lua plugins. The native API, sandboxed and packaged as
.bppkg. - BungeeCord and Velocity plugins (early). Optional adapters on top of Shim, a JVM built into the binary that only starts when a jar is present.
Download a binary from the releases page (stable builds and a
rolling Nightly), run it once to generate config/, add your servers to servers.toml and start it again.
Configuration, forwarding, plugins and everything else are in the documentation.
git clone --recurse-submodules https://github.com/BasaltProject/Proxy.git
cd Proxy
cmake --preset release
cmake --build build/releaseNeeds CMake 3.28+, Ninja and Clang. The binary ends up in build/release/bin/.
Read the contribution guide and the Code of Conduct. Report vulnerabilities privately through the security policy.
GPL-3.0. Basalt is not affiliated with Mojang Studios or Microsoft. Minecraft is a trademark of Mojang Studios.