bevy_ldtk
( Tileset from "Cavernas" by Adam Saltsman )
A Bevy plugin for loading LDtk tile maps.
Usage
use bevy::prelude::*;
use bevy_ldtk::*;
fn main() {
App::build()
.add_plugins(DefaultPlugins)
.add_plugin(LdtkPlugin)
.add_startup_system(setup.system())
.run();
}
fn setup(commands: &mut Commands, asset_server: Res<AssetServer>) {
commands
// Spawn a camera
.spawn(Camera2dBundle::default())
// Spawn a map bundle
.spawn(LdtkMapBundle {
// Specify the path to the map asset to load
map: asset_server.load("map1.ldtk"),
config: LdtkMapConfig {
// Automatically set the clear color to the LDtk background color
set_clear_color: true,
// You can specify a scale or leave it set to 1 for 1 to 1 pixel size
scale: 3.0,
// Set which level to load out of the map or leave it to 0 for the default level
level: 0,
// Tell the map to center around it's `Transform` instead of putting the top-left
// corner of the map at the origin `Transform`.
center_map: true,
},
..Default::default()
});
}
Layers
When the map layers are spawned, the bottommost layer is spawned at the transform coordinate of the LdtkMapBundle's Transform component. Each layer after the bottom layer is placed one unit higher on the Z axis. To have your sprites for players, etc. appear on top of the rendered map, their Z axis translation must be higher than the map transform + the layer number that you want it to appear above.
Bevy Versions
| Bevy Version | Plugin Version |
|---|---|
| 0.4 | 0.2, 0.3 |
| master | 0.3 with the bevy-unstable feature ( see below ) |
Using Bevy From Master
You can use this crate with Bevy master by adding a patch to your Cargo.toml and by adding the bevy-unstable feature to this crate:
[dependencies]
# Bevy version must be set to "0.4" and we will
# override it in the patch below.
bevy = "0.4"
bevy_ldtk = { version = "0.3", features = ["bevy-unstable"] }
[patch.crates-io]
bevy = { git = "https://github.com/bevyengine/bevy.git" }
Note that as Bevy master may or may not introduce breaking API changes, this crate may or may not compile when using the bevy-unstable feature.
Features
- An efficient renderer that only uses 4 vertices per map layer and lays out tiles on the GPU
- Supports hot reload through the Bevy asset server integration
- Heavily commented code to help others who want to see how to make their own tilemap renderers.
Caveats
The plugin is in relatively early stages, but it is still rather functional for many basic maps
- Many features are not supported yet:
- multiple overlapping autotile tiles
- tilemaps with spacing in them
- levels in separate files
- Occasionally some slight rendering artifacts between tiles. Not sure what causes those yet.
If you run into anything that isn't supported that you want to use in your game open an issue or PR to help prioritize what gets implemented.
License
Bevy LDtk is licensed under the Katharos License which places certain restrictions on what you are allowed to use it for. Please read and understand the terms before using Bevy LDtk for your project.
205 Jan 2, 2023
10 Oct 5, 2022
10 Jan 24, 2023
11 May 28, 2023
8 Nov 12, 2023
517 Dec 31, 2022
453 Jan 3, 2023
79 Nov 2, 2022
92 Dec 31, 2022
140 Dec 27, 2022
36 Dec 22, 2022
137 Dec 23, 2022
34 Nov 23, 2022
9 Aug 4, 2022
256 Dec 30, 2022
79 Jan 5, 2023