wz_reader

Crates.iowz_reader
lib.rswz_reader
version0.0.11
sourcesrc
created_at2024-04-23 10:32:01.972613
updated_at2024-09-10 11:04:53.704888
descriptionA wz file reader to resolve wz file with thread safe
homepagehttps://github.com/spd789562/wz-reader-rs
repositoryhttps://github.com/spd789562/wz-reader-rs
max_upload_size
id1217385
size387,064
Leo Lin (spd789562)

documentation

https://docs.rs/wz_reader

README

wz-reader-rs

Maplestory *.Wz file reading written in rust, try port similer code from WzComparerR2.WzLib and MapleLib

It a rust learning project, performance maybe not as good as C#.

Dependencies

  • Image
    • flate2
    • image
  • Char Decryption
    • aes
    • ecb
  • Data
    • hashbrown - Hashmap
    • memmap2
  • Others
    • rayon
    • scroll
    • thiserror

Minimum supported Rust version

wz_reader's MSRV is 1.70.0

Example

use wz_reader::util::{resolve_base, walk_node};
// NodeCast trait provide try_as_* functions to casting WzNode
use wz_reader::NodeCast;

fn main() {
    // resolve wz files
    let base_node = resolve_base(r"D:\MapleStory\Data\Base.wz", None).unwrap();

    // try to parsing every nodes on the way
    walk_node(&base_node, true, &|node| {
        let node_read = node.read().unwrap();

        if let Some(sound_node) = node_read.try_as_sound() {
            let path = std::path::Path::new("./sounds").join(node_read.name.as_str());
            if sound_node.save(path).is_err() {
                println!("failed to extract sound: {}", node_read.get_full_path());
            }
        }
    });
}

You can find more example usage in the examples folder.

License

This project is licensed under the MIT license.

Commit count: 175

cargo fmt