KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

bevy_granite

★ 208 Open GitHub ↗

3D Editor for the Bevy Framework. Create, load, and save your 3d projects.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Bevy Granite

This crate provides a way to interactively create, edit, save, and load Bevy data in 3D.

> [!CAUTION]
> This is in early development and you will likely encounter bugs

![Screenshot](https://raw.githubusercontent.com/BlakeDarrow/bevy_granite/main/screenshots/Image_4.png)

# Start Here

<details>
<summary>Getting Started</summary>

Navigate to your projects Cargo.toml and add `bevy_granite`.

```rust
[dependencies]
bevy = "0.16.0"
bevy_granite = { git = "https://github.com/BlakeDarrow/bevy_granite", branch = "main" }
serde = "*"
```

There are 3 optional feature sets.
- Gizmos - Only loads needed content for gizmos. No editor or UI.
- Core - No Editor or Gizmos, just the bare bones needed to use our serial/deserial functions with macros and logging.
- Editor - The same as default features. Includes Gizmos, Core, and all Editor functionality.

## Examples

Next, check out the [examples](https://github.com/BlakeDarrow/bevy_granite/tree/main/examples) which showcase how you can setup a project. 
*Dungeon* provides a simple entry point file with code ready to start editing. Just make sure you copy over the relevant assets subfolder folder or you will get errors.

> If you clone this repo directly, you can use the example argument to launch straight into an example.
> 
> ```ps
> cargo run --release --example dungeon
> ```

---

</details>

# Support Table

| bevy | bevy_granite        |
| ---- | --------------------|
| 0.17 | 0.3.0 - 0.3.1       |
| 0.16 | 0.2.0 - 0.2.2       |
| 0.15 | None                |
| 0.14 | 0.1.0               |

# Features 
<details>
<summary>Features</summary>

### Scene Serialization

An entity is stored as three main parts:
- **Identity**: Contains the entity’s name, uuid, and type/class (such as Camera, Light, OBJ). This class data contains everything necessary to rebuild this bundle and any other adjacently relevant data. Not everything is currently available in classes.
- **Transform**: Describes the entity’s position, rotation, and scale. This determines where the entity is located and how it is oriented in the world.
- **Components**: (Optional) Holds additional data or behaviors attached to the entity. This is where you extend the entity’s functionality via the `#[granite_component]` macro.

A scene file contains metadata and a list of serializable entity data. Check out the [assets/scenes](https://github.com/BlakeDarrow/bevy_granite/tree/main/assets/scenes) for scene examples.

### Callable Events

While comprehensive documentation is currently unavailable, here are some helpful events you can use to interact with the editor while I write said documentation:

<details>
<summary>Events</summary>

#### Editor Control Events

- `RequestEditorToggle` - Toggle the editor UI on/off
- `RequestToggleCameraSync` - Toggle camera synchronization between editor and main camera

#### Entity Selection Events
- `RequestSelectEntityEvent` - Select an entity (additive for multi-selection)
- `RequestDeselectEntityEvent` - Deselect a specific entity
- `RequestDeselectAllEntitiesEvent` - Clear all entity selections
- `RequestCameraEntityFrame` - Frame the UI camera to focus on active entity

#### Entity Duplication Events
- `RequestDuplicateEntityEvent` - Duplicate a specific entity
- `RequestDuplicateAllSelectionEvent` - Duplicate all currently selected entities

#### Entity Hierarchy Events
- `RequestNewParent` - Request to set active as parent for selected entities
- `RequestRemoveParents` - Remove parent relationships from selected entities
- `RequestRemoveChildren` - Remove child relationships from selected entities

#### World Management Events
- `RequestSaveEvent` - Save the specific world
- `RequestLoadEvent` - Load a world from specified path
- `RequestReloadEvent` - Reload a world from specified path
- `WorldLoadSuccessEvent` - Event sent when world loading completes successfully
- `WorldSaveSuccessEvent` - Event sent when world saving completes successfully
- `RequestDespawnSerializableEntities` - Event to despawn all serializable entities
- `RequestDespawnBySource` - Event to despawn a specific source that is loaded

</details>

### Custom UI Callable Events

> Only Bevy Event unit structs are supported for UI button rendering.

With version 0.2.x, there is a new window that renders users buttons that are clickable. Create a struct that holds your events, and add `#[ui_callable_events]`. This will add all the events to the events window as clickable, and will dispatch said event in your struct.

Make sure to call  UI registration before the plugin gets initialized in your app if your using this. `DebugEvents::register_ui();`.

<details>
<summary>Example</summary>

```Rust
use crate::*;
#[derive(Event, Default)]
pub struct DebugRequestPlayer;

#[derive(Event, Default)]
pub struct DebugRequestRemovePlayer;

#[ui_callable_events] 
pub struct DebugEvents {
    pub spawn_player: DebugRequestPlayer,
    pub remove_player: DebugRequestRemovePlayer,
}

pub fn debug_callable_watcher(
    mut despawn: MessageReader<DebugRequestRemovePlayer>,
    mut spawn: MessageReader<DebugRequestPlayer>,
    mut commands: Commands,
    mut player_start: Query<(&GlobalTransform, &mut PlayerSpawner)>,
    mut world_state: ResMut<WorldState>,
) {
    for DebugRequestRemovePlayer in despawn.read() {
        commands.send_event(RequestDespawnBySource(PLAYER_PREFAB.to_string()));
    }

for DebugRequestPlayer in spawn.read() {
        spawn_player(&mut commands, &mut world_state, &mut player_start);
    }
}
```

![Screenshot](https://raw.githubusercontent.com/BlakeDarrow/bevy_granite/main/screenshots/Image_5.png)

</details>

---

</details>

# License

Bevy Granite is free and open source. Except when noted, all assets are licensed under either:

- MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

**Any contributions by you, shall be dual licensed as above, without any additional terms or conditions.**

# Contributors

# Additional Info

If you have any feedback, please reach out to me via a [GitHub issue](https://github.com/BlakeDarrow/bevy_granite/issues). I look forward to maintaining and improving this tool and am happy to hear y'alls opinions.

#### Special Thanks

- Noah
 - Silas
 - Ethan
 - Max

### Creator

- [@BlakeDarrow](https://www.youtube.com/@blakedarrow) on YouTube

<details>
<summary>Screenshots</summary>

![Screenshot](https://raw.githubusercontent.com/BlakeDarrow/bevy_granite/main/screenshots/Image_1.png)
![Screenshot](https://raw.githubusercontent.com/BlakeDarrow/bevy_granite/main/screenshots/Image_2.png)
![Screenshot](https://raw.githubusercontent.com/BlakeDarrow/bevy_granite/main/screenshots/Image_3.png)

</details>

bevy_granite

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README