#perlin-noise #bevy #grayscale #maps #visibility #gpu #foliage

bevy_foliage_tool

A configurable foliage painting system using perlin noise, grayscale maps, and chunked visibility

5 releases

new 0.14.6 Sep 29, 2024
0.14.5 Sep 19, 2024
0.14.4 Sep 18, 2024
0.14.3 Aug 29, 2024
0.14.2 Aug 29, 2024

#817 in Game dev

Download history 261/week @ 2024-08-28 3/week @ 2024-09-04 2/week @ 2024-09-11 291/week @ 2024-09-18 175/week @ 2024-09-25

471 downloads per month

MIT license

1MB
1.5K SLoC

Bevy Foliage Tool

Description

A very bevy-centric foliage painting plugin that takes advantage of entities, components and systems as much as possible to be as easy to understand and interact with as possible.

Create, edit, save, load, render your foliage all with one tool. Built with GPU mesh+material instancing in mind. Supports multiple layers of foliage, each with any mesh + material provided by you. The provided grass shader is toon-colored and waves in the wind.

bevy-grass2

An example of the tool being used in the spirit_editor:

foliage_tool

Installing

cargo add bevy_foliage_tool

Run example

cargo run --example basic

Integration

In your main.rs :


    app 

    .add_plugins(BevyFoliageToolPlugin {

            foliage_config_path: "assets/foliage/foliage_config.ron".to_string()

        } ) 
        
   .add_plugins(BevyFoliageProtoPlugin )

   ;

Then make a system to load+register foliage assets: (for BevyFoliageProtoPlugin)



 app  .add_systems(Startup, register_foliage_assets) ;



 ...




fn register_foliage_assets(

    asset_server: Res <AssetServer>, 

    mut assets_resource: ResMut<FoliageAssetsResource>, 

    mut next_state: ResMut<NextState<FoliageAssetsState>>, 

) {


    let green_material: StandardMaterial = Color::srgb(0.4, 0.7, 0.6) .into();

    assets_resource.register_foliage_mesh("grass1", asset_server.load( "foliage/meshes/grass1.obj" ));

    assets_resource.register_foliage_material("standard_green", asset_server.add( green_material ));


    next_state.set( FoliageAssetsState::Loaded );
}



Then, define your foliage types : one for each layer

 (
    foliage_definitions: [

      //layer index 0 
        (
            name: "Grass",

            mesh_name: Some("grass1"),

            material_name: Some("standard_green")
            
           
        ),
        
        


	]
)

Do you like this crate? Support the creator on Patreon

https://www.patreon.com/infernaltoast

creatinggames-preview

Dependencies

~28MB
~528K SLoC