Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ethereumdegen/bevy_mesh_terrain
https://github.com/ethereumdegen/bevy_mesh_terrain
Last synced: 5 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/ethereumdegen/bevy_mesh_terrain
- Owner: ethereumdegen
- License: mit
- Created: 2023-09-17T14:36:28.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-24T21:29:25.000Z (24 days ago)
- Last Synced: 2024-10-29T23:08:09.448Z (19 days ago)
- Language: Rust
- Size: 52.8 MB
- Stars: 54
- Watchers: 3
- Forks: 7
- Open Issues: 7
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
## Bevy Mesh Terrain
### Installing
```
cargo add bevy_mesh_terrain
```
### Bevy Versions
Terrain 0.6.x -> Bevy 0.12.x
Terrain 0.13.x -> Bevy 0.13.x
### Run example
```
cargo run --example basic
```
### Description
A very bevy-centric terrain plugin that takes advantage of entities, components and systems as much as possible to be as easy to understand and interact with as possible.
You spawn an entity and give it the 'TerrainConfig' and 'TerrainData' components, and then the plugin systems will spawn child entities which are each of the rendered chunks.
In this way, it works similarly to a voxel chunking system ( a la minecraft) except using heightfields (2d) instead of voxels (3d).
## Texture Types
*Height Map Texture*
The source of height ! This is a grayscale image in R16 format and if values are totally dead black then the shader will actually make alpha == 1 right there so you can blow holes in the terrain for caves and such (youll prob want to put rock doodads there to make it look nice!)
*Color/Diffuse Texture Array*
This is the source of the actual terrain textures. Up to 256 textures can be loaded in and painted with the splat map. So for example, grass, dirt, snow, and sand. You can edit that file of course for different looks.
*Splat Map Texture*
This is an RGBA control map texture for the diffuse texture array using a special data protocol. This is what you edit in a 'terrain editor' to paint your grass in one area, dirt in another area, snow on mountains, etc.
## Splat Map Texture Protocol
The splat map now supports up to 255 textures in a single material by using inspiration from 'Microsplat' documentation. The limitation is that only 2 textures can be blended together at any given pixel.
Splat map R channel - A float from 0.0 to 255.0 which is converted to an integer from 0-254 to specify the texture (of the 255) to use for this pixel on layer 0
Splat map G channel - A float from 0.0 to 255.0 which is converted to an integer from 0-254 to specify the texture (of the 255) to use for this pixel on layer 1
Splat map B channel - A float which is used to specify how much of the R channel layer to use here (0.0) versus how much of the G channel layer to use here (1.0).
Splat map A channel - not used.
### Sample textures
Sample textures from Lynoc (itch.io)
### Reference Shader Material
see https://github.com/bevyengine/bevy/blob/main/examples/shader/shader_material.rs
### Editor (WIP)
https://github.com/ethereumdegen/bevy_mesh_terrain_editor
### Do you like this crate? Support the creator on Patreon
https://www.patreon.com/infernaltoast
[](https://www.patreon.com/infernaltoast)