protocol

A Minecraft: Bedrock Edition network protocol implementation in V.

Versions

Packets live under versioned modules in src/version/. Each supported protocol version ships its own packet pool - later versions only materialize the packets, types and enums that changed and inherit the rest from earlier modules.

Supported protocols run from 2 (MCPE 0.2.0, 2012) up to 2168 (MC 1.26.40), 100 versions across four wire-format eras plus the modern chain:

Framing differs per era - use protocol.encode_packet_old_to_bytes / pool.decode_old for proto 9-113, protocol.encode_packet_split_to_bytes / pool.decode_split for proto 130-274, and protocol.encode_packet_to_bytes / pool.decode for 280+.

Dependency: nbt

This project consumes the standalone network-NBT codec from bedrock-v/nbt via import nbt. Install it into your V module path before building:

git clone https://github.com/bedrock-v/nbt ~/.vmodules/nbt

Build and Run

v -shared -skip-unused .          # compile the library
v -path 'src|@vlib|@vmodules' run examples/roundtrip.v
v -path 'src|@vlib|@vmodules' run examples/all_versions.v

Usage

import protocol
import protocol.serializer
import protocol.version
import protocol.version.v1001
import protocol.version.v662.packets as packets_662

mut pool := v1001.new_pool()
println('proto=${v1001.proto_version.protocol_id()} mc=${v1001.proto_version.minecraft_version()}')

// encode any packet from the pool's version slice
packet := &packets_662.RequestNetworkSettingsPacket{
	client_network_version: i32(v1001.proto_version.protocol_id())
}
bytes := protocol.encode_packet_to_bytes(packet)

// decode straight from bytes
mut r := serializer.new_reader(bytes)
decoded := pool.decode(mut r)!
if decoded is packets_662.RequestNetworkSettingsPacket {
	println('decoded=${decoded.name()} client_network_version=${decoded.client_network_version}')
}

// pick a pool from a client's protocol id
v := version.from_protocol_id(1001)
println('selected=${v} mc=${v.minecraft_version()}')