bevy_pretty_nice_menus

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.

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.