Module ute 

Typed UTE (.ute) model and conversion helpers. UTE (.ute) typed generic wrapper.

UTE resources are GFF-backed encounter templates that define what creatures spawn, how many, and under what conditions.

Scope

• Typed access for encounter identity, spawn config, difficulty, and scripts.
• Typed creature list (CreatureList) with per-entry template, CR, and single-spawn flag.
• Position, runtime state, area tracking, geometry, spawn points, area list, and spawn list are all fully modeled.

Field Layout

UTE root struct
+-- TemplateResRef / Tag / LocalizedName / Comment / PaletteID
+-- Active / Reset / ResetTime / Respawns / SpawnOption
+-- MaxCreatures / RecCreatures / PlayerOnly / Faction
+-- DifficultyIndex / Difficulty
+-- XPosition / YPosition / ZPosition
+-- OnEntered / OnExit / OnHeartbeat / OnExhausted / OnUserDefined
+-- NumberSpawned / HeartbeatDay / HeartbeatTime / LastSpawnDay
+-- LastSpawnTime / LastEntered / LastLeft / Started / Exhausted
+-- CurrentSpawns / CustomScriptId
+-- AreaListMaxSize / SpawnPoolActive / AreaPoints
+-- CreatureList[]
|   +-- ResRef / CR / SingleSpawn
+-- Geometry[]
|   +-- X / Y / Z
+-- SpawnPointList[]
|   +-- X / Y / Z / Orientation
+-- AreaList[]
|   +-- AreaObject
+-- SpawnList[]
    +-- SpawnResRef / SpawnCR

Structs

Ute

Typed UTE model built from/to Gff data.

UteAreaEntry

An entry in the encounter’s area tracking list (AreaList list).

UteCreature

A single entry in the encounter’s creature table.

UteGeometryVertex

A single vertex in the encounter’s boundary geometry (Geometry list).

UteSpawnEntry

An entry in the encounter’s spawn resource list (SpawnList list).

UteSpawnPoint

A spawn point in the encounter (SpawnPointList list).

Enums

UteError

Errors produced while reading or writing typed UTE data.

Functions

read_ute

Reads typed UTE data from a reader at the current stream position.

read_ute_from_bytes

Reads typed UTE data directly from bytes.

write_ute

Writes typed UTE data to an output writer.

write_ute_to_vec

Serializes typed UTE data into a byte vector.