The Minecraft network layer shared by Basalt Server and Basalt Proxy, in C++.
Wire is everything Basalt needs to speak Minecraft over a socket, and nothing else: packet framing and codecs, NBT, the component model, the encrypted login handshake, and translation for older Java clients and for Bedrock.
It is not a standalone program. Server and Proxy both consume it as a git submodule, so there is one implementation of the protocol to keep correct.
| Module | What it holds |
|---|---|
wire-common |
Logging, collections, hashing, identifiers. Depends on nothing |
wire-nbt |
NBT and SNBT |
wire-text |
Adventure-style components and their JSON and NBT forms |
wire-io |
Sockets, event loop, buffers, compression |
wire-protocol |
Packet framing and the codecs for every protocol state |
wire-auth |
Encrypted handshake, Mojang sessions, profiles |
wire-multiversion |
Translation for older Java clients |
wire-bedrock |
NetherNet, RakNet, Bedrock sessions and codecs |
wire-lua, wire-plugins |
The sandboxed Lua runtime and plugin packages |
wire-sqlite |
SQLite access, compiled into the binary |
git submodule add https://github.com/BasaltProject/Wire.git wireadd_subdirectory(wire)
target_link_libraries(your-module PUBLIC basalt::wire-protocol)Wire owns the shared CMake functions and the third-party dependencies, so consumers inherit one set of flags and one copy of every dependency.
cmake --preset debug
cmake --build build/debug
ctest --preset debugNeeds CMake 3.28+, Ninja and Clang.
Basalt is not affiliated with Mojang Studios or Microsoft. Minecraft is a trademark of Mojang Studios.