@cc-component/cc-pathfinding 1.1.0 → 1.1.1

package/assets/pathfinding/Interface.ts

@@ -4,6 +4,7 @@ import { AttackDistance } from "./base/Common";
 import { MapBoxView } from "./base/MapBoxView";
 import { Component } from "cc";
 import { Node } from "cc";
+import { GridTweenFactory } from "./base/GridMovementController";
 
 declare module "cc" {
 
@@ -56,7 +57,12 @@ declare global {
 
         //#region 移动控制
         /** 内部创建并绑定移动控制器 */
-        export function InitMovementController(scheduler: Component, options?: { retryDelay?: number; moveDuration?: number }): void
+        export function InitMovementController(scheduler: Component, options?: { retryDelay?: number; moveDuration?: number; tweenFactory?: GridTweenFactory }): void
+        /**
+         * 注入自定义 tween 实现（比如换成项目自己的动画系统）
+         * @param factory 传 null 或从未调用时，自动使用 cc 自带 tween
+         */
+        export function SetTweenFactory(factory: GridTweenFactory | null): void
         /**
          * 设置单位位置
          * @param useBottomPosition false（默认）用格子中心 GetMapPosition，

package/assets/pathfinding/base/GridMovementController.ts

@@ -4,11 +4,31 @@ import { Cell } from './GridMap';
 import { PathGridStateManager } from './PathGridStateManager';
 import { PathfindingModule } from './PathfindingModule';
 
+/** 外部 tween 对象需要满足的最小接口（与 cc.Tween 用法一致） */
+export interface GridTween {
+    to(duration: number, props: object): GridTween;
+    call(callback: () => void): GridTween;
+    start(): GridTween;
+}
+
+/**
+ * tween 工厂：外部注入后，移动控制器用它创建/停止 tween。
+ * 未注入（null）时自动使用 cc 自带的 tween。
+ */
+export interface GridTweenFactory {
+    /** 创建一个绑定在 target 上的 tween */
+    tween(target: Node): GridTween;
+    /** 停止 target 上的所有 tween */
+    stopAllByTarget(target: Node): void;
+}
+
 export interface GridMovementOptions {
     /** 每次重试前的等待时间，单位秒 */
     retryDelay?: number;
     /** 单格移动动画时长，单位秒 */
     moveDuration?: number;
+    /** 自定义 tween 实现，不传则用 cc 自带 tween */
+    tweenFactory?: GridTweenFactory;
 }
 
 /**
@@ -23,14 +43,22 @@ export class GridMovementController {
     private readonly movementOwners = new Map<Node, symbol>();
     private readonly movementRetryCallbacks = new Map<Node, () => void>();
     private readonly positions = new Map<Node, Cell>();
+    /** 未注入外部实现时使用的系统 tween */
+    private static readonly SYSTEM_TWEEN_FACTORY: GridTweenFactory = {
+        tween: (target: Node) => tween(target),
+        stopAllByTarget: (target: Node) => Tween.stopAllByTarget(target),
+    };
+
     private readonly retryDelay: number;
     private readonly moveDuration: number;
     private readonly pathState: PathGridStateManager;
+    private customTweenFactory: GridTweenFactory | null;
 
     constructor(private readonly scheduler: Component, options: GridMovementOptions = {}) {
         // 允许外部按场景调整重试间隔和动画时长，默认值保持兼容。
         this.retryDelay = options.retryDelay ?? 1;
         this.moveDuration = options.moveDuration ?? 0.5;
+        this.customTweenFactory = options.tweenFactory ?? null;
         this.pathState = new PathGridStateManager({
             isOccupied: (row, col) => PathfindingModule.IsOccupied(row, col),
             occupy: (row, col) => PathfindingModule.OccupyNode(row, col, true),
@@ -38,6 +66,16 @@ export class GridMovementController {
         });
     }
 
+    /** 注入自定义 tween 实现，传 null 恢复使用 cc 自带 tween */
+    setTweenFactory(factory: GridTweenFactory | null): void {
+        this.customTweenFactory = factory ?? null;
+    }
+
+    /** 外部注入优先，取不到就回退到 cc 自带 tween */
+    private get tweenFactory(): GridTweenFactory {
+        return this.customTweenFactory ?? GridMovementController.SYSTEM_TWEEN_FACTORY;
+    }
+
     /**
      * 设定单位当前格子，并同步到节点世界坐标。
      * useBottomPosition：false（默认）对齐格子中心，true 对齐格子底部。
@@ -84,7 +122,7 @@ export class GridMovementController {
 
     /** 强制中止当前移动，可选择保留当前格子的临时占用。 */
     cancel(playerNode: Node, preserveCurrent = false): void {
-        Tween.stopAllByTarget(playerNode);
+        this.tweenFactory.stopAllByTarget(playerNode);
         this.clearPathfindingRetry(playerNode);
         this.clearMovementRetry(playerNode);
 
@@ -110,7 +148,7 @@ export class GridMovementController {
         this.movementVersions.clear();
         this.movementOwners.forEach((owner, playerNode) => {
             this.pathState.release(owner);
-            Tween.stopAllByTarget(playerNode);
+            this.tweenFactory.stopAllByTarget(playerNode);
         });
         this.movementOwners.clear();
 
@@ -200,7 +238,7 @@ export class GridMovementController {
                 return;
             }
 
-            tween(playerNode)
+            this.tweenFactory.tween(playerNode)
                 .to(duration, { worldPosition: this.resolveCellPosition(next, useBottomPosition) })
                 .call(() => {
                     this.pathState.completeMove(previous, next, owner, shareToken);

package/assets/pathfinding/base/PathfindingModule.ts

@@ -4,7 +4,7 @@ import { Vec3 } from 'cc';
 import { MapViewModel } from './MapViewModel';
 import { Color } from 'cc';
 import { AttackDistance } from './Common';
-import { GridMovementController } from './GridMovementController';
+import { GridMovementController, GridTweenFactory } from './GridMovementController';
 const { ccclass, property } = _decorator;
 
 @ccclass('PathfindingModule')
@@ -27,12 +27,20 @@ export class PathfindingModule {
         this.movementController = controller;
     }
 
-    static InitMovementController(scheduler: Component, options?: { retryDelay?: number; moveDuration?: number }): void {
+    static InitMovementController(scheduler: Component, options?: { retryDelay?: number; moveDuration?: number; tweenFactory?: GridTweenFactory }): void {
         if (!this.movementController) {
             this.movementController = new GridMovementController(scheduler, options);
         }
     }
 
+    /**
+     * 注入自定义 tween 实现（比如换成项目自己的动画系统）。
+     * 传 null 或从未调用时，自动使用 cc 自带 tween。
+     */
+    static SetTweenFactory(factory: GridTweenFactory | null): void {
+        this.movementController?.setTweenFactory(factory);
+    }
+
     /**
      * 设置单位所在格子，并同步节点世界坐标。
      * useBottomPosition：false（默认）用格子中心 GetMapPosition，true 用格子底部 bottom_positon。

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cc-component/cc-pathfinding",
-    "version": "1.1.0",
+    "version": "1.1.1",
     "engine": ">=3.8.6",
     "description": "系统组件添加常用扩展方法",
     "main": "index.ts",