#minecraft #parse #codec #api #networking #parser #data-encoding

golden_apple

A Rust library for decoding and sharing Minecraft data types

25 releases (breaking)

0.20.0 Nov 9, 2024
0.18.0 Aug 13, 2024
0.17.1 Aug 29, 2022
0.16.0 Sep 21, 2021
0.9.0 Jul 24, 2021

#350 in Encoding

Download history 96/week @ 2024-08-05 297/week @ 2024-08-12 31/week @ 2024-09-16 50/week @ 2024-09-23 11/week @ 2024-09-30 1/week @ 2024-10-14 96/week @ 2024-11-04 18/week @ 2024-11-11 7/week @ 2024-11-18

121 downloads per month
Used in ussr-nbt

MIT license

280KB
3K SLoC

Overview

golden_apple is a library for decoding, encoding, and using common types found in Minecraft: Java Edition.

Goals

  • Provide a generalized format for sharing and using Minecraft's data types
  • Simplify the decoding and encoding of network data
  • Abstract away enums usually passed as numbers

Usage

Parsing NBT

let mut nbt_file_reader = std::fs::File::open("test.nbt")
    .expect("Unable to open file!");

match golden_apple::nbt::from_reader(&mut nbt_file_reader) {
    Ok(named_tag) => {
        println!("NBT Data: {:#?}", named_tag);
    }
    Err(e) => {
        panic!("Unable to parse NBT! ({:?})", e);
    }
}

Other

Proprietary Minecraft types like VarInt, VarLong, and Position are a part of the top level crate. Types that can be fully represented in Rust have encoders/decoders under golden_apple::generalized for reading and writing from both byte arrays and Rust's Read/Write traits. Communicating with existing servers and clients can be done using the packet format and tools found in the netty module.

Status

This crate is unfinished and some features aren't yet present. Here's an overview of what's still in progress:

  • Metadata
  • Slot
  • Netty (13.1%)
  • Other General Enums (~50%)

Cargo Features

There is one Cargo feature flag for this crate, encryption. It is not complete at this time and currently does nothing. Eventually, this will enable methods for handling packets when encryption is enabled between the server and client.

Version Support

Changelog

Crate version Minecraft version Minecraft Protocol ID
0.20.0 1.21.2 - 1.21.3 768
0.18.0 - 0.19.0 1.21.0 - 1.21.1 767
0.17.0 - 0.17.2 1.19.2 762

Dependencies

~5–15MB
~201K SLoC