Struct War3MapMetadata 

pub struct War3MapMetadata {
    pub header: War3MapHeader,
    pub map_info: Option<War3MapW3i>,
    pub imp: Option<War3MapImp>,
    pub wts: Option<War3MapWts>,
    pub images: Vec<War3Image>,
    pub minimap_icons: Option<War3MapMmp>,
    pub files: Option<Vec<String>>,
    pub modification: Option<ModInfo>,
}

Rich in-memory parse result.

Holds non-serializable assets such as War3Image rasters. Convert to MapSnapshot for CLI dumps, JSON, or WASM.

Fields

header: War3MapHeader

map_info: Option<War3MapW3i>

imp: Option<War3MapImp>

wts: Option<War3MapWts>

images: Vec<War3Image>

minimap_icons: Option<War3MapMmp>

Minimap icons from war3map.mmp (gold mines, houses, starts).

files: Option<Vec<String>>

modification: Option<ModInfo>

Third-party modification detected in the map script, if any.

Implementations

impl War3MapMetadata

pub fn parse(buffer: &[u8]) -> Result<Self>

Parse a map buffer, reading every known member file.

Individual member files that are missing or corrupt simply come back as None / empty — only an unreadable archive is an error.

Example

use war3parser::prelude::War3MapMetadata;

let buffer = std::fs::read("path/to/map.w3x")?;
let mut metadata = War3MapMetadata::parse(&buffer)?;
metadata.resolve_trigger_strings();
let snapshot = metadata.snapshot()?;

pub fn parse_snapshot(buffer: &[u8]) -> Result<MapSnapshot>

Parse a buffer and immediately produce a portable MapSnapshot, with TRIGSTR references resolved when a string table is present.

pub fn resolve_trigger_strings(&mut self)

Replace TRIGSTR_<id> references in the map info with their values from the string table. No-op when either part is missing.

pub fn snapshot(&self) -> Result<MapSnapshot>

Build a portable snapshot from the rich in-memory metadata.

pub fn save(&self, out_dir: impl AsRef<Path>) -> Result<()>

Save metadata (JSON + PNG images) under out_dir.