souprune 0.5.1

A game framework designed specifically for Deltarune / Undertale fangames.
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

//! # tilemap.rs
//!
//! # tilemap.rs 文件
//!
//! ## Module Overview
//!
//! ## 模块概述
//!
//! This module manages the overworld tilemap setup, initialization, and render ordering.
//!
//! 该模块管理 Overworld 瓦片地图的设置、初始化以及渲染顺序。
//!
//! ## Source File Overview
//!
//! ## 源文件概述
//!
//! The file implements `TilemapPlugin`, wiring systems for tiled map handling and object ordering relative to the player.
//!
//! 本文件实现了 `TilemapPlugin`，连接用于处理瓦片地图与相对玩家更新对象排序的系统。

use crate::app_state::AppState::Overworld;
use bevy::prelude::*;

#[cfg(feature = "experimental")]
pub mod beat;
pub mod object_properties;
#[cfg(feature = "experimental")]
pub mod reveal;
pub mod systems;

use crate::app_state::overworld::OverworldUpdate;
pub use object_properties::ObjectCollider;

#[derive(Resource, Default)]
pub struct CurrentMapBgm(pub Option<String>);

// ============================================================================
// BGM Handle Resources - Backend Specific
// ============================================================================
#[cfg(all(feature = "bevy_kira_audio", not(feature = "firewheel")))]
#[derive(Resource, Default)]
pub struct CurrentBgmHandle(pub Option<Handle<bevy_kira_audio::AudioInstance>>);

#[cfg(feature = "firewheel")]
#[derive(Resource, Default)]
pub struct CurrentBgmHandle(pub Option<Entity>);

pub(crate) struct TilemapPlugin;

impl Plugin for TilemapPlugin {
    fn build(&self, app: &mut App) {
        use systems::*;
        app.init_resource::<CurrentMapBgm>()
            .init_resource::<CurrentBgmHandle>()
            .add_systems(OnEnter(Overworld), setup_tilemap_system)
            .add_systems(
                Update,
                (
                    initialize_tilemap_system,
                    generate_collision_tiles_system,
                    setup_camera_bounds_system,
                    update_objects_order_with_player_system,
                    update_map_bgm_system,
                )
                    .in_set(OverworldUpdate),
            );

        // Add tile reveal effect plugin when experimental feature is enabled
        // 当启用 experimental feature 时添加瓦片揭示效果插件
        #[cfg(feature = "experimental")]
        {
            app.add_plugins(reveal::TileRevealPlugin);
            app.add_plugins(beat::BeatPlugin);
        }
    }
}