hytopia 0.10.20 → 0.10.22-prerelease

package/docs/server.chunklattice.initializeblocks.md

@@ -0,0 +1,56 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [ChunkLattice](./server.chunklattice.md) &gt; [initializeBlocks](./server.chunklattice.initializeblocks.md)
+
+## ChunkLattice.initializeBlocks() method
+
+Initialize all blocks in the lattice in bulk, removing all previously existing blocks. This is much more efficient than setting each block individually.
+
+**Signature:**
+
+```typescript
+initializeBlocks(blocks: {
+        [blockTypeId: number]: Vector3Like[];
+    }): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+blocks
+
+
+</td><td>
+
+{ \[blockTypeId: number\]: [Vector3Like](./server.vector3like.md)<!-- -->\[\]; }
+
+
+</td><td>
+
+The blocks to initialize.
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+void
+

package/docs/server.chunklattice.md

@@ -240,6 +240,20 @@ Check if a block exists at a specific global coordinate.
 Check if a chunk exists for a given global coordinate.
 
 
+</td></tr>
+<tr><td>
+
+[initializeBlocks(blocks)](./server.chunklattice.initializeblocks.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Initialize all blocks in the lattice in bulk, removing all previously existing blocks. This is much more efficient than setting each block individually.
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.persistencemanager.setglobaldata.md

@@ -9,7 +9,7 @@ Set global data in the data persistence service. This data is available and shar
 **Signature:**
 
 ```typescript
-setGlobalData(key: string, data: Record<string, unknown>): Promise<Record<string, unknown> | undefined>;
+setGlobalData(key: string, data: Record<string, unknown>): Promise<void>;
 ```
 
 ## Parameters
@@ -66,5 +66,5 @@ The data to set.
 
 **Returns:**
 
-Promise&lt;Record&lt;string, unknown&gt; \| undefined&gt;
+Promise&lt;void&gt;
 

package/docs/server.player.md

@@ -291,20 +291,6 @@ Joins a player to a world.
 Resets all inputs keys
 
 
-</td></tr>
-<tr><td>
-
-[scheduleNotification(type, scheduledFor)](./server.player.schedulenotification.md)
-
-
-</td><td>
-
-
-</td><td>
-
-Schedule a notification the player at a point in time in the future. This will automatically handle prompting a player (if necessary) for notification permissions in-game.
-
-
 </td></tr>
 <tr><td>
 
@@ -319,20 +305,6 @@ Schedule a notification the player at a point in time in the future. This will a
 Set the persisted data for the player. This data can later be retrieved using [Player.getPersistedData()](./server.player.getpersisteddata.md)<!-- -->, even if a player disconnects and rejoin a game in the future, or joins a different HYTOPIA managed lobby of your game.
 
 
-</td></tr>
-<tr><td>
-
-[unscheduleNotification(notificationId)](./server.player.unschedulenotification.md)
-
-
-</td><td>
-
-
-</td><td>
-
-Unschedules a scheduled notification for the player.
-
-
 </td></tr>
 </tbody></table>
 

package/docs/server.player.setpersisteddata.md

@@ -9,7 +9,7 @@ Set the persisted data for the player. This data can later be retrieved using [P
 **Signature:**
 
 ```typescript
