bevy_ecs_ldtk 0.14.0

An ECS-friendly ldtk plugin for bevy.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

//! Provides [LdtkPlugin] and its scheduling-related dependencies.
use crate::{app, assets, components, resources, systems};
use bevy::{app::MainScheduleOrder, ecs::schedule::ScheduleLabel, prelude::*};

/// Schedule for processing this plugin's ECS API, inserted after [Update].
///
/// In particular, this set processes..
/// - [resources::LevelSelection]
/// - [components::LevelSet]
/// - [components::Worldly]
/// - [components::Respawn]
///
/// As a result, you can expect minimal frame delay when updating these in
/// [Update].
#[derive(Copy, Clone, Eq, PartialEq, Debug, Hash, ScheduleLabel)]
pub struct ProcessLdtkApi;

#[derive(Copy, Clone, Eq, PartialEq, Debug, Hash, SystemSet)]
enum ProcessApiSet {
    PreClean,
    Clean,
}

/// Adds the default systems, assets, and resources used by `bevy_ecs_ldtk`.
///
/// Add it to your [App] to gain LDtk functionality!
#[derive(Copy, Clone, Debug, Default)]
pub struct LdtkPlugin;

impl Plugin for LdtkPlugin {
    fn build(&self, mut app: &mut App) {
        // Check if we have added the TileMap plugin
        if !app.is_plugin_added::<bevy_ecs_tilemap::TilemapPlugin>() {
            app = app.add_plugins(bevy_ecs_tilemap::TilemapPlugin);
        }

        app.world_mut()
            .get_resource_mut::<MainScheduleOrder>()
            .expect("expected MainScheduleOrder to exist, try using DefaultPlugins")
            .insert_after(Update, ProcessLdtkApi);

        app.add_plugins(assets::LdtkAssetPlugin)
            .configure_sets(
                ProcessLdtkApi,
                (ProcessApiSet::PreClean, ProcessApiSet::Clean).chain(),
            )
            .init_non_send_resource::<app::LdtkEntityMap>()
            .init_non_send_resource::<app::LdtkIntCellMap>()
            .init_resource::<resources::LdtkSettings>()
            .add_message::<resources::LevelEvent>()
            .add_systems(
                PreUpdate,
                (systems::process_ldtk_assets, systems::process_ldtk_levels),
            )
            .add_systems(
                ProcessLdtkApi,
                (systems::apply_level_selection, systems::apply_level_set)
                    .chain()
                    .in_set(ProcessApiSet::PreClean),
            )
            .add_systems(
                ProcessLdtkApi,
                (ApplyDeferred, systems::clean_respawn_entities)
                    .chain()
                    .in_set(ProcessApiSet::Clean),
            )
            .add_systems(
                PostUpdate,
                (
                    systems::detect_level_spawned_events
                        .pipe(systems::fire_level_transformed_events),
                    systems::worldly_adoption.after(TransformSystems::Propagate),
                ),
            )
            .register_type::<components::LevelIid>()
            .register_type::<components::EntityIid>()
            .register_type::<components::GridCoords>()
            .register_type::<components::TileMetadata>()
            .register_type::<components::TileEnumTags>()
            .register_type::<components::LayerMetadata>();
    }
}