Struct Uti 

pub struct Uti {

    pub template_resref: ResRef,
    pub base_item: i32,
    pub name: GffLocalizedString,
    pub description_unidentified: GffLocalizedString,
    pub description_identified: GffLocalizedString,
    pub tag: String,
    pub charges: u8,
    pub max_charges: u8,
    pub cost: u32,
    pub stack_size: u16,
    pub plot: bool,
    pub add_cost: u32,
    pub palette_id: u8,
    pub comment: String,
    pub model_variation: u8,
    pub body_variation: u8,
    pub texture_variation: u8,
    pub upgrade_level: u8,
    pub stolen: bool,
    pub identified: bool,
    pub droppable: bool,
    pub pickpocketable: bool,
    pub non_equippable: bool,
    pub new_item: bool,
    pub deleting: bool,
    pub upgrades: u32,
    pub properties: Vec<UtiProperty>,
}

Typed UTI model built from/to Gff data.

Fields

template_resref: ResRef

Item template resref (TemplateResRef). Never read by the K1 engine.

base_item: i32

Base item identifier (BaseItem).

name: GffLocalizedString

Localized item name (LocalizedName).

description_unidentified: GffLocalizedString

Localized description shown before identification (Description). If description_identified is missing, the engine duplicates this string into it so identification mechanics never crash.

description_identified: GffLocalizedString

Localized description shown when identified (DescIdentified). If description_unidentified is missing, the engine duplicates this string into it so identification mechanics never crash.

tag: String

Item tag (Tag).

charges: u8

Charges (Charges).

max_charges: u8

Maximum charges (MaxCharges).

cost: u32

Item cost (Cost). Ignored by the engine, which computes item cost dynamically.

stack_size: u16

Maximum stack size (StackSize).

plot: bool

Plot item flag (Plot).

add_cost: u32

Additional cost modifier (AddCost).

palette_id: u8

Palette identifier (PaletteID). Never read by the K1 engine.

comment: String

Toolset comment (Comment). Never read by the K1 engine.

model_variation: u8

Model variation (ModelVariation). If 0, the engine forces this to 1 at runtime.

body_variation: u8

Body variation (BodyVariation). Ignored by the engine, which reads from baseitems.2da instead.

texture_variation: u8

Texture variation (TextureVar). Only evaluated conditionally if the item’s 2DA model_type is exactly 1.

upgrade_level: u8

Upgrade level (UpgradeLevel). Never read by the K1 engine.

stolen: bool

Stolen flag (Stolen).

identified: bool

Identified flag (Identified). The engine unconditionally hardcodes this to true during SaveItem serialization, so any value other than true is dead data once a save is written.

droppable: bool

Droppable flag (Dropable). Explicitly sets bit 3 of the item’s internal memory flags.

pickpocketable: bool

Pickpocketable flag (Pickpocketable). Explicitly sets bit 4 of the item’s internal memory flags.

non_equippable: bool

Non-equippable flag (NonEquippable).

new_item: bool

New-item flag (NewItem).

deleting: bool

Deleting flag (DELETING).

upgrades: u32

Upgrade bitfield (Upgrades).

properties: Vec<UtiProperty>

Item property entries (PropertiesList).

Implementations

impl Uti

pub fn project(&self, itempropdef: Option<&TwoDa>) -> UtiProjection<'_>

Builds a UtiProjection of this UTI’s properties using the supplied itempropdef.2da.

Each UtiProperty is routed by its itempropdef.2da label to a typed DecodedProperty variant where one exists, or to DecodedProperty::Unknown otherwise. Pass None for itempropdef to surface every property as Unknown with property_label = None; the engine itself tolerates a missing table the same way.

The projection is the cheap, scope-free intermediate. Use UtiProjection::snapshot (or Uti::snapshot for the single-scope shortcut) to resolve it against a per-scope context.

pub fn snapshot(&self, cache: &mut TwoDaCache<'_>) -> UtiSnapshot<'_>

Builds a UtiSnapshot of this UTI against the given 2DA cache. Single-scope shortcut equivalent to self.project(itempropdef).snapshot(cache), where itempropdef comes from cache.

Missing or malformed itempropdef.2da / baseitems.2da is tolerated – the corresponding snapshot state degrades gracefully (all properties land in Unknown; combat / equip queries return false / None).

For multi-scope workflows (mod conflict analysis, vanilla vs modded diffs), call Uti::project once and UtiProjection::snapshot per scope so the typed-variant dispatch is not redone for each context.

impl Uti

pub fn new() -> Self

Creates an empty UTI value.

pub fn is_armor(&self) -> bool

Returns true when this item’s BaseItem belongs to the armor family.

pub fn from_gff(gff: &Gff) -> Result<Self, UtiError>

Builds typed UTI data from a parsed GFF container.

pub fn to_gff(&self) -> Gff

Converts this typed UTI value into a GFF container.

Trait Implementations

impl Clone for Uti

fn clone(&self) -> Uti

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Uti

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Uti

fn default() -> Self

Returns the “default value” for a type.

impl GffSchema for Uti

fn schema() -> &'static [FieldSchema]

Returns the root field schema for this GFF resource type.

impl PartialEq for Uti

fn eq(&self, other: &Uti) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Uti