A static analysis tool that visualizes Bevy game engine internals — state hierarchies, plugin dependencies, schedule configurations, and system set ordering.
- State Hierarchies — Extracts
States,SubStates, andComputedStateswith their relationships - Plugin Dependencies — Maps plugin registrations, sub-plugins, and plugin groups
- Schedule Configurations — Parses
Update,FixedUpdate, and custom schedules with system ordering - System Sets — Tracks set definitions and ordering constraints (
before,after,chain) - Multiple Output Formats — Interactive TUI, JSON export, and self-contained HTML visualization
cargo install bevy_xrayPoint bevy-xray at a Bevy workspace:
# Launch interactive TUI
bevy-xray --path /path/to/bevy/workspace
# Export as JSON
bevy-xray --path /path/to/bevy/workspace --json
# Export as self-contained HTML
bevy-xray --path /path/to/bevy/workspace --html > output.html
# Use a different theme (rose-pine, moon, dawn)
bevy-xray --path /path/to/bevy/workspace --theme dawn| Flag | Description | Default |
|---|---|---|
--path |
Path to Bevy workspace root | . |
--json |
Export as JSON | — |
--html |
Export as self-contained HTML | — |
--theme |
Color theme: rose-pine, moon, dawn |
rose-pine |
| bevy_xray | bevy |
|---|---|
| 0.1 | 0.18 |
Note: bevy_xray uses static analysis using
syn, so it may need updates when Bevy introduces new API patterns.
crates/
├── bevy_xray/ # TUI application and CLI
└── bevy_xray_parser/ # Static analysis and parsing library
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.