@rpgjs/server 5.0.0-alpha.32 → 5.0.0-alpha.35

package/dist/Gui/ShopGui.d.ts

@@ -4,8 +4,12 @@ export type ShopSellList = Record<string, number> | Array<{
     id: string;
     multiplier: number;
 }>;
+export type ShopItemInput = string | {
+    id?: string;
+    [key: string]: any;
+};
 export interface ShopGuiOptions {
-    items: any[];
+    items: ShopItemInput[];
     sell?: ShopSellList;
     sellMultiplier?: number;
     message?: string;

package/dist/Player/ItemManager.d.ts

@@ -386,12 +386,13 @@ export interface IItemManager {
     /**
      * Equips a weapon or armor on a player
      *
-     * Think first to add the item in the inventory with the `addItem()` method before equipping the item.
+     * Think first to add the item in the inventory with the `addItem()` method before equipping the item,
+     * or pass `"auto"` to add the item if it is missing and equip it.
      *
      * The `onEquip()` method is called on the ItemClass when the item is equipped or unequipped.
      *
-     * @param itemClass - Item class or string identifier. If string, it's the item ID
-     * @param equip - Equip the item if `true`, unequip if `false` (default: `true`)
+     * @param itemId - Item identifier to resolve from the database
+     * @param equip - Equip the item if `true`, unequip if `false`, or `"auto"` to add then equip (default: `true`)
      * @throws {Object} ItemLog.notInInventory - If the item is not in the inventory
      *   - `id`: `ITEM_NOT_INVENTORY`
      *   - `msg`: Error message
@@ -404,19 +405,17 @@ export interface IItemManager {
      *
      * @example
      * ```ts
-     * import Sword from 'your-database/sword'
-     *
      * try {
-     *   player.addItem(Sword)
-     *   player.equip(Sword)
+     *   player.addItem('sword')
+     *   player.equip('sword')
      *   // Later, unequip it
-     *   player.equip(Sword, false)
+     *   player.equip('sword', false)
      * } catch (err) {
      *   console.log(err)
      * }
      * ```
      */
-    equip(itemClass: ItemClass | string, equip?: boolean): void;
+    equip(itemId: string, equip?: boolean | 'auto'): void;
     /**
      * Get the player's attack (sum of items equipped)
      *

package/dist/decorators/map.d.ts

@@ -1,3 +1,4 @@
+import { WeatherState } from '../../../common/src';
 export interface MapOptions {
     /**
      * Map identifier. Allows to go to the map (for example with player.changeMap())
@@ -96,6 +97,27 @@ export interface MapOptions {
      * @memberof MapData
      * */
     sounds?: string[];
+    /**
+     * Initial weather state for this map.
+     *
+     * This value is applied when the map is loaded and can later be updated
+     * at runtime with `map.setWeather()` from server logic.
+     *
+     * ```ts
+     * @MapData({
+     *   id: 'forest',
+     *   file: require('./tmx/forest.tmx'),
+     *   weather: {
+     *     effect: 'fog',
+     *     preset: 'rpgForestFog',
+     *     params: { density: 1.2, height: 0.75 },
+     *     transitionMs: 1200
+     *   }
+     * })
+     * class ForestMap extends RpgMap {}
+     * ```
+     */
+    weather?: WeatherState | null;
     /**
      * Whether to stop all sounds before playing the map sounds when a player joins.
      *