Introduction
bevy_ecs_tiled
is a Bevy plugin for working with 2D tilemaps created with the Tiled map editor.
It relies upon:
- the official Tiled Rust bindings to load Tiled map files
- the
bevy_ecs_tilemap
crate to perform rendering
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 ! :)