Struct Utc 

pub struct Utc {

    pub template_resref: ResRef,
    pub tag: String,
    pub comment: String,
    pub conversation: ResRef,
    pub first_name: GffLocalizedString,
    pub last_name: GffLocalizedString,
    pub age: i32,
    pub starting_package: u8,
    pub gold: u32,
    pub invulnerable: bool,
    pub experience: u32,
    pub subrace_id: u8,
    pub perception_id: u8,
    pub race_id: u8,
    pub color_skin: u8,
    pub color_hair: u8,
    pub color_tattoo1: u8,
    pub color_tattoo2: u8,
    pub appearance_head: u8,
    pub duplicating_head: u8,
    pub use_backup_head: u8,
    pub appearance_id: u16,
    pub gender_id: u8,
    pub faction_id: u16,
    pub walkrate_id: i32,
    pub ai_state: u16,
    pub skill_points: u16,
    pub movement_rate: u8,
    pub soundset_id: u16,
    pub portrait_id: u16,
    pub portrait_resref: ResRef,
    pub save_will: u8,
    pub save_fortitude: u8,
    pub morale: u8,
    pub morale_recovery: u8,
    pub morale_breakpoint: u8,
    pub palette_id: u8,
    pub bodybag_id: u8,
    pub body_variation: u8,
    pub texture_variation: u8,
    pub alignment: u8,
    pub challenge_rating: f32,
    pub blindspot: f32,
    pub multiplier_set: u8,
    pub natural_ac: u8,
    pub reflex_bonus: i16,
    pub willpower_bonus: i16,
    pub fortitude_bonus: i16,
    pub strength: u8,
    pub dexterity: u8,
    pub constitution: u8,
    pub intelligence: u8,
    pub wisdom: u8,
    pub charisma: u8,
    pub current_hp: i16,
    pub max_hp: i16,
    pub hp: i16,
    pub fp: i16,
    pub max_fp: i16,
    pub not_reorienting: bool,
    pub party_interact: bool,
    pub no_perm_death: bool,
    pub min1_hp: bool,
    pub plot: bool,
    pub interruptable: bool,
    pub is_pc: bool,
    pub disarmable: bool,
    pub ignore_cre_path: bool,
    pub hologram: bool,
    pub will_not_render: bool,
    pub deity: String,
    pub description: GffLocalizedString,
    pub lawfulness: u8,
    pub phenotype_id: i32,
    pub subrace_name: String,
    pub on_end_dialog: ResRef,
    pub on_blocked: ResRef,
    pub on_heartbeat: ResRef,
    pub on_notice: ResRef,
    pub on_spell: ResRef,
    pub on_attacked: ResRef,
    pub on_damaged: ResRef,
    pub on_disturbed: ResRef,
    pub on_end_round: ResRef,
    pub on_dialog: ResRef,
    pub on_spawn: ResRef,
    pub on_rested: ResRef,
    pub on_death: ResRef,
    pub on_user_defined: ResRef,
    pub skills: UtcSkills,
    pub classes: Vec<UtcClass>,
    pub special_abilities: Vec<UtcSpecialAbility>,
    pub feats: Vec<u16>,
    pub equipment: Vec<UtcEquipmentItem>,
    pub inventory: Vec<UtcInventoryItem>,
}

Typed UTC model built from/to Gff data.

Fields

template_resref: ResRef

Creature template resref (TemplateResRef).

tag: String

Creature tag (Tag).

comment: String

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

conversation: ResRef

Conversation resref (Conversation).

first_name: GffLocalizedString

Localized first name (FirstName).

last_name: GffLocalizedString

Localized last name (LastName).

age: i32

Age (Age).

starting_package: u8

Starting package ID (StartingPackage).

gold: u32

Gold carried (Gold).

invulnerable: bool

Invulnerability flag (Invulnerable).

experience: u32

Accumulated experience (Experience).

subrace_id: u8

Subrace ID (SubraceIndex).

perception_id: u8

Perception range ID (PerceptionRange).

race_id: u8

Race ID (Race).

color_skin: u8

Skin color index (Color_Skin).

color_hair: u8

Hair color index (Color_Hair).

color_tattoo1: u8

First tattoo color index (Color_Tattoo1).

color_tattoo2: u8

Second tattoo color index (Color_Tattoo2).

appearance_head: u8

Head appearance index (Appearance_Head). If 0, the engine forces this to 1 at runtime.

duplicating_head: u8

Duplicating-head index (DuplicatingHead).

use_backup_head: u8

Backup-head flag (UseBackupHead).

appearance_id: u16

Appearance ID (Appearance_Type).

gender_id: u8

Gender ID (Gender). Natively clamped by the engine to a maximum of 4.

faction_id: u16

Faction ID (FactionID).

walkrate_id: i32

Walk-rate ID (WalkRate).

ai_state: u16

AI state flags (AIState).

skill_points: u16

Unspent skill points (SkillPoints).

movement_rate: u8

Movement rate ID (MovementRate).

soundset_id: u16

Sound-set ID (SoundSetFile).

portrait_id: u16

Portrait ID (PortraitId).

portrait_resref: ResRef

Portrait resref override (Portrait).

save_will: u8

Will save (SaveWill). Strictly ignored by the KOTOR engine; reads willbonus instead.

save_fortitude: u8

Fortitude save (SaveFortitude). Strictly ignored by the KOTOR engine; reads fortbonus instead.

morale: u8

Morale (Morale). Never read by the K1 engine.

morale_recovery: u8

Morale recovery (MoraleRecovery). Never read by the K1 engine.

