https://github.com/dekirisu/bevy_gltf_trait

Customizable Bevy Engine GLTF loading through a trait
https://github.com/dekirisu/bevy_gltf_trait

bevy bevy-plugin gltf gltf-loader rust rust-lang

Last synced: 2 months ago
JSON representation

Customizable Bevy Engine GLTF loading through a trait

• Host: GitHub
• URL: https://github.com/dekirisu/bevy_gltf_trait
• Owner: dekirisu
• License: apache-2.0
• Created: 2024-07-07T17:48:38.000Z (6 months ago)
• Default Branch: master
• Last Pushed: 2024-07-08T18:19:16.000Z (6 months ago)
• Last Synced: 2024-09-27T07:03:20.556Z (3 months ago)
• Topics: bevy, bevy-plugin, gltf, gltf-loader, rust, rust-lang
• Language: Rust
• Homepage:
• Size: 504 KB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

        
Bevy glTF Trait



    

        

    

    

        

    



This is a fork of [bevy](https://github.com/bevyengine/bevy) `/crates/bevy_gltf`, that doesn't change any functionalities, but provides several possibilities to `customize` the conversion between gltf and bevy interns `on load` using the trait `GltfTrait`. 

# Trait Features

- set the extensions `default: &["gltf", "glb"]`

- Material:

    - change the `Material` used

    - or just edit the `StandardMaterial`s

- Meshes:

    - edit any `Mesh`

    - edit their `EntityWorldMut` (similar to `EntityCommands`)

    - edit the `Transform` and `EntityWorldMut` of their parent

- Lights:

    - edit their `SpotLight`, `PointLight` or `DirectionalLight` components

    - edit their `EntityWorldMut` 

    - edit the `Transform` and `EntityWorldMut` of their parent

- edit the `App`

# Notes

- If you want to insert components through the trait and they are foreign to bevy_gltf: 

    - Make sure to use `on_app` to `.register_type()` them

- the provided gltf structs make it possible to react to custom gltf properties

# Example

The original way of adding the plugin changes to:

```rust

fn main(){

    let mut app = App::new();

    app.add_plugins((

        MinimalPlugins,

        GltfPlugin::<()>::default(),

        // ...

    ));

    app.run();

}

```

..and can be modified with the trait to either **replace** or **extend** (using different extensions) scene imports.

```rust 

#[derive(Reflect,Default)]

struct WhiteGltf;

impl GltfTrait for WhiteGltf {

    const EXTENSIONS: &'static [&'static str] = &["myglb"];

    type Material = StandardMaterial;        

    fn convert_material (mut convert:GltfTraitMaterial) -> Self::Material {

        convert.material.base_color = Color::WHITE;

        convert.material.base_color_texture = None;

        convert.material

    }

}

fn main(){

    let mut app = App::new();

    app.add_plugins((

        DefaultPlugins,

        GltfPlugin::::default()

    ));

    app.run();

}

```

## Bevy support table

| bevy | bevy_gltf_trait |

|------|-----------|

| 0.14 | 0.1      |