#minecraft #assets #gamedev #resource-pack

minecraft-assets

Parsing Minecraft asset files and resource packs in Rust

5 releases

0.0.6 Feb 18, 2022
0.0.5 Feb 9, 2022
0.0.4 Jan 31, 2022

#1587 in Game dev

21 downloads per month

MIT/Apache

96KB
1K SLoC

minecraft-assets

Crates.io Docs.rs Tests

A Rust library for reading asset files and resource packs for any version of Minecraft.

Example

use minecraft_assets::api::AssetPack;

let assets = AssetPack::at_path("~/.minecraft/");

// Load the block states for `oak_planks`
let states = assets.load_blockstates("oak_planks").unwrap();
let variants = states.variants().unwrap();

assert_eq!(variants.len(), 1);

let model_properties = &variants[""].models()[0];
assert_eq!(model_properties.model, "block/oak_planks");

Documentation

This library is #![warn(missing_docs)], so the documentation is very complete:

Feature checklist

Assets parsing

  • assets/<namespace>/blockstates/*.json
  • assets/<namespace>/font/*.json
  • assets/<namespace>/lang/*.json
  • assets/<namespace>/models/block/*.json
  • assets/<namespace>/models/item/*.json
  • assets/<namespace>/particles/*.json
  • assets/<namespace>/shaders/{post,program}/*.json
  • assets/<namespace>/textures/*.mcmeta
  • assets/<namespace>/sounds.json
  • assets/pack.mcmeta

Data parsing

  • data/<namespace>/advancements/**/*.json
  • data/<namespace>/loot_tables/**/*.json
  • data/<namespace>/recipes/*.json
  • data/<namespace>/structures/**/*.json
  • data/<namespace>/tags/**/*.json

Projects using minecraft-assets

  • Brine: A multi-version Minecraft client written using Bevy.
  • Maybe your project here! :)

Tests

Integration tests in 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 script:

$ ./tests/setup.sh

This script will fetch the minecraft-assets repository and check out a few different versions at various paths in tests/. Then you can run the tests by enabling the tests feature:

$ cargo test --features tests

License

Licensed under either of

at your option.

Copyright Ben Reeves 2022

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.7–1.6MB
~35K SLoC