nwnrs-git

Typed parser for Neverwinter Nights area instance (GIT) resources.

Why This Crate Exists

GFF is a general-purpose container; GIT is domain-specific. The raw GFF layer has no knowledge of placed instances, instance types, or area geometry. This crate lifts raw GFF structs into typed Rust collections so area tooling can work with creatures, doors, placeables, and waypoints directly instead of navigating untyped field maps.

Scope

• parse GIT payloads into typed instance collections such as creatures, doors, placeables, triggers, sounds, and waypoints
• preserve the original raw GFF structures alongside the typed view
• expose geometry and transform data in forms suitable for higher-level tools
• rebuild and write typed GIT payloads back to GFF

The principal entry points are [read_git], [build_git_root], [write_git], and [GitFile].

Invariants

• authored instance order is preserved within each typed collection
• raw top-level and per-instance GFF data remain available through the typed model
• geometry points and transforms are represented explicitly rather than being folded into ad hoc tuples
• rebuilding a GIT payload preserves unknown per-entry raw fields while rewriting the typed fields owned by this crate

See also

• nwnrs-gff, the underlying typed GFF container layer
• nwnrs-set, which describes tileset structure rather than placed instances