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 bevy 2d tilemap crate.

This repo is under maintenance as long as this message exists. ( Hope this message can bring you peace of mind. Yeah, that's childish :p )

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.

Future Goals

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

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

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.

Special Thanks & References

• SSAO & Volumetric Clouds / Fog inspired by this video.
• bevy_ecs_tilemap I took this crate as the reference and learnt the basis of bevy rendering!
• bevy_ecs_ldtk I was confused and have no idea about how to instantiate LDtk entities before I read this crate! I also learnt proc macros and many other things from this crate!

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 is not named following Semantic Versioning