You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This crate adds a debug menu to your [Bevy](https://bevyengine.org) game that can show and edit all the current entities.
3
+
This crate adds a debug menu to your [Bevy](https://bevyengine.org) game. It can show your diagnostics, and explore and edit the current entities and resources.
4
4
5
-
Usage:
5
+
## Usage
6
+
7
+
* make sure you are using `bevy` from a recent `master` branch
* launch the app and press `F10` to show or hide the menu
6
15
7
-
* add the [DebugMenuPlugin] to your bevy app
8
-
* add the [DebugMenuFont] resource (and the font file to your `assets/` folder)
9
-
* optional: adapt your game to stop processing keyboard inputs by listening to [FocusedEvent] and [UnfocusedEvent]
10
-
* press F10 to show or hide the menu
11
-
12
-
## Warnings
13
16
14
-
You need to compile in release mode to have descent frame rate.
17
+
## Optional setup
15
18
16
-
This contains unsafe code that needs reviewing.
19
+
* derive `Reflect`, `ReflectComponent` and `ReflectResource` on your types
20
+
* adapt your game to stop processing keyboard inputs when editing entities by listening to `FocusedEvent` and `UnfocusedEvent`
17
21
18
-
The debug menu will push the rest of your UI elements even when hidden. A PR is being made to bevy to fix that.
22
+
## Warnings
19
23
20
-
This is a prototype.
24
+
* you need to compile in release mode to have descent frame rate
25
+
* with default features, the debug menu will push the rest of your UI elements even when hidden (see [#1211](https://github.com/bevyengine/bevy/pull/1211))
26
+
* with default features, the "Resource" panel is disabled (see [#1260](https://github.com/bevyengine/bevy/pull/1260))
27
+
* both issues can be fixed by using a bevy fork and enabling the `extra` feature in `Cargo.toml`:
28
+
```toml
29
+
[dependencies]
30
+
bevy_debug_menu = { git = "https://github.com/Davier/bevy_debug_menu", features = ["extra"] }
0 commit comments