#bevy-plugin #button #bevy #released #component #react #helper

bevy_button_released_plugin

Bevy helper crate that allows to react to button being released

10 releases (6 breaking)

new 0.8.0 Dec 1, 2024
0.7.0 Nov 15, 2024
0.6.0 Jul 21, 2024
0.5.0 Feb 17, 2024
0.1.0 Apr 6, 2023

#306 in Game dev

Download history 19/week @ 2024-09-23 1/week @ 2024-09-30 2/week @ 2024-10-07 1/week @ 2024-10-14 8/week @ 2024-11-04 109/week @ 2024-11-11 22/week @ 2024-11-18

139 downloads per month

MIT license

35KB
58 lines

Bevy Button Released plugin

crates.io license crates.io

This crate makes Bevy application aware of the release of the button instead of reacting right after clicking. I think it will be addressed in next release but until then it could be helpful for some people.

Install

cargo add bevy_button_released_plugin

Usage

Add ButtonsReleasedPlugin during app creation process, then the GameButton component will be added to buttons and it is possible to react to it like in button_system function in example below. Auto adding GameButton can be disabled by disabling default "auto_add" feature.

use bevy::{color::palettes::css::*, prelude::*};
use bevy_button_released_plugin::{ButtonsReleasedPlugin, OnButtonReleased};

pub fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_plugins(ButtonsReleasedPlugin)
        .add_systems(Startup, setup)
        .run();
}

fn on_button(trigger: Trigger<OnButtonReleased>, q: Query<&Name>, mut q_text: Query<&mut Text>) {
    let button_name = q.get(trigger.entity()).expect("Missing Name!");
    **q_text.single_mut() = format!("Last button released: {}", button_name);
}

fn setup(mut commands: Commands) {
    commands.spawn(Camera2d);

    commands.spawn(root()).with_children(|parent| {
        parent.spawn((
            Text::new("Press any button below"),
            TextFont {
                font_size: 40.0,
                ..default()
            },
            node(50.0),
        ));
        for (text, color) in [("Green", GREEN), ("Red", RED), ("Yellow", YELLOW)] {
            parent
                .spawn((
                    Button,
                    node(80.0),
                    BackgroundColor(color.into()),
                    Name::new(text),
                ))
                .observe(on_button);
        }
    });
}

fn root() -> impl Bundle {
    Node {
        width: Val::Percent(100.0),
        height: Val::Percent(100.0),
        padding: UiRect::all(Val::Px(50.0)),
        justify_content: JustifyContent::SpaceEvenly,
        flex_direction: FlexDirection::Column,
        ..default()
    }
}

fn node(height: f32) -> Node {
    Node {
        height: Val::Px(height),
        ..default()
    }
}

Bevy compatibility table

Bevy version Crate version
0.15 0.8
0.14 0.6, 0.7
0.13 0.5
0.12 0.3,0.4
0.11 0.2
0.10 0.1

Dependencies

~52–85MB
~1.5M SLoC