issun-bevy 0.7.0

ISSUN plugins for Bevy ECS
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
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

//! Combat Plugin for Bevy ECS

use bevy::prelude::*;

use super::components::*;
use super::events::*;
use super::systems::*;
use crate::IssunSet;

/// Combat Plugin
///
/// Provides turn-based combat framework with:
/// - Damage calculation with defense mechanics
/// - Turn management
/// - Combat log tracking
/// - Deterministic replay support
#[derive(Default)]
pub struct CombatPlugin {
    pub config: CombatConfig,
}

impl CombatPlugin {
    pub fn new() -> Self {
        Self::default()
    }

    pub fn with_config(mut self, config: CombatConfig) -> Self {
        self.config = config;
        self
    }
}

impl Plugin for CombatPlugin {
    fn build(&self, app: &mut App) {
        // Resources
        app.insert_resource(self.config.clone())
            .init_resource::<ReplayEntityMap>()
            .init_resource::<FrameCount>();

        // Messages (Bevy 0.17: buffered events)
        app.add_message::<CombatStartRequested>()
            .add_message::<CombatStartedEvent>()
            .add_message::<CombatTurnAdvanceRequested>()
            .add_message::<CombatTurnCompletedEvent>()
            .add_message::<CombatEndRequested>()
            .add_message::<CombatEndedEvent>()
            .add_message::<DamageRequested>()
            .add_message::<DamageAppliedEvent>();

        // Component registration (⚠️ CRITICAL: All types must be registered)
        app.register_type::<Combatant>()
            .register_type::<Health>()
            .register_type::<Attack>()
            .register_type::<Defense>()
            .register_type::<UniqueId>()
            .register_type::<CombatSession>()
            .register_type::<CombatParticipants>()
            .register_type::<CombatLog>()
            .register_type::<CombatLogEntry>()
            .register_type::<ReplayRecorder>()
            .register_type::<RecordedCommand>()
            .register_type::<CommandType>()
            .register_type::<CombatSessionRng>()
            .register_type::<CombatConfig>()
            .register_type::<ReplayEntityMap>()
            .register_type::<FrameCount>()
            // Register all Message types
            .register_type::<CombatStartRequested>()
            .register_type::<CombatStartedEvent>()
            .register_type::<CombatTurnAdvanceRequested>()
            .register_type::<CombatTurnCompletedEvent>()
            .register_type::<CombatEndRequested>()
            .register_type::<CombatEndedEvent>()
            .register_type::<DamageRequested>()
            .register_type::<DamageAppliedEvent>()
            .register_type::<CombatResult>();

        // Core systems (placed in Update schedule)
        app.add_systems(
            Update,
            (
                handle_combat_start,
                handle_damage_request,
                handle_turn_advance,
                handle_combat_end,
                cleanup_zombie_entities,
            )
                .chain()
                .in_set(IssunSet::Logic),
        );
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_combat_plugin_initialization() {
        let mut app = App::new();
        app.add_plugins(MinimalPlugins)
            .add_plugins(CombatPlugin::default());

        // Verify resources are initialized
        assert!(app.world().get_resource::<CombatConfig>().is_some());
        assert!(app.world().get_resource::<ReplayEntityMap>().is_some());
        assert!(app.world().get_resource::<FrameCount>().is_some());

        // Run one frame to ensure no panics
        app.update();
    }

    #[test]
    fn test_combat_plugin_with_custom_config() {
        let mut app = App::new();
        app.add_plugins(MinimalPlugins)
            .add_plugins(CombatPlugin::new().with_config(CombatConfig {
                enable_log: false,
                max_log_entries: 50,
                min_damage: 2,
            }));

        let config = app.world().get_resource::<CombatConfig>().unwrap();
        assert!(!config.enable_log);
        assert_eq!(config.max_log_entries, 50);
        assert_eq!(config.min_damage, 2);
    }
}