This crate provides a debug interface using egui where you can visually edit the values of your components live.
You can either inspect a single resource using the InspectorPlugin
, or use the WorldInspectorPlugin
to inspect all entities.
```rust use bevy::prelude::*; use bevyinspectoregui::{InspectorPlugin, Inspectable};
struct Data { should_render: bool, text: String, #[inspectable(min = 42.0, max = 100.0)] size: f32, }
fn main() { App::new() .addplugins(DefaultPlugins) .addplugin(InspectorPlugin::::new()) .run(); } ```
```rust use bevy::prelude::*; use bevyinspectoregui::WorldInspectorPlugin;
fn main() { App::new() .addplugins(DefaultPlugins) .addplugin(WorldInspectorPlugin::new()) .run(); } ```
You can configure the WorldInspectorPlugin
by inserting the WorldInspectorParams
resource.
If you want to only display some components, you may want to use the InspectorQuery instead.
By default, types implementing Inspectable
will not be displayed in the WorldInspector
, because the there is no way to know of the trait implementation at runtime.
You can call world.register_inspectable::<T>()
to tell bevy-inspector-egui
how that type should be displayed, and it will show up correctly in the world inspector.
Alternatively, you can #[derive(Reflect)]
and call world.register_type::<T>()
. This will enable bevy's reflection feature for the type, and it will show up in the world inspector.
```rust use bevy::prelude::*; use bevyinspectoregui::{WorldInspectorPlugin, Inspectable, RegisterInspectable};
struct InspectableType;
struct ReflectedType;
fn main() {
App::new()
.addplugins(DefaultPlugins)
.addplugin(WorldInspectorPlugin::new())
.registerinspectable::bevy_reflect
machinery, so that even without implementing Inspectable
we can display the struct fields
.run();
}
``
More examples (with pictures) can be found in the [
examples folder`](examples).
| bevy | bevy-inspector-egui | | ------- | ------------------- | | 0.6 | 0.9 | | 0.6 | 0.8 | | 0.6 | 0.7 | | 0.5 | 0.5-0.6 | | 0.5 | 0.4 | | 0.4 | 0.1-0.3 |