# minecraft-assets
[](https://crates.io/crates/minecraft-assets)
[](https://docs.rs/minecraft-assets)
Parsing Minecraft asset files and resource packs in Rust.
This crate provides types that can be used with [`serde_json`] to parse the
data files in the Minecraft `assets/` directory or in a resource pack.
[`serde_json`]: https://lib.rs/crates/serde_json
## Documentation
* [Main Branch (github.io)](https://bgr360.github.io/minecraft-assets-rs/minecraft_assets/)
* [Latest Release (docs.rs)](https://docs.rs/minecraft-assets)
## Tests
Integration tests in [`tests/`](tests/) use the actual asset files from the
[`minecraft-assets`] repository.
That repository is fairly large (~1 GB), so the tests in `tests/` do not run by
default. If you'd like to run them, use the [`tests/setup.sh`](tests/setup.sh)
script:
```
$ ./tests/setup.sh
```
This script will fetch the [`minecraft-assets`] repository and check out a few
different versions at various paths in [`tests/`](tests/). Then you can run the
tests by enabling the `tests` feature:
```
$ cargo test --features tests
```
[`minecraft-assets`]: https://github.com/InventivetalentDev
## License
This project is distributed under the terms of the MIT license.
Copyright Ben Reeves 2022