bevy_pretty_nice_menus
| Crates.io | bevy_pretty_nice_menus |
| lib.rs | bevy_pretty_nice_menus |
| version | 0.3.3 |
| created_at | 2025-11-26 19:05:47.750241+00 |
| updated_at | 2026-01-14 03:01:36.899957+00 |
| description | A menu stack abstraction for Bevy |
| homepage | |
| repository | https://github.com/DragonFoxCollective/bevy_pretty_nice_menus |
| max_upload_size | |
| id | 1952066 |
| size | 72,650 |
Jady Wright (jwright159)
documentation
README
bevy_pretty_nice_menus
| bevy | bevy_pretty_nice_menus |
|---|---|
| 0.17 | 0.1, 0.2, 0.3, 0.4 |
A menu stack abstraction for Bevy.
Usage
A "menu" in this context is an arbitrary game state, usually one that accepts input. Each menu goes on the menu stack, with the top menu being the "current" menu. The basic gameplay state also counts as a menu, and should be the lowest menu on the stack.
Add the [PrettyNiceMenusPlugin] plugin to your app.
[MenuStack]
push menu entities onto the stack when you want it to become active, and remove it when you want it to deactivate.
The top entity on the menu stack triggers the [ActivateMenu] event, and the old top entity gets [DeactivateMenu].
[MenuHidesWhenClosed]
Menus with this component will automatically have their visibility set to Visible when activated, and Hidden when deactivated.
[MenuDespawnsWhenClosed]
Menus with this component despawn when deactivated.
[MenuWithMouse] and [MenuWithoutMouse]
Menus with these components will either have the mouse unlocked and visible or grabbed and invisible when activated. There is no default behavior.
Only available with the visibility feature.
[show_menu_on_event] and [close_menu_on_event]
These are two entity observers, where the entity target is either pushed or removed when the input is triggered.
Usage with [bevy_pretty_nice_input]
This crate also has compatibility with BPNI if the pretty_nice_input feature is enabled.
[MenuWithInput]
The highest menu on the stack that has this component will be the only input on the stack without InputDisabled.
This doesn't have to be the top menu on the stack period and can be in the middle of the stack.
[MenuInputs] and [MenuInputOf]
This is a relationship where, when the input of a menu with [MenuWithInput] is enabled or disabled,
all descendents using this relationship are also enabled or disabled.
[show_menu_on_action]
This is an observer that takes a BPNI action type and a marker component type, and when the action is JustPressed,
the single entity with the given marker component is shown.
[close_menu_on_action]
This is an observer that takes a BPNI action type, and when the action is JustPressed,
the input of the action is hidden.