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
77
78
79
80
81
82

//! Character `.char.ron` asset tests.
//!
//! `.char.ron` 角色资产测试。

#[path = "test_support.rs"]
mod test_support;

use souprune::{AnimationConfigAsset, CharacterAsset};

const CHAR_DIR: &str = "overworld/characters";
const CHAR_SUFFIX: &str = ".character.ron";

fn character_files() -> Vec<String> {
    let files = test_support::list_project_files_with_suffix(CHAR_DIR, CHAR_SUFFIX);
    assert!(
        !files.is_empty(),
        "No .character.ron files found under projects/example_mod/characters"
    );
    files
}

/// Ensure every `.char.ron` file can be deserialized.
///
/// 确保每个 `.char.ron` 文件都能反序列化成功。
#[test]
fn character_assets_deserialize() {
    for relative in character_files() {
        let asset: CharacterAsset = test_support::parse_project_ron(&relative);
        assert!(
            !asset.name.is_empty(),
            "character name should not be empty for {}",
            relative
        );
        assert!(
            asset.base_speed > 0.0,
            "character base_speed should be positive for {}",
            relative
        );
    }
}

/// Validate that referenced animation configs exist and parse.
///
/// 验证角色引用的动画配置存在且可解析。
#[test]
fn character_animation_configs_exist() {
    for relative in character_files() {
        let asset: CharacterAsset = test_support::parse_project_ron(&relative);
        test_support::ensure_project_asset(&asset.animation_config);
        let config: AnimationConfigAsset = test_support::parse_project_ron(&asset.animation_config);
        assert!(
            !config.states.is_empty(),
            "animation config {} used by {} should define states",
            asset.animation_config,
            relative
        );
    }
}

/// Rehearse collider logic by ensuring each collider encloses the sprite origin horizontally and remains below vertically.
///
/// 通过确认碰撞箱水平包裹角色原点且整体位于角色下方，预演碰撞逻辑。
#[test]
fn character_collider_bounds_cover_origin() {
    for relative in character_files() {
        let asset: CharacterAsset = test_support::parse_project_ron(&relative);
        let half = asset.collider_size * 0.5;
        let min = asset.collider_offset - half;
        let max = asset.collider_offset + half;

        assert!(
            min.x <= 0.0 && max.x >= 0.0,
            "collider must wrap X origin for {}",
            relative
        );
        assert!(
            max.y <= 0.0,
            "collider should sit below sprite pivot for {}",
            relative
        );
    }
}