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

package/dist/rooms/map.d.ts

@@ -1,5 +1,5 @@
 import { MockConnection, RoomMethods, RoomOnJoin } from '@signe/room';
-import { Hooks, RpgCommonMap, RpgShape, WorldMapsManager, WeatherState, WorldMapConfig } from '../../../common/src';
+import { Hooks, RpgCommonMap, RpgShape, MapPhysicsInitContext, MapPhysicsEntityContext, WorldMapsManager, WeatherState, WorldMapConfig } from '../../../common/src';
 import { RpgPlayer, RpgEvent } from '../Player/Player';
 import { BehaviorSubject } from 'rxjs';
 import { MapOptions } from '../decorators/map';
@@ -192,6 +192,10 @@ export declare class RpgMap extends RpgCommonMap<RpgPlayer> implements RoomOnJoi
     autoSync: boolean;
     constructor(room: any);
     onStart(): Promise<void>;
+    protected emitPhysicsInit(context: MapPhysicsInitContext): void;
+    protected emitPhysicsEntityAdd(context: MapPhysicsEntityContext): void;
+    protected emitPhysicsEntityRemove(context: MapPhysicsEntityContext): void;
+    protected emitPhysicsReset(): void;
     private isPositiveNumber;
     private resolveTrustedMapDimensions;
     private normalizeEventMode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rpgjs/server",
-  "version": "5.0.0-alpha.40",
+  "version": "5.0.0-alpha.42",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "publishConfig": {
@@ -11,9 +11,9 @@
   "license": "MIT",
   "description": "",
   "dependencies": {
-    "@rpgjs/common": "5.0.0-alpha.40",
-    "@rpgjs/physic": "5.0.0-alpha.40",
-    "@rpgjs/testing": "5.0.0-alpha.40",
+    "@rpgjs/common": "5.0.0-alpha.42",
+    "@rpgjs/physic": "5.0.0-alpha.42",
+    "@rpgjs/testing": "5.0.0-alpha.42",
     "@rpgjs/database": "^4.3.0",
     "@signe/di": "^2.8.3",
     "@signe/reactive": "^2.8.3",

package/src/RpgServer.ts

@@ -2,7 +2,7 @@ import { MapOptions } from "./decorators/map"
 import { RpgPlayer } from "./Player/Player"
 import { type RpgMap } from "./rooms/map"
 import { RpgServerEngine } from "./RpgServerEngine"
-import { WorldMapConfig, RpgShape } from "@rpgjs/common"
+import { WorldMapConfig, RpgShape, type MapPhysicsInitContext, type MapPhysicsEntityContext } from "@rpgjs/common"
 import { RpgEvent } from "./Player/Player"
 
 type RpgClassMap<T> = new () => T
@@ -579,6 +579,48 @@ 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/src/rooms/map.ts

@@ -1,5 +1,18 @@
 import { Action, MockConnection, Request, Room, RoomMethods, RoomOnJoin } from "@signe/room";
-import { Hooks, IceMovement, ModulesToken, ProjectileMovement, ProjectileType, RpgCommonMap, Direction, RpgCommonPlayer, RpgShape, findModules } from "@rpgjs/common";
+import {
+  Hooks,
+  IceMovement,
+  ModulesToken,
+  ProjectileMovement,
+  ProjectileType,
+  RpgCommonMap,
+  Direction,
+  RpgCommonPlayer,
+  RpgShape,
+  findModules,
+  type MapPhysicsInitContext,
+  type MapPhysicsEntityContext,
+} from "@rpgjs/common";
 import { WorldMapsManager, type WeatherState, type WorldMapConfig } from "@rpgjs/common";
 import { RpgPlayer, RpgEvent } from "../Player/Player";
 import { generateShortUUID, sync, type, users } from "@signe/sync";
@@ -279,6 +292,22 @@ export class RpgMap extends RpgCommonMap<RpgPlayer> implements RoomOnJoin {
     return BaseRoom.prototype.onStart.call(this)
   }
 
+  protected emitPhysicsInit(context: MapPhysicsInitContext): void {
+    this.hooks.callHooks("server-map-onPhysicsInit", this, context).subscribe();
+  }
+
+  protected emitPhysicsEntityAdd(context: MapPhysicsEntityContext): void {
+    this.hooks.callHooks("server-map-onPhysicsEntityAdd", this, context).subscribe();
+  }
+
+  protected emitPhysicsEntityRemove(context: MapPhysicsEntityContext): void {
+    this.hooks.callHooks("server-map-onPhysicsEntityRemove", this, context).subscribe();
+  }
+
+  protected emitPhysicsReset(): void {
+    this.hooks.callHooks("server-map-onPhysicsReset", this).subscribe();
+  }
+
   private isPositiveNumber(value: unknown): value is number {
     return typeof value === "number" && Number.isFinite(value) && value > 0;
   }