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

wz_reader

A wz file reader to resolve wz file with thread safe

9 releases

0.0.12 Nov 11, 2024
0.0.11 Sep 10, 2024
0.0.10 Jul 8, 2024
0.0.7 May 24, 2024
0.0.4 Apr 24, 2024

#1309 in Parser implementations

Download history 8/week @ 2024-07-29 146/week @ 2024-09-09 14/week @ 2024-09-16 22/week @ 2024-09-23 36/week @ 2024-09-30 131/week @ 2024-11-11

131 downloads per month

Custom license

275KB
6.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.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.

Dependencies

~6–9.5MB
~193K SLoC