Struct DamageSource 

pub struct DamageSource {
    pub damage_type: &'static DamageType,
    causing_entity: Option<SharedEntity>,
    direct_entity: Option<SharedEntity>,
    source_position: Option<DVec3>,
}

Describes damage while retaining the exact direct and causing entity allocations.

Removal and respawn never rebind attribution. Store recent sources in super::DamageHistory to avoid self/mutual ownership cycles.

Fields

damage_type: &'static DamageType

The damage type registry entry.

causing_entity: Option<SharedEntity>

direct_entity: Option<SharedEntity>

source_position: Option<DVec3>

Implementations

impl DamageSource

pub const fn environment(damage_type: &'static DamageType) -> Self

Environmental damage with no entity or position context (void, starvation, etc.).

pub fn direct(damage_type: &'static DamageType, entity: SharedEntity) -> Self

Damage delivered directly by its causing entity.

pub fn with_causing_entity(self, entity: SharedEntity) -> Self

Adds the entity ultimately responsible for the damage.

pub fn with_direct_entity(self, entity: SharedEntity) -> Self

Adds the direct entity that delivered the damage.

pub const fn causing_entity(&self) -> Option<&SharedEntity>

The original cause (e.g. a projectile’s shooter), retained after removal.

pub const fn direct_entity(&self) -> Option<&SharedEntity>

The original direct entity (e.g. the projectile), retained after removal.

pub fn source_position(&self) -> Option<DVec3>

The explicit source position, or the direct entity’s position when none was set. Distinct from the raw position sent in packets.

pub const fn source_position_raw(&self) -> Option<DVec3>

The explicit source position without the direct-entity fallback, used by the damage-event packet.

pub fn is_creative_player(&self) -> bool

Whether the causing player has vanilla infinite-materials abilities.

pub const fn with_source_position(self, source_position: DVec3) -> Self

Adds the vanilla source position used by damage events and knockback.

pub fn bypasses_invulnerability(&self) -> bool

Whether this damage bypasses creative/spectator invulnerability.

pub fn is(&self, tag: &Identifier) -> bool

Returns whether this damage type is in the given vanilla damage-type tag.

pub fn is_direct(&self) -> bool

Whether the damage was dealt directly by the causing entity rather than indirectly, e.g. by a thrown projectile.

pub const fn bypasses_cooldown(&self) -> bool

Whether this damage bypasses the invulnerability cooldown timer. No vanilla damage types currently use this, but the logic exists in LivingEntity.hurtServer(). TODO: use damage type tag query once supported

pub fn scales_with_difficulty(&self) -> bool

Whether this damage scales with difficulty for the retained causing entity.

Trait Implementations

impl Clone for DamageSource

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DamageSource

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

Formats the value using the given formatter.