#wz #file-reader #thread-safe #maplestory #wzlib

wz_reader

A wz file reader to resolve wz file with thread safe

3 releases

new 0.0.5 May 2, 2024
0.0.4 Apr 24, 2024
0.0.3 Apr 23, 2024

#584 in Parser implementations

Download history 265/week @ 2024-04-22

265 downloads per month

Custom license

185KB
4.5K SLoC

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.extract_sound(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.

Dependencies

~17MB
~138K SLoC