feat: 图块信息接口

packages-user/data-base/src/map/dynamicTile.ts

@@ -4,14 +4,18 @@ import {
     IDataCommon,
     IMoverController,
     IObjectMover,
-    IRoleFaceBinder
+    IRoleFaceBinder,
+    ITileRawData
 } from '@user/data-common';
 import { IDynamicLayer, IDynamicTile } from './types';
 import { DynamicTileMover } from './mover';
+import { logger } from '@motajs/common';
 
 export class DynamicTile implements IDynamicTile {
     readonly state: IDataCommon;
     readonly mover: IObjectMover<IDynamicTile>;
+
+    raw: ITileRawData | null;
     triggerType: number;
 
     /** 当前的朝向绑定对象 */
@@ -26,6 +30,13 @@ export class DynamicTile implements IDynamicTile {
         this.state = layer.state;
         this.mover = new DynamicTileMover(this);
         this.triggerType = -1;
+        const data = this.state.tileStore.getData(num);
+        if (!data) {
+            logger.warn(143, num.toString());
+            this.raw = null;
+        } else {
+            this.raw = data;
+        }
     }
 
     setFaceBinder(binder: IRoleFaceBinder | null): void {

packages-user/data-base/src/map/mapLayer.ts

@@ -1,6 +1,7 @@
 import { isNil } from 'lodash-es';
 import {
     IDynamicLayer,
+    ILayerLocation,
     ILayerState,
     IMapLayer,
     IMapLayerData,
@@ -55,6 +56,10 @@ export class MapLayer
         this.dynamicLayer = new DynamicLayer(this);
     }
 
+    inMap(x: number, y: number): boolean {
+        return x >= 0 && y >= 0 && x < this.width && y < this.height;
+    }
+
     /**
      * 在地图尺寸变化后重新映射手动触发器覆盖表
      */
@@ -150,15 +155,32 @@ export class MapLayer
     }
 
     getBlock(x: number, y: number): number {
-        if (x < 0 || y < 0 || x >= this.width || y >= this.height) {
-            // 不在地图内，返回 -1
+        if (!this.inMap(x, y)) {
             return -1;
         }
         return this.mapArray[y * this.width + x];
     }
 
+    getLocationData(x: number, y: number): ILayerLocation | null {
+        if (!this.inMap(x, y)) return null;
+        const index = y * this.width + x;
+        const num = this.mapArray[index];
+        const raw = this.state.tileStore.getData(num);
+        const dynamics = this.dynamicLayer.getDynamicTilesAt(x, y);
+        const trigger = this.triggerMap.get(index) ?? -1;
+
+        const data: ILayerLocation = {
+            tile: num,
+            raw,
+            trigger,
+            dynamics
+        };
+
+        return data;
+    }
+
     getTriggerType(x: number, y: number): number {
-        if (x < 0 || y < 0 || x >= this.width || y >= this.height) {
+        if (!this.inMap(x, y)) {
             return -1;
         }
         const index = y * this.width + x;
@@ -169,7 +191,7 @@ export class MapLayer
     }
 
     setTriggerType(type: number, x: number, y: number): void {
-        if (x < 0 || y < 0 || x >= this.width || y >= this.height) {
+        if (!this.inMap(x, y)) {
             return;
         }
         const index = y * this.width + x;
@@ -181,7 +203,7 @@ export class MapLayer
     }
 
     revertTrigger(x: number, y: number): void {
-        if (x >= 0 && y >= 0 && x < this.width && y < this.height) {
+        if (this.inMap(x, y)) {
             this.triggerMap.delete(y * this.width + x);
         }
     }

packages-user/data-base/src/map/types.ts

@@ -6,7 +6,8 @@ import {
     IObjectMovable,
     IObjectMover,
     IRoleFaceBinder,
-    ISaveableContent
+    ISaveableContent,
+    ITileRawData
 } from '@user/data-common';
 import { ITileStore } from '@user/data-common';
 
@@ -15,10 +16,21 @@ import { ITileStore } from '@user/data-common';
 export interface IMapLayerData {
     /** 当前引用是否过期，当地图图层内部的地图数组引用更新时，此项会变为 `true` */
     expired: boolean;
-    /** 地图图块数组，是对内部存储的直接引用 */
+    /** 地图图块数组，是对内部存储的直接引用，仅建议读取，不建议修改 */
     array: Uint32Array;
 }
 
+export interface ILayerLocation {
+    /** 该点的静态图块数字 */
+    readonly tile: number;
+    /** 该点的静态图块信息 */
+    readonly raw: ITileRawData | null;
+    /** 该点的静态触发器，-1 表示未设置（即使用图块本身的触发器），否则表示该点的静态触发器，覆盖图块本身的触发器 */
+    readonly trigger: number;
+    /** 该点包含的所有动态图块 */
+    readonly dynamics: Iterable<IDynamicTile>;
+}
+
 export interface IMapLayerHooks extends IHookBase {
     /**
      * 当地图大小发生变化时执行，如果调用了地图的 `resize` 方法，但是地图大小没变，则不会触发
@@ -91,6 +103,13 @@ export interface IMapLayer
     /** 此图层对应的动态图块图层，z 层级与静态图块一致 */
     readonly dynamicLayer: IDynamicLayer;
 
+    /**
+     * 判断指定坐标是否在地图内
+     * @param x 横坐标
+     * @param y 纵坐标
+     */
+    inMap(x: number, y: number): boolean;
+
     /**
      * 设置某一点的图块
      * @param block 图块数字
@@ -107,6 +126,13 @@ export interface IMapLayer
      */
     getBlock(x: number, y: number): number;
 
+    /**
+     * 获取指定点的所有图块信息
+     * @param x 横坐标
+     * @param y 纵坐标
+     */
+    getLocationData(x: number, y: number): ILayerLocation | null;
+
     /**
      * 获取指定点的静态图块对应的有效触发器类型，若手动覆盖不存在则回退到图块默认触发器
      * @param x 图块横坐标
@@ -512,21 +538,21 @@ export interface IDynamicLayerHooks extends IHookBase {
      * @param tile 被创建的动态图块
      * @param layer 所属的动态图层
      */
-    onCreateTile(tile: IDynamicTile, layer: IDynamicLayer): void;
+    onCreateTile?(tile: IDynamicTile, layer: IDynamicLayer): void;
 
     /**
      * 当图块被删除时触发
      * @param tile 被删除的动态图块
      * @param layer 所属的动态图层
      */
-    onDeleteTile(tile: IDynamicTile, layer: IDynamicLayer): Promise<void>;
+    onDeleteTile?(tile: IDynamicTile, layer: IDynamicLayer): Promise<void>;
 
     /**
      * 当更新动态图块的位置时触发（包括使用 `mover` 触发的移动）
      * @param tile 更新位置的图块
      * @param layer 所属的动态图层
      */
-    onUpdateTilePosition(tile: IDynamicTile, layer: IDynamicLayer): void;
+    onUpdateTilePosition?(tile: IDynamicTile, layer: IDynamicLayer): void;
 }
 
 export interface IDynamicLayer
@@ -613,6 +639,8 @@ export interface IDynamicTile extends IObjectMovable, IDataCommonExtended {
     readonly layer: IDynamicLayer;
     /** 当前动态图块的移动器 */
     readonly mover: IObjectMover<IDynamicTile>;
+    /** 当前动态图块的图块数据 */
+    readonly raw: ITileRawData | null;
 
     /**
      * 设置图块朝向，会一并修改 {@link num}，返回设置后的当前图块数字