FAQ

What is the current status of the crate ?

While the crate is already definitely usable, it is still under active development.

Expect bugs and missing features !

I plan to follow semver and try to only break API upon new Bevy release.

What kind of maps are supported ?

Currently, we support :

  • orthogonal maps
  • (mostly) isometric "diamond" maps
  • hexagonal "flat-top" maps
  • hexagonal "pointy-top" maps

Isometric "diamond" maps currently have an issue with colliders not having the proper shape (see GH issue #32).

Isometric "staggered" maps are not supported at all (see GH issue #31).

Is it possible to automatically add physics colliders ?

Yes, see the dedicated guide.

We currently support both Avian and Rapier physics backend.

Is it possible to use Tiled "custom properties" ?

Yes, see the dedicated guide.

I'm using an isometric map and it seems all messed up!

Make sure you are actually using a "diamond" map and not a "staggered" one (which are not supported).

Also, for isometric maps, you may want to tweak the TilemapRenderSettings Component from bevy_ecs_tilemap. More information in the isometric maps example

How to enable map hot-reload ?

You need to enable Bevy file_watcher feature. bevy_ecs_tiled will then be able to automatically reload a map that was updated with Tiled.

I found a bug! What should I do ?

Please have a look to already openned issues and if it does not already exists, please fill a new one !

I want to add a new feature that's not yet in the crate!

Great news! Please have a look to the dedicated section