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 the dev branch! There's full of incomplete code and even errors in it! But the 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.

• Use more new features from bevy 0.13 (9-slices etc)
• Tiled Support (Algorithm stuff)
• Tilemap Serializing (Custom Binary Format)
• Volumetric Clouds / Fog
• SSAO
• Realtime Lighting
• Wang Tiling
• Tilemap Mask
• Frustum Culling
• Pathfinding
• Physics
• LDtk Support
• Infinite Tilemap
• Chunk Unloading
• Custom Material

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 mean 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 may be inaccurate!

LDtk

The gif on the right is the map generated with wave function collapse, and the orange boxes in the left image are procedurally 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. This means the whole algorithm will figure the path out in one frame. But since 0.2.1, the asynchronized one has been 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 functionality 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 many 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