#terrain #bevy #bevy-plugin #game-engine #voxel #heightmap #component

bevy_mesh_terrain

A simple and ergonomic heightmap terrain plugin for Bevy game engine

39 releases (6 breaking)

new 0.14.13 Oct 5, 2024
0.14.7 Sep 30, 2024
0.14.2 Jul 16, 2024
0.13.14 Mar 27, 2024
0.3.4 Sep 19, 2023

#443 in Game dev

Download history 4/week @ 2024-06-14 1/week @ 2024-06-28 13/week @ 2024-07-05 225/week @ 2024-07-12 25/week @ 2024-07-19 837/week @ 2024-07-26 59/week @ 2024-08-02 177/week @ 2024-08-23 148/week @ 2024-08-30 25/week @ 2024-09-06 8/week @ 2024-09-13 237/week @ 2024-09-20 234/week @ 2024-09-27

510 downloads per month

MIT license

160KB
2.5K SLoC

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).

image

image

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

creatinggames-preview

Dependencies

~50–86MB
~1.5M SLoC