Introduction

bevy_ecs_tiled is a Bevy plugin for working with 2D tilemaps created with the Tiled map editor.

It relies upon:

Each tile or object is represented by a Bevy entity:

  • layers are children of the tilemap entity
  • tiles and objects are children of layers

Visibility and Transform are inherited: map -> layer -> tile / object


Disclaimer: both this book and the whole crate have been heavilly inspired by the bevy_ecs_ldtk crate, which is basically the equivalent of bevy_ecs_tiled but for the LDTK map editor. Thanks for the inspiration! :)


Purpose of this book

This book aims to give you a better understanding of how bevy_ecs_tiled works, what you can achieve with it and how you can do it.

It will focus on concepts, design concerns and basic tutorials. If you need an API reference, please have a look at the bevy_ecs_tiled API reference.

Finally, this book assume you already have some sort of knowledge about Bevy and Tiled map editor. There are already some good documentations available on these topics and some resources are referenced in the dedicated section.

Architecture of this book

This book is divided in several categories:

  • Design and explanation: how does the plugin work and why some technical choices have been made;
  • How-To's: in-depth tutorials about a specific aspect of the plugin;
  • Migration guides: migration guides for specific versions;
  • Miscellaneous: other topics that did not fit in other categories.

Good reading ! :)