bevy_power 0.1.1

A comprehensive power/energy system for Bevy games with regeneration, limits, knockouts, leveling, and UI components
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

use crate::limits::LimitType;
use bevy::prelude::*;

/// Event to spend power
#[derive(Message, Debug, Clone)]
pub struct SpendPowerEvent {
    /// Entity with the PowerBar component
    pub entity: Entity,
    /// Amount of power to spend
    pub amount: f32,
}

/// Event to change power (add or subtract)
#[derive(Message, Debug, Clone)]
pub struct PowerChangeEvent {
    /// Entity with the PowerBar component
    pub entity: Entity,
    /// Amount to change (negative for decrease)
    pub amount: f32,
}

/// Event to apply a power limit
#[derive(Message, Debug, Clone)]
pub struct ApplyLimitEvent {
    /// Entity to apply the limit to
    pub entity: Entity,
    /// Unique ID for this limit
    pub id: u32,
    /// Type of limit (points or percentage)
    pub limit_type: LimitType,
    /// Color for UI display
    pub color: Color,
    /// Duration in seconds (None for permanent)
    pub duration: Option<f32>,
    /// Whether this limit resets the regeneration cooldown
    pub resets_cooldown: bool,
}

impl ApplyLimitEvent {
    /// Create a new limit event with points
    pub fn points(
        entity: Entity,
        id: u32,
        points: f32,
        color: Color,
        duration: Option<f32>,
        resets_cooldown: bool,
    ) -> Self {
        Self {
            entity,
            id,
            limit_type: LimitType::Points(points),
            color,
            duration,
            resets_cooldown,
        }
    }

    /// Create a new limit event with percentage
    pub fn percentage(
        entity: Entity,
        id: u32,
        percentage: f32,
        color: Color,
        duration: Option<f32>,
        resets_cooldown: bool,
    ) -> Self {
        Self {
            entity,
            id,
            limit_type: LimitType::Percentage(percentage),
            color,
            duration,
            resets_cooldown,
        }
    }
}

/// Event to lift/remove a power limit
#[derive(Message, Debug, Clone)]
pub struct LiftLimitEvent {
    /// Entity to remove the limit from
    pub entity: Entity,
    /// ID of the limit to remove
    pub id: u32,
}

/// Event sent when player is knocked out
#[derive(Message, Debug, Clone)]
pub struct KnockedOutEvent {
    /// Entity that was knocked out
    pub entity: Entity,
}

/// Event to revive a knocked out player
#[derive(Message, Debug, Clone)]
pub struct ReviveEvent {
    /// Entity to revive
    pub entity: Entity,
    /// Amount of power to restore upon revival
    pub power_amount: f32,
}

/// Event sent when player levels up
#[derive(Message, Debug, Clone)]
pub struct LevelUpEvent {
    /// Entity that leveled up
    pub entity: Entity,
    /// New level
    pub new_level: u32,
    /// Power bonus gained
    pub power_bonus: f32,
}