morale_breakpoint: u8

Morale breakpoint (MoraleBreakpoint). Never read by the K1 engine.

palette_id: u8

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

bodybag_id: u8

Body-bag ID (BodyBag).

body_variation: u8

Body variation (BodyVariation). Never read by the K1 engine.

texture_variation: u8

Texture variation (TextureVar). Never read by the K1 engine.

alignment: u8

Good/Evil alignment (GoodEvil). Natively clamped by the engine to a maximum of 100.

challenge_rating: f32

Challenge rating (ChallengeRating).

blindspot: f32

Blind-spot value (BlindSpot). Never read by the K1 engine.

multiplier_set: u8

Multiplier-set ID (MultiplierSet). Never read by the K1 engine.

natural_ac: u8

Natural armor class (NaturalAC).

reflex_bonus: i16

Reflex save bonus (refbonus).

willpower_bonus: i16

Will save bonus (willbonus).

fortitude_bonus: i16

Fortitude save bonus (fortbonus).

strength: u8

Strength (Str).

dexterity: u8

Dexterity (Dex).

constitution: u8

Constitution (Con).

intelligence: u8

Intelligence (Int).

wisdom: u8

Wisdom (Wis).

charisma: u8

Charisma (Cha).

current_hp: i16

Current hit points (CurrentHitPoints).

max_hp: i16

Maximum hit points (MaxHitPoints).

hp: i16

Base hit points (HitPoints).

fp: i16

Current force points (CurrentForce).

max_fp: i16

Maximum force points (ForcePoints).

not_reorienting: bool

Non-reorienting flag (NotReorienting).

party_interact: bool

Party-interact flag (PartyInteract).

no_perm_death: bool

Permanent-death disabled flag (NoPermDeath). Never read by the K1 engine.

min1_hp: bool

Min-1HP flag (Min1HP).

plot: bool

Plot flag (Plot).

interruptable: bool

Interruptable flag (Interruptable).

is_pc: bool

Player-character flag (IsPC).

disarmable: bool

Disarmable flag (Disarmable).

ignore_cre_path: bool

Ignore creature pathing (IgnoreCrePath). Never read by the K1 engine.

hologram: bool

Hologram flag (Hologram). Never read by the K1 engine.

will_not_render: bool

Will-not-render flag (WillNotRender). Never read by the K1 engine.

deity: String

Deprecated deity field (Deity).

description: GffLocalizedString

Deprecated localized description (Description).

lawfulness: u8

Deprecated lawfulness alignment (LawfulChaotic). Never read by the K1 engine.

phenotype_id: i32

Deprecated phenotype (Phenotype).

subrace_name: String

Deprecated textual subrace (Subrace).

on_end_dialog: ResRef

On-end-dialog script (ScriptEndDialogu).

on_blocked: ResRef

On-blocked script (ScriptOnBlocked).

on_heartbeat: ResRef

On-heartbeat script (ScriptHeartbeat).

on_notice: ResRef

On-notice script (ScriptOnNotice).

on_spell: ResRef

On-spell-at script (ScriptSpellAt).

on_attacked: ResRef

On-attacked script (ScriptAttacked).

on_damaged: ResRef

On-damaged script (ScriptDamaged).

on_disturbed: ResRef

On-disturbed script (ScriptDisturbed).

on_end_round: ResRef

On-end-round script (ScriptEndRound).

on_dialog: ResRef

On-dialogue script (ScriptDialogue).

on_spawn: ResRef

On-spawn script (ScriptSpawn).

on_rested: ResRef

On-rested script (ScriptRested).

on_death: ResRef

On-death script (ScriptDeath).

on_user_defined: ResRef

On-user-defined script (ScriptUserDefine).

skills: UtcSkills

Skill ranks from SkillList.

classes: Vec<UtcClass>

Class entries from ClassList. Engine ignores classes beyond the second. Duplicate class IDs cause a fatal engine crash.

special_abilities: Vec<UtcSpecialAbility>

Special abilities from SpecAbilityList.

feats: Vec<u16>

Feat identifiers from FeatList (Feat).

equipment: Vec<UtcEquipmentItem>

Equipped-item entries from Equip_ItemList.

inventory: Vec<UtcInventoryItem>

Inventory entries from ItemList.

Implementations

impl Utc

pub fn project(&self) -> UtcProjection<'_>

Builds a UtcProjection of this UTC.

Unlike Uti::project, UTC’s projection takes no context: typed list dispatch happens at snapshot time against per-list 2DAs (classes.2da, feat.2da, spells.2da) rather than against one dispatch table at projection time. The projection stays cheap and scope-free, ready to feed one or more snapshots.

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

Builds a UtcSnapshot of this UTC against the given 2DA cache. Single-scope shortcut equivalent to self.project().snapshot(cache).

For multi-scope workflows (mod conflict analysis, vanilla vs modded diffs), call Utc::project once and UtcProjection::snapshot per scope.

impl Utc

pub fn new() -> Self

Creates an empty UTC value.

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

Builds typed UTC data from a parsed GFF container.

pub fn to_gff(&self) -> Gff

Converts this typed UTC value into a GFF container.

Trait Implementations

impl Clone for Utc

fn clone(&self) -> Utc

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Utc

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

Formats the value using the given formatter.

impl Default for Utc

fn default() -> Self

Returns the “default value” for a type.

impl GffSchema for Utc

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

Returns the root field schema for this GFF resource type.

impl PartialEq for Utc

fn eq(&self, other: &Utc) -> 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 Utc