Struct AttributeInstance 

pub struct AttributeInstance {
    attribute: AttributeRef,
    base_value: f64,
    modifiers: Vec<AttributeModifier>,
    persistent: Vec<bool>,
    cached_value: f64,
}

Runtime state for a single attribute on an entity

Fields

attribute: AttributeRef

base_value: f64

modifiers: Vec<AttributeModifier>

persistent: Vec<bool>

Parallel to modifiers true means the modifier survives serialization

cached_value: f64

Implementations

impl AttributeInstance

const fn new(attribute: AttributeRef, base_value: f64) -> Self

pub const fn attribute(&self) -> AttributeRef

Returns the attribute definition

pub const fn base_value(&self) -> f64

Returns the base value before modifiers

pub fn set_base_value(&mut self, value: f64) -> bool

Sets the base value and recalculates. Returns true if changed

pub const fn value(&self) -> f64

Returns the final calculated value (base + modifiers, clamped)

pub fn add_modifier( &mut self, modifier: AttributeModifier, persistent: bool, ) -> bool

Adds a modifier. Returns false if a modifier with this ID already exists

pub fn has_modifier(&self, id: &Identifier) -> bool

Returns whether a modifier with the given ID exists.

pub fn set_modifier( &mut self, modifier: AttributeModifier, persistent: bool, ) -> bool

Adds or replaces a modifier. Returns true if the value actually changed.

pub fn remove_modifier(&mut self, id: &Identifier) -> bool

Removes a modifier by ID, Returns true if it existed

pub fn permanent_modifiers(&self) -> impl Iterator<Item = &AttributeModifier>

Returns an iterator over permanent modifiers (for serialization)

fn remove_transient_modifiers(&mut self) -> bool

Removes all transient (non-persistent) modifiers. Returns true if any were removed

fn recalculate(&mut self)

Three-phase vanilla calculation:

1. ADD_VALUE
2. ADD_MULTIPLIED_BASE
3. ADD_MULTIPLIED_TOTAL

fn to_snapshot(&self, attribute_id: i32) -> AttributeSnapshot

Builds a network snapshot for CUpdateAttributes