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

//! Generic character animation system.
//!
//! 通用角色动画系统。

use crate::app_state::overworld::character::components::{StateIdle, StateRunning, StateWalking};
use crate::core::animation::components::{
    SpriteAnimationClip, SpriteAnimationCurrentFrame, SpriteAnimationTimer,
};
use crate::core::basic_components::Facing;
use crate::core::character_asset::{AnimationConfigAsset, CharacterAnimator};
use crate::core::sprite::params::SpriteParams;
use bevy::log::error;
use bevy::prelude::*;

/// Generic character animation system that works for any entity with CharacterAnimator.
///
/// 适用于任何具有 CharacterAnimator 的实体的通用角色动画系统。
pub(crate) fn character_animation_system(
    mut sprite_params: SpriteParams,
    anim_configs: Res<Assets<AnimationConfigAsset>>,
    mut query: Query<(
        &Facing,
        &CharacterAnimator,
        &mut Sprite,
        &mut SpriteAnimationClip,
        &mut SpriteAnimationCurrentFrame,
        &mut SpriteAnimationTimer,
        Option<&StateIdle>,
        Option<&StateWalking>,
        Option<&StateRunning>,
    )>,
) {
    for (facing, animator, mut sprite, mut clip, mut frame, mut timer, _idle, walking, running) in
        query.iter_mut()
    {
        let Some(config) = anim_configs.get(&animator.config) else {
            continue;
        };

        let state_name = if running.is_some() {
            "Run"
        } else if walking.is_some() {
            "Walk"
        } else {
            "Idle"
        };

        let Some(state_mapping) = config.states.get(state_name) else {
            continue;
        };

        let clip_name = state_mapping.get_clip_name(&facing.value);

        if clip.clip_name() != clip_name {
            let new_clip = match SpriteAnimationClip::new(
                &mut sprite_params.create_sprite_context(),
                &config.sprite_source,
                clip_name,
            ) {
                Ok(clip) => clip,
                Err(e) => {
                    error!(
                        "Failed to change animation to {}: {}. Using fallback.",
                        clip_name, e
                    );
                    SpriteAnimationClip::fallback(
                        &mut sprite_params.create_sprite_context(),
                        &config.sprite_source,
                        clip_name,
                    )
                }
            };

            frame.value = 0;
            timer.reset();
            *clip = new_clip;
            *sprite = clip.get_current_sprite().clone();
        }
    }
}