Skip to content
BasaltProjectPublic

About

The Minecraft network layer shared by Basalt Server and Basalt Proxy

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

354 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Basalt Basalt

Basalt Wire

The Minecraft network layer shared by Basalt Server and Basalt Proxy, in C++.

Java Edition Bedrock Edition C++ Platforms License

About

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.

Modules

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

Using it

git submodule add https://github.com/BasaltProject/Wire.git wire
add_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.

Building

cmake --preset debug
cmake --build build/debug
ctest --preset debug

Needs CMake 3.28+, Ninja and Clang.

License

GPL-3.0.

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

About

The Minecraft network layer shared by Basalt Server and Basalt Proxy

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages