What is aoe2-probe?

This is a rust library for editing aoe2scenorio files from AoE2 DE.

WARNING

• aoe2-probe is currently in the very early stage. APIs may change dramatically in following updates. Please don't use this project in serious development.
• Due to the zlib implementation difference, the exported file cannot be as same as the imported file, while the content of files is constant(Don't worry, AoE2 DE still understand it).Backing up the original is always recommended.

Design Goals

• Full ability to access every byte in aoe2scenorio files.
• Editing every bit with a reliable correctness check. todo!()
• Provides constant API compatibility across game versions. todo!()

Getting Started

Under the directory ./examples/, you can find several simple showcases.

Import and export files: ```rust use aoe2_probe::scenorio::Scenorio;

//Reading scenorio content from the .aoe2scenorio file let scenorio = Scenorio::fromfile("./resources/chapter1.aoe2scenario"); //saving content to a new .aoe2scenorio file scenorio.to_file("./resources/temp.aoe2scenario"); ```

Update attributes: ```rust use aoe2_probe::scenorio::Scenorio;

//versio's structure definition can be found in the folder /src/prebuilt/ver146/versio.rs let mut scenorio = Scenorio::fromfile("./resources/chapter1.aoe2scenario"); let fileheader = scenorio.versio.trymutmap()["fileheader"].trymutmap(); let creator = fileheader["creatorname"].trymutstr32(); //Update the creator name. creator.setcontent("Arian"); ```

customize a structure: ```rust //Define a socre record let mut root = LinkedHashMap::new(); root.pushback("score", Token::Int16(100)); root.pushback("name", Token::Str32(DynString::with_capacity(12, "anonymous")));

//serialize root.tolevec();

//deserialize root.fromlevec(); ```

Run exampes with the following command: shell cargo run --example read_write Every member of versio and itself implements fmt::Debug trait. Print them if you want to know more. rust let scenorio = Scenorio::from_file("./resources/chapter_1.aoe2scenario"); println!("{:?}", &scenorio.versio())

Supports

|Version|Support| |----|----| |ver.1.46|Support|

Currently, only version 1.46 and newer will be firstly supported.

Libraries Used

• miniz_oxide: Pure rust Rust replacement for the miniz deflate/zlib encoder/decoder using no unsafe code.
• log: A lightweight logging facade.
• env_logger: Implements a logger that can be configured via environment variables.

Acknowledgment

This library is inpired by AoE2ScenarioParser and Trigger Craft