oead is a C++ library for common file formats that are used in modern first-party Nintendo EAD (now EPD) titles.
Currently, oead only handles very common formats that are extensively used in recent games such as Breath of the Wild and Super Mario Odyssey.
- AAMP (binary parameter archive): Only version 2 is supported.
- BYML (binary YAML): Versions 2, 3, and 4 are supported (up to v7 in roead).
- SARC (archive)
- Yaz0 (compression algorithm)
The roead project brings oead's core functionality, by directly porting or (for the yaz0 module) providing safe and idiomatic bindings to oead's features. (The Grezzo datasheets are not supported.) For more info on oead itself, visit its GitHub repo.
Each of roead's major modules is configurable as a feature. The default feature
set includes byml, aamp, sarc, and yaz0. For compatibility with many
existing tools for these formats, there is also a yaml feature which enables
serializing/deserializing AAMP and BYML files as YAML documents. Finally, serde
support is available using the with-serde feature.
For API documentation, see the docs for each module.
Most of roead is pure Rust and can compiled with any relatively recent release. The stable MSRV is 1.69. However, the yaz0 module provides FFI bindings to oead code, so to use it the following additional requirements are necessary:
- CMake 3.12+
- A compiler that supports C++17
- Everything necessary to build zlib
First, clone the repository, then enter the roead directory and run
git submodule update --init --recursive.
Issue tracker: https://github.com/NiceneNerd/roead/issues
Source code: https://github.com/NiceneNerd/roead
This project is licensed under the GPLv3+ license. oead is licensed under the GPLv2+ license.