@rpgjs/server 5.0.0-alpha.40 → 5.0.0-alpha.41

package/dist/RpgServer.d.ts

@@ -2,7 +2,7 @@ import { MapOptions } from './decorators/map';
 import { RpgPlayer, RpgEvent } from './Player/Player';
 import { RpgMap } from './rooms/map';
 import { RpgServerEngine } from './RpgServerEngine';
-import { WorldMapConfig, RpgShape } from '../../common/src';
+import { WorldMapConfig, RpgShape, MapPhysicsInitContext, MapPhysicsEntityContext } from '../../common/src';
 type RpgClassMap<T> = new () => T;
 type RpgClassEvent<T> = RpgEvent;
 type MatchMakerOption = any;
@@ -546,6 +546,44 @@ export interface RpgMapHooks {
      * ```
      */
     onLeave?: (player: RpgPlayer, map: RpgMap) => any;
+    /**
+     * Called when the map physics world is initialized.
+     *
+     * This hook runs each time `loadPhysic()` prepares the physics world, after static
+     * map hitboxes are created and before dynamic player/event bodies are hydrated.
+     *
+     * @param {RpgMap} map - The map instance
+     * @param {MapPhysicsInitContext} context - Physics initialization context
+     * @returns {any}
+     * @memberof RpgMapHooks
+     */
+    onPhysicsInit?: (map: RpgMap, context: MapPhysicsInitContext) => any;
+    /**
+     * Called when a dynamic character physics body is added to the map.
+     *
+     * @param {RpgMap} map - The map instance
+     * @param {MapPhysicsEntityContext} context - Added entity context
+     * @returns {any}
+     * @memberof RpgMapHooks
+     */
+    onPhysicsEntityAdd?: (map: RpgMap, context: MapPhysicsEntityContext) => any;
+    /**
+     * Called when a dynamic character physics body is removed from the map.
+     *
+     * @param {RpgMap} map - The map instance
+     * @param {MapPhysicsEntityContext} context - Removed entity context
+     * @returns {any}
+     * @memberof RpgMapHooks
+     */
+    onPhysicsEntityRemove?: (map: RpgMap, context: MapPhysicsEntityContext) => any;
+    /**
+     * Called when the map physics world is reset (before reload).
+     *
+     * @param {RpgMap} map - The map instance
+     * @returns {any}
+     * @memberof RpgMapHooks
+     */
+    onPhysicsReset?: (map: RpgMap) => any;
 }
 export interface RpgServer {
     /**

package/dist/index.js

@@ -16127,6 +16127,7 @@ class RpgCommonMap {
     }
     this.clearAll();
     this.moveManager.clearAll();
+    this.emitPhysicsReset();
     this.physicsAccumulatorMs = 0;
   }
   /**
@@ -16136,6 +16137,14 @@ class RpgCommonMap {
   clearAll() {
     const entities = this.physic.getEntities();
     for (const entity of entities) {
+      const owner = entity.owner;
+      if (owner) {
+        this.emitPhysicsEntityRemove({
+          owner,
+          entity,
+          kind: this.resolvePhysicsEntityKind(owner, entity.uuid)
+        });
+      }
       this.physic.removeEntity(entity);
     }
     this.physic.getMovementManager().clearAll();
@@ -16161,10 +16170,11 @@ class RpgCommonMap {
         this.addStaticHitbox(staticHitbox.id ?? generateShortUUID$1(), staticHitbox.points);
       }
     }
+    this.emitPhysicsInit({ mapData });
     this.playersSubscription = this.players.observable.subscribe(
       ({ value: player, type, key }) => {
         if (type === "remove") {
-          this.removeHitbox(key);
+          this.removeHitbox(key, player, "hero");
           return;
         }
         if (type == "reset") {
@@ -16204,7 +16214,7 @@ class RpgCommonMap {
         if (eventObj && typeof eventObj._movementUnsubscribe === "function") {
           eventObj._movementUnsubscribe();
         }
-        this.removeHitbox(key);
+        this.removeHitbox(key, event, "npc");
       } else if (type === "update") {
         event.id = event.id ?? key;
         if (!this.getBody(key)) {
@@ -16457,6 +16467,14 @@ class RpgCommonMap {
       isStatic: options?.isStatic,
       mass: options?.mass
     });
+    const entity = this.getBody(owner.id);
+    if (entity) {
+      this.emitPhysicsEntityAdd({
+        owner,
+        entity,
+        kind
+      });
+    }
   }
   updateCharacterHitbox(owner) {
     if (!owner?.id) return;
@@ -16497,6 +16515,32 @@ class RpgCommonMap {
     }
     return false;
   }
+  resolvePhysicsEntityKind(owner, id) {
+    if (typeof owner?.isEvent === "function") {
+      try {
+        if (owner.isEvent()) {
+          return "npc";
+        }
+      } catch {
+      }
+    }
+    const ownerId = typeof owner?.id === "string" ? owner.id : id;
+    if (ownerId && this.players()?.[ownerId]) {
+      return "hero";
+    }
+    if (ownerId && this.events()?.[ownerId]) {
+      return "npc";
+    }
+    return "generic";
+  }
+  emitPhysicsInit(_context) {
+  }
+  emitPhysicsEntityAdd(_context) {
+  }
+  emitPhysicsEntityRemove(_context) {
+  }
+  emitPhysicsReset() {
+  }
   withPhysicsSync(run) {
     this.physicsSyncDepth += 1;
     try {
@@ -16975,11 +17019,19 @@ class RpgCommonMap {
    * Remove a hitbox from the physics world
    * @private
    */
-  removeHitbox(id) {
+  removeHitbox(id, owner, kind) {
     const entity = this.physic.getEntityByUUID(id);
     if (!entity) {
       return false;
     }
+    const resolvedOwner = owner ?? entity.owner;
+    if (resolvedOwner) {
+      this.emitPhysicsEntityRemove({
+        owner: resolvedOwner,
+        entity,
+        kind: kind ?? this.resolvePhysicsEntityKind(resolvedOwner, id)
+      });
+    }
     this.physic.removeEntity(entity);
     return true;
   }
@@ -28001,6 +28053,18 @@ let RpgMap = class extends RpgCommonMap {
   onStart() {
     return BaseRoom.prototype.onStart.call(this);
   }
+  emitPhysicsInit(context2) {
+    this.hooks.callHooks("server-map-onPhysicsInit", this, context2).subscribe();
+  }
+  emitPhysicsEntityAdd(context2) {
+    this.hooks.callHooks("server-map-onPhysicsEntityAdd", this, context2).subscribe();
+  }
+  emitPhysicsEntityRemove(context2) {
+    this.hooks.callHooks("server-map-onPhysicsEntityRemove", this, context2).subscribe();
+  }
+  emitPhysicsReset() {
+    this.hooks.callHooks("server-map-onPhysicsReset", this).subscribe();
+  }
   isPositiveNumber(value) {
     return typeof value === "number" && Number.isFinite(value) && value > 0;
   }