Struct DebrisParticle 

pub struct DebrisParticle {

    pub glyph: char,
    pub position: Vec3,
    pub velocity: Vec3,
    pub angular_velocity: Vec3,
    pub mass: f32,
    pub restitution: f32,
    pub friction: f32,
    pub lifetime: f32,
    pub max_lifetime: f32,
    pub color: [f32; 4],
    pub scale: f32,
    pub rotation: Quat,
    pub debris_type: DebrisType,
    pub alive: bool,
    pub has_shattered: bool,
    pub emission: f32,
    pub glow_color: Vec3,
    pub settled: bool,
    pub fade_time: f32,
}

A single piece of combat debris — a glyph char with rigid-body dynamics.

Fields

glyph: char

The glyph character this debris displays.

position: Vec3

World position.

velocity: Vec3

Linear velocity (m/s).

angular_velocity: Vec3

Angular velocity (rad/s) around each axis.

mass: f32

Mass (kg). Affects inter-particle collision response.

restitution: f32

Coefficient of restitution [0, 1]. 0 = perfectly inelastic, 1 = elastic.

friction: f32

Surface friction coefficient [0, 1].

lifetime: f32

Time this particle has been alive (seconds).

max_lifetime: f32

Maximum time before the particle begins settling/fading.

color: [f32; 4]

RGBA colour.

scale: f32

Uniform scale factor.

rotation: Quat

Current rotation (Euler-ish, stored as quaternion for blending).

debris_type: DebrisType

The elemental type driving behaviour.

alive: bool

Whether this particle is alive and should be simulated/rendered.

has_shattered: bool

Whether this particle has already shattered (Ice only — prevents infinite recursion).

emission: f32

Emission intensity (glow).

glow_color: Vec3

Glow colour (RGB).

settled: bool

True when the particle is on the ground and mostly at rest.

fade_time: f32

Time spent in the settled/fading state.

Implementations

impl DebrisParticle

pub fn new(glyph: char, debris_type: DebrisType) -> Self

Create a new debris particle with the given character and type.

pub fn effective_alpha(&self) -> f32

Returns the alpha after applying fade.

pub fn is_expired(&self) -> bool

True when the particle has finished fading and can be recycled.

pub fn kill(&mut self)

Kill this particle immediately.

Trait Implementations

impl Clone for DebrisParticle

fn clone(&self) -> DebrisParticle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DebrisParticle

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

Formats the value using the given formatter.

impl Default for DebrisParticle

fn default() -> Self

Returns the “default value” for a type.