Bevy Material Wizard Plugin

A plugin for Bevy that enables lazy-loading of material definitions from .ron files. This plugin allows for easy deserialization of material configurations and provides functionality to override materials in GLTF files using a helper component.

Features

• Lazy Loading: Materials are loaded on-demand only when needed in a scene.
• RON-based Configuration: Define your materials in .ron files for easy customization.
• Material Overrides for GLTF: Replace default materials in GLTF models with custom materials using a helper component.
• UV Transformations: Supports scaling of UV coordinates via a uv_scale_factor in material definitions.

Installation

cargo add bevy_material_wizard

Usage

Defining Materials in RON

Create a .ron file defining your materials. For example:

MaterialDefinition(
    uv_scale_factor: 1.0,
    diffuse_color_tint: Some((1.0, 1.0, 1.0, 1.0)), // RGBA
    diffuse_texture: Some("textures/diffuse.png"),
    normal_texture: Some("textures/normal.png"),
    roughness: 0.8,
    metallic: 0.5,
    alpha_mode: Opaque //or AlphaBlend
)

Loading Materials

This plugin will automatically load all material definition ron files in the folder you specify as you initialize the plugin.

It will only load the textures on demand to more efficiently use resources.

Overriding GLTF Materials

Attach a helper component to entities to override their materials:

commands.entity(entity).insert(MaterialOverride {
    material_name: "custom_material".to_string(),
});

API Reference

BuiltMaterialsMap

A resource that manages material handles.

Methods

• find_or_load_material: Finds an existing material or loads a new one from the provided material definitions.

Material Definition RON Schema

Contributing

Contributions are welcome! Please open an issue or submit a pull request if you'd like to improve this plugin.

License

This project is licensed under the MIT License. See the LICENSE file for details.