zenkit-rs

Rust workspace for reading Gothic game assets, based on ZenKit behavior and formats.

Status

• Asset parser parity with reference scanner is validated via deep diff.
• Current local validation result: Status/Kind mismatches: 0 and Detail mismatches: 0.

Workspace crates

• zenkit_core: core math, IO helpers, date/error types
• zenkit_archive: ZenGin archive readers (ASCII/BINARY/BIN_SAFE)
• zenkit_vdf: VDF + keyvalues parsing
• zenkit_tex: textures, materials, fonts
• zenkit_mesh: mesh formats (MSH, MRM, MMB, soft-skin)
• zenkit_model: model formats (MDL, MDM, MDH, MAN, scripts/cutscenes)
• zenkit_world: world-related structures (ZEN, BSP, VOB, waynet)
• zenkit_daedalus: Daedalus script/vm structures
• zenkit_ext: extra helpers/tools
• zenkit_api: facade crate and prelude for external projects
• zenkit_test: asset scan/verification tool

Quick start

cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace

Run full local asset scan (requires local game data setup):

$env:ZENKIT_DEEP_SCAN='1'
cargo run -p zenkit_test --quiet

Using from another project

Prefer depending on zenkit_api and importing from its prelude:

use zenkit_api::prelude::*;

Notes

• .REFFERENCE/ and local game assets are ignored from version control.
• This repository focuses on asset format support, not on rendering/runtime engine logic.

License

MIT. See LICENSE.