hytopia 0.2.3 → 0.2.5-dev.1

package/examples/zombies-fps/assets/models/players/.optimized/soldier-player/soldier-player.gltf.md5

@@ -0,0 +1 @@
+59f0afda681124b5e1c0c9e9287aec58c511ee9ed94e1916f29b3623fcb24055

package/examples/zombies-fps/assets/models/projectiles/.optimized/bullet-trace/bullet-trace.gltf

@@ -0,0 +1,136 @@
+{
+  "asset": {
+    "generator": "glTF-Transform v4.1.1",
+    "version": "2.0"
+  },
+  "accessors": [
+    {
+      "type": "SCALAR",
+      "componentType": 5123,
+      "count": 36,
+      "bufferView": 0,
+      "byteOffset": 0
+    },
+    {
+      "type": "VEC3",
+      "componentType": 5126,
+      "count": 24,
+      "max": [
+        0,
+        0.0625,
+        3.5625
+      ],
+      "min": [
+        -0.0625,
+        0,
+        -0.0625
+      ],
+      "bufferView": 1,
+      "byteOffset": 0
+    },
+    {
+      "type": "VEC3",
+      "componentType": 5126,
+      "count": 24,
+      "bufferView": 1,
+      "byteOffset": 12
+    },
+    {
+      "type": "VEC2",
+      "componentType": 5126,
+      "count": 24,
+      "bufferView": 1,
+      "byteOffset": 24
+    }
+  ],
+  "bufferViews": [
+    {
+      "buffer": 0,
+      "byteOffset": 0,
+      "byteLength": 72,
+      "target": 34963
+    },
+    {
+      "buffer": 0,
+      "byteOffset": 72,
+      "byteLength": 768,
+      "byteStride": 32,
+      "target": 34962
+    }
+  ],
+  "samplers": [
+    {
+      "magFilter": 9728,
+      "minFilter": 9728,
+      "wrapS": 33071,
+      "wrapT": 33071
+    }
+  ],
+  "textures": [
+    {
+      "source": 0,
+      "sampler": 0
+    }
+  ],
+  "images": [
+    {
+      "mimeType": "image/png",
+      "uri": "baseColor.png"
+    }
+  ],
+  "buffers": [
+    {
+      "uri": "bullet-trace.bin",
+      "byteLength": 840
+    }
+  ],
+  "materials": [
+    {
+      "alphaMode": "MASK",
+      "alphaCutoff": 0.05,
+      "doubleSided": true,
+      "pbrMetallicRoughness": {
+        "metallicFactor": 0,
+        "baseColorTexture": {
+          "index": 0
+        }
+      }
+    }
+  ],
+  "meshes": [
+    {
+      "primitives": [
+        {
+          "attributes": {
+            "POSITION": 1,
+            "NORMAL": 2,
+            "TEXCOORD_0": 3
+          },
+          "mode": 4,
+          "material": 0,
+          "indices": 0
+        }
+      ]
+    }
+  ],
+  "nodes": [
+    {
+      "name": "cube",
+      "translation": [
+        0,
+        0,
+        -1.75
+      ],
+      "mesh": 0
+    }
+  ],
+  "scenes": [
+    {
+      "name": "blockbench_export",
+      "nodes": [
+        0
+      ]
+    }
+  ],
+  "scene": 0
+}

package/examples/zombies-fps/assets/models/projectiles/.optimized/bullet-trace/bullet-trace.gltf.md5

@@ -0,0 +1 @@
+c74848409426988ed22402cb4f3a3581ca3ca3dfb5e857071ccac927b75da478

package/examples/zombies-fps/classes/GameManager.ts

