From 7a019f02f445d4e7b173ea33189544e380b4f181 Mon Sep 17 00:00:00 2001
From: unanmed <1319491857@qq.com>
Date: Sun, 23 Nov 2025 13:01:44 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E5=8B=87=E5=A3=AB=E5=8A=A8=E7=94=BB?=
 =?UTF-8?q?=E5=80=92=E5=BA=8F=E6=92=AD=E6=94=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../src/render/map/extension/hero.ts          | 23 ++++++++++++++++---
 .../src/render/map/extension/types.ts         |  8 ++++++-
 packages-user/data-state/src/hero/types.ts    |  7 ++++++
 3 files changed, 34 insertions(+), 4 deletions(-)

diff --git a/packages-user/client-modules/src/render/map/extension/hero.ts b/packages-user/client-modules/src/render/map/extension/hero.ts
index ef85b2b..fc7928f 100644
--- a/packages-user/client-modules/src/render/map/extension/hero.ts
+++ b/packages-user/client-modules/src/render/map/extension/hero.ts
@@ -2,6 +2,7 @@ import {
     degradeFace,
     FaceDirection,
     getFaceMovement,
+    HeroAnimateDirection,
     IHeroState,
     IHeroStateHooks,
     IMapLayer,
@@ -48,6 +49,8 @@ interface HeroRenderEntity {
     animateFrame: number;
     /** 移动的 `Promise`，移动完成时兑现，如果停止，则一直是兑现状态 */
     promise: Promise<void>;
+    /** 勇士移动的动画方向 */
+    animateDirection: HeroAnimateDirection;
 }
 
 export class MapHeroRenderer implements IMapHeroRenderer {
@@ -90,7 +93,8 @@ export class MapHeroRenderer implements IMapHeroRenderer {
             animateInterval: 0,
             lastAnimateTime: 0,
             animateFrame: 0,
-            promise: Promise.resolve()
+            promise: Promise.resolve(),
+            animateDirection: HeroAnimateDirection.Forward
         };
         this.heroEntity = heroEntity;
         this.entities.push(heroEntity);
@@ -163,7 +167,15 @@ export class MapHeroRenderer implements IMapHeroRenderer {
             }
             const dt = time - v.lastAnimateTime;
             if (dt > v.animateInterval) {
-                v.animateFrame++;
+                if (v.animateDirection === HeroAnimateDirection.Forward) {
+                    v.animateFrame++;
+                } else {
+                    v.animateFrame--;
+                    if (v.animateFrame < 0) {
+                        // 小于 0，则加上帧数的整数倍，就写个 10000 倍吧
+                        v.animateFrame += v.block.texture.frames * 10000;
+                    }
+                }
                 v.lastAnimateTime = time;
                 v.block.useSpecifiedFrame(v.animateFrame);
             }
@@ -351,7 +363,8 @@ export class MapHeroRenderer implements IMapHeroRenderer {
             animateInterval: 0,
             lastAnimateTime: 0,
             animateFrame: 0,
-            promise: Promise.resolve()
+            promise: Promise.resolve(),
+            animateDirection: HeroAnimateDirection.Forward
         };
         this.entities.push(entity);
     }
@@ -409,6 +422,10 @@ export class MapHeroRenderer implements IMapHeroRenderer {
         follower.block.setAlpha(alpha);
     }
 
+    setHeroAnimateDirection(direction: HeroAnimateDirection): void {
+        this.heroEntity.animateDirection = direction;
+    }
+
     destroy() {
         this.controller.unload();
     }
diff --git a/packages-user/client-modules/src/render/map/extension/types.ts b/packages-user/client-modules/src/render/map/extension/types.ts
index 04691a0..feeaa0c 100644
--- a/packages-user/client-modules/src/render/map/extension/types.ts
+++ b/packages-user/client-modules/src/render/map/extension/types.ts
@@ -1,5 +1,5 @@
 import { ITexture } from '@motajs/render-assets';
-import { FaceDirection } from '@user/data-state';
+import { FaceDirection, HeroAnimateDirection } from '@user/data-state';
 
 export interface IMapHeroRenderer {
     /**
@@ -82,6 +82,12 @@ export interface IMapHeroRenderer {
      */
     setFollowerAlpha(identifier: string, alpha: number): void;
 
+    /**
+     * 设置勇士移动的动画播放方向，一般后退会使用反向播放的动画，前进使用正向播放的动画
+     * @param direction 动画方向
+     */
+    setHeroAnimateDirection(direction: HeroAnimateDirection): void;
+
     /**
      * 摧毁这个勇士渲染拓展，释放相关资源
      */
diff --git a/packages-user/data-state/src/hero/types.ts b/packages-user/data-state/src/hero/types.ts
index 1dec755..4062b43 100644
--- a/packages-user/data-state/src/hero/types.ts
+++ b/packages-user/data-state/src/hero/types.ts
@@ -1,6 +1,13 @@
 import { IHookBase, IHookable } from '@motajs/common';
 import { FaceDirection } from '../common/types';
 
+export const enum HeroAnimateDirection {
+    /** 正向播放动画 */
+    Forward,
+    /** 反向播放动画 */
+    Backward
+}
+
 export interface IHeroFollower {
     /** 跟随者的图块数字 */
     readonly num: number;