@rpgjs/server 5.0.0-alpha.10 → 5.0.0-alpha.12

package/src/Player/Player.ts

@@ -14,8 +14,8 @@ import { MockConnection } from "@signe/room";
 import { IMoveManager, WithMoveManager } from "./MoveManager";
 import { IGoldManager, WithGoldManager } from "./GoldManager";
 import { WithVariableManager, type IVariableManager } from "./VariableManager";
-import { sync } from "@signe/sync";
-import { signal } from "@signe/reactive";
+import { createStatesSnapshot, load, sync, type } from "@signe/sync";
+import { computed, signal } from "@signe/reactive";
 import {
   IParameterManager,
   WithParameterManager,
@@ -117,6 +117,14 @@ export class RpgPlayer extends BasicPlayerMixins(RpgCommonPlayer) {
     (this as any).addParameter(AGI, AGI_CURVE);
     (this as any).allRecovery();
   }
+  
+  _onInit() {
+    this.hooks.callHooks("server-playerProps-load", this).subscribe();
+  }
+
+  get hooks() {
+    return inject<Hooks>(this.context as any, ModulesToken);
+  }
 
   async execMethod(method: string, methodData: any[] = [], target?: any) {
     let ret: any;
@@ -124,8 +132,7 @@ export class RpgPlayer extends BasicPlayerMixins(RpgCommonPlayer) {
       ret = await target[method](...methodData);
     }
     else {
-      const hooks = inject<Hooks>(this.context as any, ModulesToken);
-      ret = await lastValueFrom(hooks
+      ret = await lastValueFrom(this.hooks
         .callHooks(`server-player-${method}`, target ?? this, ...methodData));
     }
     this.syncChanges()
@@ -152,6 +159,7 @@ export class RpgPlayer extends BasicPlayerMixins(RpgCommonPlayer) {
     mapId: string,
     positions?: { x: number; y: number; z?: number } | string
   ): Promise<any | null | boolean> {
+    const room = this.getCurrentMap();
     this.emit("changeMap", {
       mapId: 'map-' + mapId,
       positions,
@@ -178,6 +186,19 @@ export class RpgPlayer extends BasicPlayerMixins(RpgCommonPlayer) {
     });
   }
 
+  async save() {
+    const snapshot = createStatesSnapshot(this)
+    await lastValueFrom(this.hooks.callHooks("server-player-onSave", this, snapshot))
+    return JSON.stringify(snapshot)
+  }
+
+  async load(snapshot: string) {
+    const data = JSON.parse(snapshot)
+    const dataLoaded = load(this, data)
+    await lastValueFrom(this.hooks.callHooks("server-player-onLoad", this, dataLoaded))
+    return dataLoaded
+  }
+
   /**
    * Set the current animation of the player's sprite
    * 
@@ -322,7 +343,7 @@ export class RpgPlayer extends BasicPlayerMixins(RpgCommonPlayer) {
    * });
    * ```
    */
-  showComponentAnimation(id: string, params: any) {
+  showComponentAnimation(id: string, params: any = {}) {
     const map = this.getCurrentMap();
     if (!map) return;
     map.$broadcast({
@@ -335,56 +356,30 @@ export class RpgPlayer extends BasicPlayerMixins(RpgCommonPlayer) {
     });
   }
 
-  /**
-   * Display a spritesheet animation on the player
-   * 
-   * This method displays a temporary visual animation using a spritesheet.
-   * The animation can either be displayed as an overlay on the player or replace
-   * the player's current graphic temporarily. This is useful for spell effects,
-   * transformations, or other visual feedback that uses predefined spritesheets.
-   * 
-   * @param graphic - The ID of the spritesheet to use for the animation
-   * @param animationName - The name of the animation within the spritesheet (default: 'default')
-   * @param replaceGraphic - Whether to replace the player's sprite with the animation (default: false)
-   * 
-   * @example
-   * ```ts
-   * // Show explosion animation as overlay on player
-   * player.showAnimation("explosion");
-   * 
-   * // Show specific spell effect animation
-   * player.showAnimation("spell-effects", "fireball");
-   * 
-   * // Transform player graphic temporarily with animation
-   * player.showAnimation("transformation", "werewolf", true);
-   * 
-   * // Show healing effect on player
-   * player.showAnimation("healing-effects", "holy-light");
-   * ```
-   */
-  showAnimation(graphic: string, animationName: string = 'default', replaceGraphic: boolean = false) {
-    if (replaceGraphic) {
-      this.setAnimation(animationName, 1);
-      return
-    }
-    this.showComponentAnimation("animation", {
-      graphic,
-      animationName,
-    });
-  }
-
   showHit(text: string) {
     this.showComponentAnimation("hit", {
       text,
       direction: this.direction(),
     });
   }
+
+  /**
+   * Set the sync schema for the map
+   * @param schema - The schema to set
+   */
+  setSync(schema: any) {
+    for (let key in schema) {
+      this[key] = type(signal(null), key, {
+        syncWithClient: schema[key]?.$syncWithClient,
+        persist: schema[key]?.$permanent,
+      }, this)
+    }
+  }
 }
 
 export class RpgEvent extends RpgPlayer {
   override async execMethod(methodName: string, methodData: any[] = [], instance = this) {
-    const hooks = inject<Hooks>(this.context as any, ModulesToken);
-    await lastValueFrom(hooks
+    await lastValueFrom(this.hooks
       .callHooks(`server-event-${methodName}`, instance, ...methodData));
     if (!instance[methodName]) {
       return;

package/src/index.ts

@@ -6,4 +6,6 @@ export * from "./core/inject";
 export * from "./Player/Player";
 export * from "./module";
 export * from "./rooms/map";
-export * from "./presets";
+export * from "./presets";
+export * from "@signe/reactive";
+export * from "./Gui";

package/src/module.ts

@@ -2,6 +2,7 @@ import { findModules, provideModules } from "@rpgjs/common";
 import { FactoryProvider } from "@signe/di";
 import { RpgServerEngine } from "./RpgServerEngine";
 import { RpgMap } from "./rooms/map";
+import { RpgPlayer } from "./Player/Player";
 
 export function provideServerModules(modules: any[]): FactoryProvider {
   return provideModules(modules, "server", (modules, context) => {
@@ -11,6 +12,16 @@ export function provideServerModules(modules: any[]): FactoryProvider {
       if ('server' in module) {
         module = module.server as any;
       }
+      if (module.player?.props) {
+        module = {
+          ...module,
+          playerProps: {
+            load: (player: RpgPlayer) => {
+              player.setSync(module.player.props)
+            },
+          }
+        };
+      }
       if (module.maps && Array.isArray(module.maps)) {
         const maps = [...module.maps];
         module = {

package/src/rooms/map.ts

@@ -1,7 +1,7 @@
 import { Action, MockConnection, Request, Room, RoomOnJoin } from "@signe/room";
 import { Hooks, IceMovement, ModulesToken, ProjectileMovement, ProjectileType, RpgCommonMap, ZoneData } from "@rpgjs/common";
 import { RpgPlayer, RpgEvent } from "../Player/Player";
-import { generateShortUUID, sync, users } from "@signe/sync";
+import { generateShortUUID, sync, type, users } from "@signe/sync";
 import { signal } from "@signe/reactive";
 import { inject } from "@signe/di";
 import { context } from "../core/context";;
@@ -80,6 +80,7 @@ export class RpgMap extends RpgCommonMap<RpgPlayer> implements RoomOnJoin {
     }, () => {
       player.animationName.set('stand')
     })
+    player._onInit()
     this.dataIsReady$.pipe(
       finalize(() => {
         this.hooks
@@ -270,6 +271,7 @@ export class RpgMap extends RpgCommonMap<RpgPlayer> implements RoomOnJoin {
 
     eventInstance.x.set(x);
     eventInstance.y.set(y);
+    if (event.name) eventInstance.name.set(event.name);
   
     this.events()[id] = eventInstance;
 
@@ -288,6 +290,14 @@ export class RpgMap extends RpgCommonMap<RpgPlayer> implements RoomOnJoin {
     return Object.values(this.events())
   }
 
+  getEventBy(cb: (event: RpgEvent) => boolean): RpgEvent | undefined {
+    return this.getEventsBy(cb)[0]
+  }
+
+  getEventsBy(cb: (event: RpgEvent) => boolean): RpgEvent[] {
+    return this.getEvents().filter(cb)
+  }
+
   removeEvent(eventId: string) {
     delete this.events()[eventId]
   }
@@ -371,9 +381,23 @@ export class RpgMap extends RpgCommonMap<RpgPlayer> implements RoomOnJoin {
       animationName,
     })
   }
+
+  /**
+   * Set the sync schema for the map
+   * @param schema - The schema to set
+   */
+  setSync(schema: any) {
+    for (let key in schema) {
+      this[key] = type(signal(null), key, {
+        syncWithClient: schema[key]?.$syncWithClient,
+        persist: schema[key]?.$permanent,
+      }, this)
+    }
+  }
 }
 
 export interface RpgMap {
   $send: (conn: MockConnection, data: any) => void; 
   $broadcast: (data: any) => void;
+  $sessionTransfer: (userOrPublicId: any | string, targetRoomId: string) => void;
 }