@@ -45,7 +45,9 @@ export default class GameManager {
   }
 
   public checkEndGame() {
-    clearTimeout(this._endGameTimeout);
+    if (this._endGameTimeout !== undefined) {
+      return;
+    }
 
     this._endGameTimeout = setTimeout(() => {
       if (!this.world) return;
@@ -63,6 +65,8 @@ export default class GameManager {
       if (allPlayersDowned) {
         this.endGame();
       }
+
+      this._endGameTimeout = undefined;
     }, 1000);
   }
 
@@ -215,6 +219,9 @@ export default class GameManager {
 
     this._enemySpawnTimeout = setTimeout(() => this._spawnLoop(), nextSpawn);
     this.waveDelay = 0;
+
+    // Check end game conditions.
+    this.checkEndGame();
   }
 
   private _waveLoop() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hytopia",
-  "version": "0.2.3",
+  "version": "0.2.5-dev.1",
   "description": "The HYTOPIA SDK makes it easy for developers to create massively multiplayer games using JavaScript or TypeScript.",
   "main": "server.js",
   "bin": {
@@ -40,6 +40,9 @@
     "roblox",
     "recroom"
   ],
+  "dependencies": {
+    "@gltf-transform/cli": "^4.1.1"
+  },
   "author": "HYTOPIA, Inc.",
   "license": "SEE LICENSE IN LICENSE.md",
   "types": "./server.d.ts",

package/server.api.json

@@ -17578,12 +17578,12 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "server!Matrix2#frobeniusNormal:member",
+              "canonicalReference": "server!Matrix2#frobeniusNorm:member",
               "docComment": "/**\n * The frobenius normal of the matrix.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get frobeniusNormal(): "
+                  "text": "get frobeniusNorm(): "
                 },
                 {
                   "kind": "Content",
@@ -17597,7 +17597,7 @@
               "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Public",
-              "name": "frobeniusNormal",
+              "name": "frobeniusNorm",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -18548,12 +18548,12 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "server!Matrix3#frobeniusNormal:member",
-              "docComment": "/**\n * The frobenius normal of the matrix.\n */\n",
+              "canonicalReference": "server!Matrix3#frobeniusNorm:member",
+              "docComment": "/**\n * The frobenius norm of the matrix.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get frobeniusNormal(): "
+                  "text": "get frobeniusNorm(): "
                 },
                 {
                   "kind": "Content",
@@ -18567,7 +18567,7 @@
               "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Public",
-              "name": "frobeniusNormal",
+              "name": "frobeniusNorm",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -18778,7 +18778,7 @@
             {
               "kind": "Method",
               "canonicalReference": "server!Matrix3.fromTranslation:member(1)",
-              "docComment": "/**\n * Creates a new `Matrix3` instance from a translation of identity matrix.\n *\n * @param translation - The translation of the matrix.\n *\n * @returns A new `Matrix3` instance.\n */\n",
+              "docComment": "/**\n * Creates a new `Matrix3` instance from a translation of identity matrix. This is used only when working with two-dimensional homogeneous coordinates, which is why the `translation` parameter is a `Vector2`.\n *\n * @param translation - The translation of the matrix.\n *\n * @returns A new `Matrix3` instance.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -18786,8 +18786,8 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "Vector3",
-                  "canonicalReference": "server!Vector3:class"
+                  "text": "Vector2",
+                  "canonicalReference": "server!Vector2:class"
                 },
                 {
                   "kind": "Content",
@@ -18991,7 +18991,7 @@
             {
               "kind": "Method",
               "canonicalReference": "server!Matrix3#projection:member(1)",
-              "docComment": "/**\n * Sets the current matrix to a projection matrix with the given bounds.\n *\n * @param width - The width of the projection.\n *\n * @param height - The height of the projection.\n *\n * @returns The current matrix.\n */\n",
+              "docComment": "/**\n * Sets the current matrix to a orthographic projection matrix with the given bounds.\n *\n * @param width - The width of the projection.\n *\n * @param height - The height of the projection.\n *\n * @returns The current matrix.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -19183,6 +19183,56 @@
               "isAbstract": false,
               "name": "toString"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "server!Matrix3#transformVector:member(1)",
+              "docComment": "/**\n * Multiplies the provided vector3 by this matrix. This modifies the vector in-place, but also returns the transformed vector.\n *\n * @param vector - The vector to multiply by this.\n *\n * @returns The transformed vector.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "transformVector(vector: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Vector3",
+                  "canonicalReference": "server!Vector3:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Vector3",
+                  "canonicalReference": "server!Vector3:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "vector",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "transformVector"
+            },
             {
               "kind": "Method",
               "canonicalReference": "server!Matrix3#transpose:member(1)",
@@ -19845,12 +19895,12 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "server!Matrix4#frobeniusNormal:member",
-              "docComment": "/**\n * The frobenius normal of the matrix.\n */\n",
+              "canonicalReference": "server!Matrix4#frobeniusNorm:member",
+              "docComment": "/**\n * The frobenius norm of the matrix.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get frobeniusNormal(): "
+                  "text": "get frobeniusNorm(): "
                 },
                 {
                   "kind": "Content",
@@ -19864,7 +19914,7 @@
               "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Public",
-              "name": "frobeniusNormal",
+              "name": "frobeniusNorm",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -20866,12 +20916,12 @@
             },
             {
               "kind": "Method",
-              "canonicalReference": "server!Matrix4#orthogonal:member(1)",
-              "docComment": "/**\n * Sets the current matrix to an orthogonal matrix with the given bounds.\n *\n * @param left - The left bound of the projection.\n *\n * @param right - The right bound of the projection.\n *\n * @param bottom - The bottom bound of the projection.\n *\n * @param top - The top bound of the projection.\n *\n * @param near - The near bound of the projection.\n *\n * @param far - The far bound of the projection.\n *\n * @returns The current matrix.\n */\n",
+              "canonicalReference": "server!Matrix4#orthographic:member(1)",
+              "docComment": "/**\n * Sets the current matrix to an orthographic projection matrix with the given bounds.\n *\n * @param left - The left bound of the frustum.\n *\n * @param right - The right bound of the frustum.\n *\n * @param bottom - The bottom bound of the frustum.\n *\n * @param top - The top bound of the frustum.\n *\n * @param near - The near bound of the frustum.\n *\n * @param far - The far bound of the frustum.\n *\n * @returns The current matrix.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "orthogonal(left: "
+                  "text": "orthographic(left: "
                 },
                 {
                   "kind": "Content",
@@ -20991,7 +21041,7 @@
               ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "orthogonal"
+              "name": "orthographic"
             },
             {
               "kind": "Method",
@@ -29284,6 +29334,56 @@
               "isAbstract": false,
               "name": "toString"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "server!Quaternion#transformVector:member(1)",
+              "docComment": "/**\n * Rotates the provided vector by the rotation this quaternion represents. This modifies the vector in-place, but also returns the rotated vector.\n *\n * @param vector - the vector to rotate\n *\n * @returns the rotated vector.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "transformVector(vector: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Vector3",
+                  "canonicalReference": "server!Vector3:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Vector3",
+                  "canonicalReference": "server!Vector3:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "vector",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "transformVector"
+            },
             {
               "kind": "Property",
               "canonicalReference": "server!Quaternion#w:member",
@@ -35999,56 +36099,6 @@
               "isAbstract": false,
               "name": "create"
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "server!Vector2#cross:member(1)",
-              "docComment": "/**\n * Calculates the cross product of the current vector and another vector.\n *\n * @param vector2 - The vector to calculate the cross product with.\n *\n * @returns The cross product of the two vector 2s as a vector3.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "cross(vector2: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "Vector2",
-                  "canonicalReference": "server!Vector2:class"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "Vector3",
-                  "canonicalReference": "server!Vector3:class"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
-              },
-              "releaseTag": "Public",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "vector2",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": false
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "cross"
-            },
             {
               "kind": "Method",
               "canonicalReference": "server!Vector2#distance:member(1)",
@@ -37943,6 +37993,55 @@
               "isAbstract": false,
               "name": "divide"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "server!Vector3#dot:member(1)",
+              "docComment": "/**\n * Returns the dot product of this vector and another vector.\n *\n * @param vector3 - the other vector\n *\n * @returns the dot product of this and vector3\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "dot(vector3: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Vector3",
+                  "canonicalReference": "server!Vector3:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "vector3",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "dot"
+            },
             {
               "kind": "Method",
               "canonicalReference": "server!Vector3#equals:member(1)",

package/server.d.ts

@@ -2135,7 +2135,7 @@ export declare class Matrix2 extends Float32Array {
     /** The determinant of the matrix. */
     get determinant(): number;
     /** The frobenius normal of the matrix. */
-    get frobeniusNormal(): number;
+    get frobeniusNorm(): number;
     /**
      * Creates a new `Matrix2` instance.
      *
@@ -2265,8 +2265,8 @@ export declare class Matrix3 extends Float32Array {
     constructor(m00: number, m01: number, m02: number, m10: number, m11: number, m12: number, m20: number, m21: number, m22: number);
     /** The determinant of the matrix. */
     get determinant(): number;
-    /** The frobenius normal of the matrix. */
-    get frobeniusNormal(): number;
+    /** The frobenius norm of the matrix. */
+    get frobeniusNorm(): number;
     /**
      * Creates a new `Matrix3` instance.
      *
@@ -2303,11 +2303,13 @@ export declare class Matrix3 extends Float32Array {
     static fromScaling(scale: Vector3): Matrix3;
     /**
      * Creates a new `Matrix3` instance from a translation of identity matrix.
+     * This is used only when working with two-dimensional homogeneous coordinates,
+     * which is why the `translation` parameter is a `Vector2`.
      *
      * @param translation - The translation of the matrix.
      * @returns A new `Matrix3` instance.
      */
-    static fromTranslation(translation: Vector3): Matrix3;
+    static fromTranslation(translation: Vector2): Matrix3;
     /**
      * Adds a matrix to the current matrix.
      *
@@ -2375,7 +2377,15 @@ export declare class Matrix3 extends Float32Array {
      */
     multiplyScalar(scalar: number): Matrix3;
     /**
-     * Sets the current matrix to a projection matrix with the given bounds.
+     * Multiplies the provided vector3 by this matrix. This modifies
+     * the vector in-place, but also returns the transformed vector.
+     *
+     * @param vector - The vector to multiply by this.
+     * @returns The transformed vector.
+     */
+    transformVector(vector: Vector3): Vector3;
+    /**
+     * Sets the current matrix to a orthographic projection matrix with the given bounds.
      *
      * @param width - The width of the projection.
      * @param height - The height of the projection.
@@ -2425,8 +2435,8 @@ export declare class Matrix4 extends Float32Array {
     constructor(m00: number, m01: number, m02: number, m03: number, m10: number, m11: number, m12: number, m13: number, m20: number, m21: number, m22: number, m23: number, m30: number, m31: number, m32: number, m33: number);
     /** The determinant of the matrix. */
     get determinant(): number;
-    /** The frobenius normal of the matrix. */
-    get frobeniusNormal(): number;
+    /** The frobenius norm of the matrix. */
+    get frobeniusNorm(): number;
     /**
      * Creates a new `Matrix4` instance.
      *
@@ -2598,17 +2608,17 @@ export declare class Matrix4 extends Float32Array {
      */
     multiplyScalar(scalar: number): Matrix4;
     /**
-     * Sets the current matrix to an orthogonal matrix with the given bounds.
+     * Sets the current matrix to an orthographic projection matrix with the given bounds.
      *
-     * @param left - The left bound of the projection.
-     * @param right - The right bound of the projection.
-     * @param bottom - The bottom bound of the projection.
-     * @param top - The top bound of the projection.
-     * @param near - The near bound of the projection.
-     * @param far - The far bound of the projection.
+     * @param left - The left bound of the frustum.
+     * @param right - The right bound of the frustum.
+     * @param bottom - The bottom bound of the frustum.
+     * @param top - The top bound of the frustum.
+     * @param near - The near bound of the frustum.
+     * @param far - The far bound of the frustum.
      * @returns The current matrix.
      */
-    orthogonal(left: number, right: number, bottom: number, top: number, near: number, far: number): Matrix4;
+    orthographic(left: number, right: number, bottom: number, top: number, near: number, far: number): Matrix4;
     /**
      * Sets the current matrix to a perspective matrix with the given field of view, aspect ratio, and near and far bounds.
      *
@@ -3646,6 +3656,14 @@ export declare class Quaternion extends Float32Array implements QuaternionLike {
      * @returns The current quaternion.
      */
     multiply(quaternion: Quaternion): Quaternion;
+    /**
+     * Rotates the provided vector by the rotation this quaternion represents.
+     * This modifies the vector in-place, but also returns the rotated vector.
+     *
+     * @param vector - the vector to rotate
+     * @returns the rotated vector.
+     */
+    transformVector(vector: Vector3): Vector3;
     /**
      * Normalizes the quaternion.
      *
@@ -4562,13 +4580,6 @@ export declare class Vector2 extends Float32Array implements Vector2Like {
      * @returns The current vector.
      */
     copy(vector2: Vector2): Vector2;
-    /**
-     * Calculates the cross product of the current vector and another vector.
-     *
-     * @param vector2 - The vector to calculate the cross product with.
-     * @returns The cross product of the two vector 2s as a vector3.
-     */
-    cross(vector2: Vector2): Vector3;
     /**
      * Calculates the distance between the current vector and another vector.
      *
@@ -4837,6 +4848,13 @@ export declare class Vector3 extends Float32Array implements Vector3Like {
      * @returns The current vector.
      */
     divide(vector3: Vector3): Vector3;
+    /**
+     * Returns the dot product of this vector and another vector.
+     *
+     * @param vector3 - the other vector
+     * @returns the dot product of this and vector3
+     */
+    dot(vector3: Vector3): number;
     /**
      * Checks if the current vector is approximately equal to another vector.
      *