Struct EntityPriorityMut 

pub struct EntityPriorityMut<'a, E: Copy + Eq + Hash> { /* private fields */ }

Mutable handle for reading and setting an entity’s priority in one priority layer. Lazy-creates a state entry on first write so set-and-forget works even before the entity enters scope for that user.

Returned by global_entity_priority_mut / user_entity_priority_mut on the server, entity_priority_mut on the client, and their Bevy-adapter passthroughs.

Implementations

impl<'a, E: Copy + Eq + Hash> EntityPriorityMut<'a, E>

pub fn entity(&self) -> E

Returns the entity this handle refers to.

pub fn accumulated(&self) -> f32

Current accumulated priority value. Higher = more urgent. Returns 0.0 if no entry yet.

pub fn gain(&self) -> Option<f32>

Current per-tick gain override. None means the default (1.0) applies.

pub fn is_overridden(&self) -> bool

Returns true if a per-tick gain override is currently active.

pub fn set_gain(&mut self, gain: f32) -> &mut Self

Set a persistent per-tick gain override for this layer. Stays in effect until reset() or another set_gain() call. Lazy-creates the entry.

pub fn boost_once(&mut self, amount: f32) -> &mut Self

One-shot additive boost to the accumulator. Does not change gain. Multiple calls in one tick sum additively. Lazy-creates the entry. Persists across ticks until the entity is sent (then reset to 0).

pub fn reset(&mut self) -> &mut Self

Clear the gain override — return to default (1.0). Does NOT clear the accumulator value itself, and does NOT remove the entry.