Bevy EntiTiles 🗺️

A 2d tilemap library for bevy. With many useful algorithms/tools built in.

Try to be the most comprehensive, performant, and up-to-date 2d tilemap crate for bevy.

This repo is under maintenance as long as this message exists!!

It's NOT recommended to use the code in dev branch! There's full of incomplete code and even errors! But master branch would be ok if you can't wait to try out new features.

This crate is largely inspired from bevy_ecs_tilemap(Rendering) and bevy_ecs_ldtk(LDtk entity spawning)

Future Goals

The higher the priority, the more towards the front in the following list.

• Tiled Support
• Runtime Mesh & Texture Baking
• Custom Material
• Volumetric Clouds / Fog
• SSAO
• Realtime Lighting
• Wang Tiling
• Tilemap Mask
• Frustum Culling
• Pathfinding
• Physics
• LDtk Support
• Infinite Tilemap
• Chunk Unloading
• Tilemap Serializing

Feature Flags

Coordinate Systems

The x and y axes in the tilemaps are the index axes. And those x and y on a single tile means the actual mesh size. Which you can control using tile_render_size.

legs here are mathematically incorrect, please consider it as a new concept.

Show Cases & Performance

Platform: 10600KF

Notice: Due to the performance overhead caused by the recorder, the fps value maybe inaccurate!

LDtk

The gif on the right is the map generated with wave function collapse. And the orange boxes in the left image is procedural generated colliders.

Bevy 0.12.1, crate 0.2.6, LDtk 1.4.1

Chunk Unloading

I know you are confused about these weird boxes, so please check the chunk_unloading example if you want to get further info.

Bevy 0.12.1, crate 0.2.7

Pathfinding

Notice this tests are done with synchronized pathfinding. Which means whole algorithm will figure the path out in one frame. But since 0.2.1, the asynchronized one in implemented. So the algorithm can complete a part of the pathfinding and continue it in the next frame. This will make it even smoother.

Notice: The synchronized pathfinding was removed in 0.3.0.

Column 1: Bevy 0.12.0, crate 0.2.1, using pathfinding example Column 2: Bevy 0.12.0, crate 0.3.0

Wave Function Collapse

In the following case, each tile has at least one corresponding color gap with its neighboring tiles.

Notice: The funtionality of visualizing the process of wfc was removed in 0.2.6

Column 1: Bevy 0.11.3, crate 0.2.0, NoneWeighted Column 2: Bevy 0.12, crate 0.2.1, NoneWeighted, max_retrace_factor = number in parentheses Column3: Bevy 0.12.1, crate 0.2.6, NoneWeighted, max_retrace_factor = number in parentheses

Limitations

• Supports up to 4 rendered layers* in one tilemap.

* Rendered layer means the layer that will be rendered. You can insert as much layers as you want, but only the 4 top layers will be rendered.

References

• SSAO & Volumetric Clouds / Fog inspired by this video.

Assets

• SunnyLand_by_Ansimuz-extended.png
• Cavernas_by_Adam_Saltsman.png

Versions

LDtk version is the version that json api has changed. So you can also use 1.5.2 in 0.2.7.See this for more information.

Versions before 0.3.0 are not named following Semantic Versioning