Skip to content
BasaltProjectPublic

About

A Minecraft proxy written from scratch in C++

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Basalt Basalt

Basalt Proxy

A Minecraft proxy for Java and Bedrock, written from scratch in C++. No JVM required.

Java Edition Bedrock Edition C++ Platforms License

About

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.

Getting started

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.

Building

git clone --recurse-submodules https://github.com/BasaltProject/Proxy.git
cd Proxy
cmake --preset release
cmake --build build/release

Needs CMake 3.28+, Ninja and Clang. The binary ends up in build/release/bin/.

Contributing

Read the contribution guide and the Code of Conduct. Report vulnerabilities privately through the security policy.

License

GPL-3.0. Basalt is not affiliated with Mojang Studios or Microsoft. Minecraft is a trademark of Mojang Studios.

About

A Minecraft proxy written from scratch in C++

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages