bevy_archie 0.3.0

A comprehensive game controller support module for Bevy
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

//! Main controller plugin.
//!
//! This module provides the main plugin that ties together all
//! controller support functionality.

use bevy::prelude::*;

/// The main controller support plugin.
///
/// Add this plugin to your app to enable controller support:
///
/// ```rust,no_run
/// use bevy::prelude::*;
/// use bevy_archie::prelude::*;
///
/// App::new()
///     .add_plugins(DefaultPlugins)
///     .add_plugins(ControllerPlugin::default())
///     .run();
/// ```
#[derive(Debug, Clone, Default)]
pub struct ControllerPlugin {
    /// Base path for controller icon assets.
    pub icon_base_path: Option<String>,
}

impl ControllerPlugin {
    /// Create a new controller plugin with custom icon path.
    pub fn with_icon_path(icon_path: impl Into<String>) -> Self {
        Self {
            icon_base_path: Some(icon_path.into()),
        }
    }
}

impl Plugin for ControllerPlugin {
    fn build(&self, app: &mut App) {
        // Register core types
        crate::config::register_config_types(app);
        crate::detection::register_detection_types(app);
        crate::actions::register_action_types(app);
        crate::icons::register_icon_types(app);
        crate::virtual_cursor::register_virtual_cursor_types(app);

        // Register new feature types
        crate::haptics::register_haptics_types(app);
        crate::input_buffer::register_input_buffer_types(app);
        crate::multiplayer::register_multiplayer_types(app);
        crate::gyro::register_gyro_types(app);
        crate::touchpad::register_touchpad_types(app);
        crate::action_modifiers::register_action_modifier_types(app);
        crate::profiles::register_profile_types(app);
        crate::debug::register_debug_types(app);

        // Set up icon path if provided
        if let Some(path) = &self.icon_base_path {
            app.insert_resource(crate::icons::ControllerIconAssets::new(path.clone()));
        }

        // Add core systems
        crate::detection::add_detection_systems(app);
        crate::actions::add_action_systems(app);
        crate::icons::add_icon_systems(app);
        crate::virtual_cursor::add_virtual_cursor_systems(app);

        // Add new feature systems
        crate::haptics::add_haptics_systems(app);
        crate::input_buffer::add_input_buffer_systems(app);
        crate::multiplayer::add_multiplayer_systems(app);
        crate::gyro::add_gyro_systems(app);
        crate::touchpad::add_touchpad_systems(app);
        crate::action_modifiers::add_action_modifier_systems(app);
        crate::profiles::add_profile_systems(app);
        crate::debug::add_debug_systems(app);

        // Add feature-gated systems
        #[cfg(feature = "remapping")]
        crate::remapping::add_remapping_systems(app);

        #[cfg(feature = "virtual_keyboard")]
        crate::virtual_keyboard::add_virtual_keyboard_systems(app);
    }
}

/// System set for controller input processing.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, SystemSet)]
pub enum ControllerSystemSet {
    /// Device detection runs first.
    Detection,
    /// Action state updates.
    Actions,
    /// UI updates based on input state.
    UI,
}