#nintendo #zelda #parser #modding #version

nightly byml

Nintendo BYML (binary YAML) library in Rust

5 releases

0.1.4 Nov 13, 2020
0.1.3 Nov 13, 2020
0.1.2 Nov 11, 2020
0.1.1 Nov 10, 2020
0.1.0 Jul 1, 2020

#2849 in Parser implementations

MIT license

4MB
4K SLoC

Nintendo BYML (binary YAML) library in Rust

crates.io api license

A simple to use library for reading, writing, and converting Nintendo binary YAML (BYML) files in Rust. Supports BYML versions 2-4, (v2 used in The Legend of Zelda: Breath of the Wild). Can convert from BYML to readable, editable YAML and back.

Sample usage:

// First grab the file bytes. Yaz0 compressed files are automatically decompressed.
let bytes: Vec<u8> = std::fs::read("ActorInfo.product.byml").unwrap();
// Parse the data as a Byml document
let actor_info: Byml = Byml::from_binary(&bytes).unwrap();
// Index BYML hashes and arrays naturally
let actor_list: &Vec<Byml> = actor_info["Actors"].as_array().unwrap();
// 7934 actors, egads!
assert_eq!(actor_list.len(), 7934);
// Hmm, we'll iterate the actors listed in this file:
for actor in actor_list.iter() {
    // Print each actor's name
    println!("{}", actor["name"].as_string().unwrap());
}
// Dump to YAML
std::fs::write("ActorInfo.product.yml", actor_info.to_text().unwrap()).unwrap();

License Notice

This software contains heavily edited code from yaml-rust, mostly to simplify parsing and emitting BYML text representation. The original MIT/Apache license and code are available on the GitHub repo.

Dependencies

~5MB
~96K SLoC