-setPersistedData(data: Record<string, unknown>): Record<string, unknown>;
+setPersistedData(data: Record<string, unknown>): void;
 ```
 
 ## Parameters
@@ -50,7 +50,7 @@ The data to set.
 
 **Returns:**
 
-Record&lt;string, unknown&gt;
+void
 
 The persisted data for the player.
 

package/docs/server.playerevent.md

@@ -85,20 +85,6 @@ RECONNECTED\_WORLD
 </td><td>
 
 
-</td></tr>
-<tr><td>
-
-REQUEST\_NOTIFICATION\_PERMISSION
-
-
-</td><td>
-
-`"PLAYER.REQUEST_NOTIFICATION_PERMISSION"`
-
-
-</td><td>
-
-
 </td></tr>
 <tr><td>
 

package/docs/server.playereventpayloads.md

@@ -110,25 +110,6 @@ Emitted when a player leaves a world.
 Emitted when a player reconnects to a world after a unintentional disconnect.
 
 
-</td></tr>
-<tr><td>
-
-["PLAYER.REQUEST\_NOTIFICATION\_PERMISSION"](./server.playereventpayloads._player.request_notification_permission_.md)
-
-
-</td><td>
-
-
-</td><td>
-
-{ player: [Player](./server.player.md)<!-- -->; }
-
-
-</td><td>
-
-Emitted when notification permission is requested by a game.
-
-
 </td></tr>
 <tr><td>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hytopia",
-  "version": "0.10.20",
+  "version": "0.10.22-prerelease",
   "description": "The HYTOPIA SDK makes it easy for developers to create massively multiplayer games using JavaScript or TypeScript.",
   "type": "module",
   "main": "./server.mjs",

package/server.api.json

@@ -7527,6 +7527,63 @@
               "isAbstract": false,
               "name": "hasChunk"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "server!ChunkLattice#initializeBlocks:member(1)",
+              "docComment": "/**\n * Initialize all blocks in the lattice in bulk, removing all previously existing blocks. This is much more efficient than setting each block individually.\n *\n * @param blocks - The blocks to initialize.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "initializeBlocks(blocks: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "{\n        [blockTypeId: number]: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Vector3Like",
+                  "canonicalReference": "server!Vector3Like:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[];\n    }"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "blocks",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "initializeBlocks"
+            },
             {
               "kind": "Method",
               "canonicalReference": "server!ChunkLattice#setBlock:member(1)",
@@ -35386,16 +35443,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "<"
-                },
-                {
-                  "kind": "Reference",
-                  "text": "Record",
-                  "canonicalReference": "!Record:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": "<string, unknown> | undefined>"
+                  "text": "<void>"
                 },
                 {
                   "kind": "Content",
@@ -35405,7 +35453,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 6,
-                "endIndex": 10
+                "endIndex": 8
               },
               "releaseTag": "Public",
               "isProtected": false,
@@ -35782,75 +35830,6 @@
               "isAbstract": false,
               "name": "resetInputs"
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "server!Player#scheduleNotification:member(1)",
-              "docComment": "/**\n * Schedule a notification the player at a point in time in the future. This will automatically handle prompting a player (if necessary) for notification permissions in-game.\n *\n * @param type - The type of notification to schedule.\n *\n * @param scheduledFor - The point in time in the future to schedule the notification for.\n *\n * @returns The id of the notification if it was scheduled successfully, undefined otherwise.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "scheduleNotification(type: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", scheduledFor: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "number"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "Promise",
-                  "canonicalReference": "!Promise:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": "<string | void>"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 5,
-                "endIndex": 7
-              },
-              "releaseTag": "Public",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "type",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": false
-                },
-                {
-                  "parameterName": "scheduledFor",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 3,
-                    "endIndex": 4
-                  },
-                  "isOptional": false
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "scheduleNotification"
-            },
             {
               "kind": "Method",
               "canonicalReference": "server!Player#setPersistedData:member(1)",
@@ -35873,14 +35852,9 @@
                   "kind": "Content",
                   "text": "): "
                 },
-                {
-                  "kind": "Reference",
-                  "text": "Record",
-                  "canonicalReference": "!Record:type"
-                },
                 {
                   "kind": "Content",
-                  "text": "<string, unknown>"
+                  "text": "void"
                 },
                 {
                   "kind": "Content",
@@ -35890,7 +35864,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 4,
-                "endIndex": 6
+                "endIndex": 5
               },
               "releaseTag": "Public",
               "isProtected": false,
@@ -35940,59 +35914,6 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "server!Player#unscheduleNotification:member(1)",
-              "docComment": "/**\n * Unschedules a scheduled notification for the player.\n *\n * @param notificationId - The id of the notification returned from {@link Player.scheduleNotification}.\n *\n * @returns boolean - True if the notification was unscheduled, false otherwise.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "unscheduleNotification(notificationId: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "Promise",
-                  "canonicalReference": "!Promise:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": "<boolean>"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 5
-              },
-              "releaseTag": "Public",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "notificationId",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": false
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "unscheduleNotification"
-            },
             {
               "kind": "Property",
               "canonicalReference": "server!Player#username:member",
@@ -38977,27 +38898,6 @@
               "releaseTag": "Public",
               "name": "RECONNECTED_WORLD"
             },
-            {
-              "kind": "EnumMember",
-              "canonicalReference": "server!PlayerEvent.REQUEST_NOTIFICATION_PERMISSION:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "REQUEST_NOTIFICATION_PERMISSION = "
-                },
-                {
-                  "kind": "Content",
-                  "text": "\"PLAYER.REQUEST_NOTIFICATION_PERMISSION\""
-                }
-              ],
-              "initializerTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "releaseTag": "Public",
-              "name": "REQUEST_NOTIFICATION_PERMISSION"
-            },
             {
               "kind": "EnumMember",
               "canonicalReference": "server!PlayerEvent.REQUEST_SYNC:member",
@@ -39243,51 +39143,6 @@
                 "endIndex": 8
               }
             },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "server!PlayerEventPayloads#\"PLAYER.REQUEST_NOTIFICATION_PERMISSION\":member",
-              "docComment": "/**\n * Emitted when notification permission is requested by a game.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "["
-                },
-                {
-                  "kind": "Reference",
-                  "text": "PlayerEvent.REQUEST_NOTIFICATION_PERMISSION",
-                  "canonicalReference": "server!PlayerEvent.REQUEST_NOTIFICATION_PERMISSION:member"
-                },
-                {
-                  "kind": "Content",
-                  "text": "]: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "{\n        player: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "Player",
-                  "canonicalReference": "server!Player:class"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";\n    }"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "\"PLAYER.REQUEST_NOTIFICATION_PERMISSION\"",
-              "propertyTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 6
-              }
-            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "server!PlayerEventPayloads#\"PLAYER.REQUEST_SYNC\":member",

package/server.d.ts

@@ -994,6 +994,15 @@ export declare class ChunkLattice extends EventRouter {
      * @returns Whether the chunk exists.
      */
     hasChunk(globalCoordinate: Vector3Like): boolean;
+    /**
+     * Initialize all blocks in the lattice in bulk, removing
+     * all previously existing blocks. This is much more
+     * efficient than setting each block individually.
+     * @param blocks - The blocks to initialize.
+     */
+    initializeBlocks(blocks: {
+        [blockTypeId: number]: Vector3Like[];
+    }): void;
     /**
      * Set the block at a global coordinate by block type id, automatically
      * creating a chunk if it doesn't exist. Use block type id 0 for air (to remove a block).
@@ -4336,6 +4345,8 @@ export declare type PathfindingOptions = {
  */
 export declare class PersistenceManager {
     static readonly instance: PersistenceManager;
+    private _saveStatesClient;
+    private _playerData;
 
     /**
      * Get global data from the data persistence service.
@@ -4351,7 +4362,7 @@ export declare class PersistenceManager {
      * @param key - The key to set the data to.
      * @param data - The data to set.
      */
-    setGlobalData(key: string, data: Record<string, unknown>): Promise<Record<string, unknown> | undefined>;
+    setGlobalData(key: string, data: Record<string, unknown>): Promise<void>;
 
 
 }
@@ -4424,23 +4435,6 @@ export declare class Player extends EventRouter implements protocol.Serializable
      * @param world - The world to join the player to.
      */
     joinWorld(world: World): void;
-    /**
-     * Schedule a notification the player at a point in time in the future.
-     * This will automatically handle prompting a player (if necessary) for
-     * notification permissions in-game.
-     *
-     * @param type - The type of notification to schedule.
-     * @param scheduledFor - The point in time in the future to schedule the notification for.
-     * @returns The id of the notification if it was scheduled successfully, undefined otherwise.
-     */
-    scheduleNotification(type: string, scheduledFor: number): Promise<string | void>;
-    /**
-     * Unschedules a scheduled notification for the player.
-     *
-     * @param notificationId - The id of the notification returned from {@link Player.scheduleNotification}.
-     * @returns boolean - True if the notification was unscheduled, false otherwise.
-     */
-    unscheduleNotification(notificationId: string): Promise<boolean>;
 
 
     /**
@@ -4464,7 +4458,7 @@ export declare class Player extends EventRouter implements protocol.Serializable
      * @param data - The data to set.
      * @returns The persisted data for the player.
      */
-    setPersistedData(data: Record<string, unknown>): Record<string, unknown>;
+    setPersistedData(data: Record<string, unknown>): void;
 
 
 
@@ -4835,7 +4829,6 @@ export declare enum PlayerEvent {
     JOINED_WORLD = "PLAYER.JOINED_WORLD",
     LEFT_WORLD = "PLAYER.LEFT_WORLD",
     RECONNECTED_WORLD = "PLAYER.RECONNECTED_WORLD",
-    REQUEST_NOTIFICATION_PERMISSION = "PLAYER.REQUEST_NOTIFICATION_PERMISSION",
     REQUEST_SYNC = "PLAYER.REQUEST_SYNC"
 }
 
@@ -4861,10 +4854,6 @@ export declare interface PlayerEventPayloads {
         player: Player;
         world: World;
     };
-    /** Emitted when notification permission is requested by a game. */
-    [PlayerEvent.REQUEST_NOTIFICATION_PERMISSION]: {
-        player: Player;
-    };
     /** Emitted when a player's client requests a round trip time synchronization. */
     [PlayerEvent.REQUEST_SYNC]: {
         player: Player;