hytopia 0.1.78 → 0.1.80

package/examples/child-entity/assets/models/sword.gltf

@@ -0,0 +1 @@
+{"asset":{"version":"2.0","generator":"Blockbench 4.11.2 glTF exporter"},"scenes":[{"nodes":[6],"name":"blockbench_export"}],"scene":0,"nodes":[{"translation":[0.015625,-0.0859375,0.03125],"name":"cube","mesh":0},{"translation":[-2.7755575615628914e-17,-0.8125,0],"name":"cube","mesh":1},{"translation":[0.031249999999999972,-0.34218749999999987,0],"name":"cube","mesh":2},{"translation":[-2.7755575610105143e-17,1.71875,-3.4694469961437686e-18],"name":"cube","mesh":3},{"translation":[-0.17187500001243847,0.45468750000000013,0.046875],"name":"cube","mesh":4},{"rotation":[0,7.960590520106338e-10,0,1],"translation":[2.7755575615628914e-17,0.4375,0],"name":"sword","children":[0,1,2,3,4]},{"children":[5]}],"bufferViews":[{"buffer":0,"byteOffset":0,"byteLength":288,"target":34962,"byteStride":12},{"buffer":0,"byteOffset":288,"byteLength":288,"target":34962,"byteStride":12},{"buffer":0,"byteOffset":576,"byteLength":192,"target":34962,"byteStride":8},{"buffer":0,"byteOffset":768,"byteLength":72,"target":34963},{"buffer":0,"byteOffset":840,"byteLength":288,"target":34962,"byteStride":12},{"buffer":0,"byteOffset":1128,"byteLength":288,"target":34962,"byteStride":12},{"buffer":0,"byteOffset":1416,"byteLength":192,"target":34962,"byteStride":8},{"buffer":0,"byteOffset":1608,"byteLength":72,"target":34963},{"buffer":0,"byteOffset":1680,"byteLength":288,"target":34962,"byteStride":12},{"buffer":0,"byteOffset":1968,"byteLength":288,"target":34962,"byteStride":12},{"buffer":0,"byteOffset":2256,"byteLength":192,"target":34962,"byteStride":8},{"buffer":0,"byteOffset":2448,"byteLength":72,"target":34963},{"buffer":0,"byteOffset":2520,"byteLength":288,"target":34962,"byteStride":12},{"buffer":0,"byteOffset":2808,"byteLength":288,"target":34962,"byteStride":12},{"buffer":0,"byteOffset":3096,"byteLength":192,"target":34962,"byteStride":8},{"buffer":0,"byteOffset":3288,"byteLength":72,"target":34963},{"buffer":0,"byteOffset":3360,"byteLength":288,"target":34962,"byteStride":12},{"buffer":0,"byteOffset":3648,"byteLength":288,"target":34962,"byteStride":12},{"buffer":0,"byteOffset":3936,"byteLength":192,"target":34962,"byteStride":8},{"buffer":0,"byteOffset":4128,"byteLength":72,"target":34963}],"buffers":[{"byteLength":4200,"uri":"data:application/octet-stream;base64,AAAQPgAA2z8AAAA9AAAQPgAA2z8AAMC9AAAQPgAABj8AAAA9AAAQPgAABj8AAMC9AAAwvgAA2z8AAMC9AAAwvgAA2z8AAAA9AAAwvgAABj8AAMC9AAAwvgAABj8AAAA9AAAwvgAA2z8AAMC9AAAQPgAA2z8AAMC9AAAwvgAA2z8AAAA9AAAQPgAA2z8AAAA9AAAwvgAABj8AAAA9AAAQPgAABj8AAAA9AAAwvgAABj8AAMC9AAAQPgAABj8AAMC9AAAwvgAA2z8AAAA9AAAQPgAA2z8AAAA9AAAwvgAABj8AAAA9AAAQPgAABj8AAAA9AAAQPgAA2z8AAMC9AAAwvgAA2z8AAMC9AAAQPgAABj8AAMC9AAAwvgAABj8AAMC9AACAPwAAAAAAAAAAAACAPwAAAAAAAAAAAACAPwAAAAAAAAAAAACAPwAAAAAAAAAAAACAvwAAAAAAAAAAAACAvwAAAAAAAAAAAACAvwAAAAAAAAAAAACAvwAAAAAAAAAAAAAAAAAAgD8AAAAAAAAAAAAAgD8AAAAAAAAAAAAAgD8AAAAAAAAAAAAAgD8AAAAAAAAAAAAAgL8AAAAAAAAAAAAAgL8AAAAAAAAAAAAAgL8AAAAAAAAAAAAAgL8AAAAAAAAAAAAAAAAAAIA/AAAAAAAAAAAAAIA/AAAAAAAAAAAAAIA/AAAAAAAAAAAAAIA/AAAAAAAAAAAAAIC/AAAAAAAAAAAAAIC/AAAAAAAAAAAAAIC/AAAAAAAAAAAAAIC/AAAAOgAAgT0AAH49AACBPQAAADoA4Cc/AAB+PQDgJz8AgGA+AACBPQDAjz4AAIE9AIBgPgDgJz8AwI8+AOAnPwCAXz4AAH49AACBPQAAfj0AgF8+AAAAOgAAgT0AAAA6AMC/PgAAADoAgGA+AAAAOgDAvz4AAH49AIBgPgAAfj0AQJA+AACBPQDA3z4AAIE9AECQPgDgJz8AwN8+AOAnPwAAgT0AAIE9AIBfPgAAgT0AAIE9AOAnPwCAXz4A4Cc/AAACAAEAAgADAAEABAAGAAUABgAHAAUACAAKAAkACgALAAkADAAOAA0ADgAPAA0AEAASABEAEgATABEAFAAWABUAFgAXABUAAACAPQAAiD8AAIA9AACAPQAAiD8AAIC9AACAPQAAID8AAIA9AACAPQAAID8AAIC9AACAvQAAiD8AAIC9AACAvQAAiD8AAIA9AACAvQAAID8AAIC9AACAvQAAID8AAIA9AACAvQAAiD8AAIC9AACAPQAAiD8AAIC9AACAvQAAiD8AAIA9AACAPQAAiD8AAIA9AACAvQAAID8AAIA9AACAPQAAID8AAIA9AACAvQAAID8AAIC9AACAPQAAID8AAIC9AACAvQAAiD8AAIA9AACAPQAAiD8AAIA9AACAvQAAID8AAIA9AACAPQAAID8AAIA9AACAPQAAiD8AAIC9AACAvQAAiD8AAIC9AACAPQAAID8AAIC9AACAvQAAID8AAIC9AACAPwAAAAAAAAAAAACAPwAAAAAAAAAAAACAPwAAAAAAAAAAAACAPwAAAAAAAAAAAACAvwAAAAAAAAAAAACAvwAAAAAAAAAAAACAvwAAAAAAAAAAAACAvwAAAAAAAAAAAAAAAAAAgD8AAAAAAAAAAAAAgD8AAAAAAAAAAAAAgD8AAAAAAAAAAAAAgD8AAAAAAAAAAAAAgL8AAAAAAAAAAAAAgL8AAAAAAAAAAAAAgL8AAAAAAAAAAAAAgL8AAAAAAAAAAAAAAAAAAIA/AAAAAAAAAAAAAIA/AAAAAAAAAAAAAIA/AAAAAAAAAAAAAIA/AAAAAAAAAAAAAIC/AAAAAAAAAAAAAIC/AAAAAAAAAAAAAIC/AAAAAAAAAAAAAIC/AEDwPgBA4D4A4Ac/AEDgPgBA8D4A4Cc/AOAHPwDgJz8AIBg/AEDgPgDgJz8AQOA+ACAYPwDgJz8A4Cc/AOAnPwDgFz8AwN8+ACAIPwDA3z4A4Bc/AEDAPgAgCD8AQMA+AOAnPwBAwD4AIBg/AEDAPgDgJz8AwN8+ACAYPwDA3z4AICg/AEDgPgDgNz8AQOA+ACAoPwDgJz8A4Dc/AOAnPwAgCD8AQOA+AOAXPwBA4D4AIAg/AOAnPwDgFz8A4Cc/AAACAAEAAgADAAEABAAGAAUABgAHAAUACAAKAAkACgALAAkADAAOAA0ADgAPAA0AEAASABEAEgATABEAFAAWABUAFgAXABUAAADAPQAAID4AAMA9AADAPQAAID4AAMC9AADAPQAAwL0AAMA9AADAPQAAwL0AAMC9AAAgvgAAID4AAMC9AAAgvgAAID4AAMA9AAAgvgAAwL0AAMC9AAAgvgAAwL0AAMA9AAAgvgAAID4AAMC9AADAPQAAID4AAMC9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"}],"accessors":[{"bufferView":0,"componentType":5126,"count":24,"max":[0.140625,1.7109375,0.03125],"min":[-0.171875,0.5234375,-0.09375],"type":"VEC3"},{"bufferView":1,"componentType":5126,"count":24,"max":[1,1,1],"min":[-1,-1,-1],"type":"VEC3"},{"bufferView":2,"componentType":5126,"count":24,"max":[0.43701171875,0.65576171875],"min":[0.00048828125,0.00048828125],"type":"VEC2"},{"bufferView":3,"componentType":5123,"count":36,"max":[23],"min":[0],"type":"SCALAR"},{"bufferView":4,"componentType":5126,"count":24,"max":[0.0625,1.0625,0.0625],"min":[-0.0625,0.625,-0.0625],"type":"VEC3"},{"bufferView":5,"componentType":5126,"count":24,"max":[1,1,1],"min":[-1,-1,-1],"type":"VEC3"},{"bufferView":6,"componentType":5126,"count":24,"max":[0.71826171875,0.65576171875],"min":[0.46923828125,0.37548828125],"type":"VEC2"},{"bufferView":7,"componentType":5123,"count":36,"max":[23],"min":[0],"type":"SCALAR"},{"bufferView":8,"componentType":5126,"count":24,"max":[0.09375,0.15625,0.09375],"min":[-0.15625,-0.09375,-0.09375],"type":"VEC3"},{"bufferView":9,"componentType":5126,"count":24,"max":[1,1,1],"min":[-1,-1,-1],"type":"VEC3"},{"bufferView":10,"componentType":5126,"count":24,"max":[0.87451171875,0.21826171875],"min":[0.43798828125,0.00048828125],"type":"VEC2"},{"bufferView":11,"componentType":5123,"count":36,"max":[23],"min":[0],"type":"SCALAR"},{"bufferView":12,"componentType":5126,"count":24,"max":[0.15625,0.09375,0.0000625000029685907],"min":[-0.15625,-0.09375,3.469446951953614e-18],"type":"VEC3"},{"bufferView":13,"componentType":5126,"count":24,"max":[1,1,1],"min":[-1,-1,-1],"type":"VEC3"},{"bufferView":14,"componentType":5126,"count":24,"max":[0.74951171875,0.31201171875],"min":[0.43701171875,0.21826171875],"type":"VEC2"},{"bufferView":15,"componentType":5123,"count":36,"max":[23],"min":[0],"type":"SCALAR"},{"bufferView":16,"componentType":5126,"count":24,"max":[0.515625,-0.01718750037252903,0.046875],"min":[-0.171875,-0.20468750596046448,-0.140625],"type":"VEC3"},{"bufferView":17,"componentType":5126,"count":24,"max":[1,1,1],"min":[-1,-1,-1],"type":"VEC3"},{"bufferView":18,"componentType":5126,"count":24,"max":[0.87451171875,0.84326171875],"min":[0.00048828125,0.65673828125],"type":"VEC2"},{"bufferView":19,"componentType":5123,"count":36,"max":[23],"min":[0],"type":"SCALAR"}],"materials":[{"pbrMetallicRoughness":{"metallicFactor":0,"roughnessFactor":1,"baseColorTexture":{"index":0}},"alphaMode":"MASK","alphaCutoff":0.05,"doubleSided":true}],"textures":[{"sampler":0,"source":0,"name":"sword.png"}],"samplers":[{"magFilter":9728,"minFilter":9728,"wrapS":33071,"wrapT":33071}],"images":[{"mimeType":"image/png","uri":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAAXNSR0IArs4c6QAAAUtJREFUWEdjZICCc5dW/QcxVaRVGRZs3AkTxqDzkioY0QU/vT0P1gsDd57eRlFipBeGoQemAC4xYA6AWQxzEb4QSPB3Z4D5DtlXFIUAuQ4AOZQcwCdsiBIdjOQ6AN3yI2fugYVsTJQw3IUsh54eho8DiI0OqoUAzCBQFOLLZoQcRnYUgCwFWQ5KjKCcQa4jyHYAerYFJT5yHEG2A8ixDFt0DA8HpFoZodQFs4+dw1n2o4cCVUJgwByAbjG674gJCYpCYG9mMErQozvAefpaglExtB2AHAVaAtwoAXDtw1eG0SggKg1MmteBkpBARSqs/kZPVMhyoLYhVaIA2RJsjRNcDU10RyI3RNDlsDVkMRqlIIGR6QB0XyNHCXLDE72tj6+hgU8fRosIPREiGwxrhhPqrKA7Bp8+9PTAOOAOINRmo7U8wcpi1AHDPgQAgqx2MAXdOiQAAAAASUVORK5CYII="}],"meshes":[{"primitives":[{"mode":4,"attributes":{"POSITION":0,"NORMAL":1,"TEXCOORD_0":2},"indices":3,"material":0}]},{"primitives":[{"mode":4,"attributes":{"POSITION":4,"NORMAL":5,"TEXCOORD_0":6},"indices":7,"material":0}]},{"primitives":[{"mode":4,"attributes":{"POSITION":8,"NORMAL":9,"TEXCOORD_0":10},"indices":11,"material":0}]},{"primitives":[{"mode":4,"attributes":{"POSITION":12,"NORMAL":13,"TEXCOORD_0":14},"indices":15,"material":0}]},{"primitives":[{"mode":4,"attributes":{"POSITION":16,"NORMAL":17,"TEXCOORD_0":18},"indices":19,"material":0}]}]}

package/examples/child-entity/index.ts

@@ -0,0 +1,42 @@
+import {
+  startServer,
+  Entity,
+  PlayerEntity,
+} from 'hytopia';
+
+import worldMap from './assets/map.json';
+
+startServer(world => {
+  world.loadMap(worldMap);
+
+  // Spawn a player entity when a player joins the game.
+  world.onPlayerJoin = player => {
+    const playerEntity = new PlayerEntity({
+      player,
+      name: 'Player',
+      modelUri: 'models/player.gltf',
+      modelLoopedAnimations: [ 'idle' ],
+      modelScale: 0.5,
+    });
+  
+    playerEntity.spawn(world, { x: 0, y: 10, z: 0 });
+
+    // Spawn a sword entity as a child of the player entity.
+    const swordChildEntity = new Entity({
+      name: 'sword',
+      modelUri: 'models/sword.gltf',
+      parent: playerEntity,
+      parentNodeName: 'hand_right_anchor',
+    });
+    
+    swordChildEntity.spawn(
+      world,
+      { x: 0, y: 0.3, z: 0.5 }, // spawn with a position relative to the parent node
+      { x: -Math.PI / 3, y: 0, z: 0, w: 1 } // spawn with a rotation so it looks correct in the hand
+    );
+  };
+
+  world.onPlayerLeave = player => {
+    world.entityManager.getPlayerEntitiesByPlayer(player).forEach(entity => entity.despawn());
+  };
+});

package/examples/child-entity/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "child-entity",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "hytopia": "latest",
+    "@hytopia.com/assets": "latest"
+  }
+}

package/examples/entity-controller/MyEntityController.ts

@@ -144,7 +144,7 @@ export default class MyEntityController extends BaseEntityController {
         collidesWith: [ CollisionGroup.BLOCK, CollisionGroup.ENTITY ],
       },
       isSensor: true,
-      position: { x: 0, y: -0.75, z: 0 },
+      relativePosition: { x: 0, y: -0.75, z: 0 },
       tag: 'groundSensor',
       onCollision: (_other: BlockType | Entity, started: boolean) => {
         // Ground contact
@@ -206,20 +206,23 @@ export default class MyEntityController extends BaseEntityController {
     // Temporary, animations
     if (this.isGrounded && (w || a || s || d)) {
       if (isRunning) {
-        entity.stopModelAnimations(Array.from(entity.modelLoopedAnimations).filter(v => v !== 'run'));
-        entity.startModelLoopedAnimations([ 'run' ]);
-        this._stepAudio?.setPlaybackRate(0.83);
+        const runAnimations = [ 'run_upper', 'run_lower' ];
+        entity.stopModelAnimations(Array.from(entity.modelLoopedAnimations).filter(v => !runAnimations.includes(v)));
+        entity.startModelLoopedAnimations(runAnimations);
+        this._stepAudio?.setPlaybackRate(0.81);
       } else {
-        entity.stopModelAnimations(Array.from(entity.modelLoopedAnimations).filter(v => v !== 'walk'));
-        entity.startModelLoopedAnimations([ 'walk' ]);
-        this._stepAudio?.setPlaybackRate(0.5);
+        const walkAnimations = [ 'walk_upper', 'walk_lower' ];
+        entity.stopModelAnimations(Array.from(entity.modelLoopedAnimations).filter(v => !walkAnimations.includes(v)));
+        entity.startModelLoopedAnimations(walkAnimations);
+        this._stepAudio?.setPlaybackRate(0.55);
       }
 
       this._stepAudio?.play(entity.world, !this._stepAudio?.isPlaying);
     } else {
       this._stepAudio?.pause();
-      entity.stopModelAnimations(Array.from(entity.modelLoopedAnimations).filter(v => v !== 'idle'));
-      entity.startModelLoopedAnimations([ 'idle' ]);
+      const idleAnimations = [ 'idle_upper', 'idle_lower' ];
+      entity.stopModelAnimations(Array.from(entity.modelLoopedAnimations).filter(v => !idleAnimations.includes(v)));
+      entity.startModelLoopedAnimations(idleAnimations);
     }
 
     if (ml) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hytopia",
-  "version": "0.1.78",
+  "version": "0.1.80",
   "description": "The HYTOPIA SDK makes it easy for developers to create massively multiplayer games using JavaScript or TypeScript.",
   "main": "server.js",
   "bin": {

package/server.api.json

@@ -9692,7 +9692,7 @@
             {
               "kind": "Method",
               "canonicalReference": "server!Entity#despawn:member(1)",
-              "docComment": "/**\n * Despawns the entity from the world.\n */\n",
+              "docComment": "/**\n * Despawns the entity and all children from the world.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -10423,6 +10423,71 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "server!Entity#parent:member",
+              "docComment": "/**\n * The parent entity of the entity.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get parent(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Entity",
+                  "canonicalReference": "server!Entity:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "parent",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "server!Entity#parentNodeName:member",
+              "docComment": "/**\n * The name of the parent's node (if parent is a model entity) this entity is attached to when spawned.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get parentNodeName(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "parentNodeName",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "server!Entity#setController:member(1)",
@@ -10676,7 +10741,7 @@
             {
               "kind": "Method",
               "canonicalReference": "server!Entity#spawn:member(1)",
-              "docComment": "/**\n * Spawns the entity in the world.\n *\n * @param world - The world to spawn the entity in.\n *\n * @param coordinate - The coordinate to spawn the entity at.\n */\n",
+              "docComment": "/**\n * Spawns the entity in the world.\n *\n * @param world - The world to spawn the entity in.\n *\n * @param position - The position to spawn the entity at.\n *\n * @param rotation - The optional rotation to spawn the entity with.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -10689,13 +10754,22 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ", coordinate: "
+                  "text": ", position: "
                 },
                 {
                   "kind": "Reference",
                   "text": "Vector3Like",
                   "canonicalReference": "server!Vector3Like:interface"
                 },
+                {
+                  "kind": "Content",
+                  "text": ", rotation?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "QuaternionLike",
+                  "canonicalReference": "server!QuaternionLike:interface"
+                },
                 {
                   "kind": "Content",
                   "text": "): "
@@ -10711,8 +10785,8 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 5,
-                "endIndex": 6
+                "startIndex": 7,
+                "endIndex": 8
               },
               "releaseTag": "Public",
               "isProtected": false,
@@ -10727,12 +10801,20 @@
                   "isOptional": false
                 },
                 {
-                  "parameterName": "coordinate",
+                  "parameterName": "position",
                   "parameterTypeTokenRange": {
                     "startIndex": 3,
                     "endIndex": 4
                   },
                   "isOptional": false
+                },
+                {
+                  "parameterName": "rotation",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": true
                 }
               ],
               "isOptional": false,
@@ -12289,6 +12371,60 @@
               "isAbstract": false,
               "name": "getEntity"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "server!EntityManager#getEntityChildren:member(1)",
+              "docComment": "/**\n * Gets all child entities of an entity.\n *\n * @param entity - The entity to get the children for.\n *\n * @returns All child entities of the entity.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getEntityChildren(entity: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Entity",
+                  "canonicalReference": "server!Entity:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Entity",
+                  "canonicalReference": "server!Entity:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "entity",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getEntityChildren"
+            },
             {
               "kind": "Method",
               "canonicalReference": "server!EntityManager#getPlayerEntitiesByPlayer:member(1)",
@@ -12664,6 +12800,61 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "server!EntityOptions#parent:member",
+              "docComment": "/**\n * The parent entity of the entity, entities with a parent will ignore creating their own colliders.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "parent?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Entity",
+                  "canonicalReference": "server!Entity:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "parent",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "server!EntityOptions#parentNodeName:member",
+              "docComment": "/**\n * The name of the parent's node (if parent is a model entity) to attach the entity to.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "parentNodeName?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "parentNodeName",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "server!EntityOptions#rigidBodyOptions:member",
@@ -16754,6 +16945,54 @@
               "isAbstract": false,
               "name": "getBoundingBox"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "server!ModelRegistry#getNodeNames:member(1)",
+              "docComment": "/**\n * Retrieves the names of all nodes in a model.\n *\n * @param modelUri - The URI of the model to retrieve the node names for.\n *\n * @returns The names of all nodes in the model.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getNodeNames(modelUri: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "modelUri",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getNodeNames"
+            },
             {
               "kind": "Property",
               "canonicalReference": "server!ModelRegistry.instance:member",
@@ -16784,6 +17023,70 @@
               "isStatic": true,
               "isProtected": false,
               "isAbstract": false
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "server!ModelRegistry#modelHasNode:member(1)",
+              "docComment": "/**\n * Checks if a model has a node with the given name.\n *\n * @param modelUri - The URI of the model to check.\n *\n * @param nodeName - The name of the node to check for.\n *\n * @returns Whether the model has a node with the given name.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "modelHasNode(modelUri: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", nodeName: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "modelUri",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "nodeName",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "modelHasNode"
             }
           ],
           "implementsTokenRanges": []

package/server.d.ts

@@ -1359,6 +1359,8 @@ export declare class Entity extends RigidBody implements protocol.Serializable {
 
 
 
+
+
     /**
      * @param options - The options for the entity.
      */
@@ -1385,6 +1387,10 @@ export declare class Entity extends RigidBody implements protocol.Serializable {
     get name(): string;
     /** The opacity of the entity between 0 and 1. 0 is fully transparent, 1 is fully opaque. */
     get opacity(): number | undefined;
+    /** The parent entity of the entity. */
+    get parent(): Entity | undefined;
+    /** The name of the parent's node (if parent is a model entity) this entity is attached to when spawned. */
+    get parentNodeName(): string | undefined;
     /** An arbitrary identifier tag of the entity. Useful for your own logic. */
     get tag(): string | undefined;
     /** The tint color of the entity. */
@@ -1400,11 +1406,12 @@ export declare class Entity extends RigidBody implements protocol.Serializable {
     /**
      * Spawns the entity in the world.
      * @param world - The world to spawn the entity in.
-     * @param coordinate - The coordinate to spawn the entity at.
+     * @param position - The position to spawn the entity at.
+     * @param rotation - The optional rotation to spawn the entity with.
      */
-    spawn(world: World, coordinate: Vector3Like): void;
+    spawn(world: World, position: Vector3Like, rotation?: QuaternionLike): void;
     /**
-     * Despawns the entity from the world.
+     * Despawns the entity and all children from the world.
      */
     despawn(): void;
     /**
@@ -1602,6 +1609,12 @@ export declare class EntityManager {
      * @returns All spawned entities in the world with a tag that includes the provided substring.
      */
     getEntitiesByTagSubstring(tagSubstring: string): Entity[];
+    /**
+     * Gets all child entities of an entity.
+     * @param entity - The entity to get the children for.
+     * @returns All child entities of the entity.
+     */
+    getEntityChildren(entity: Entity): Entity[];
 
 
 }
@@ -1628,6 +1641,10 @@ export declare interface EntityOptions {
     name?: string;
     /** The opacity of the entity between 0 and 1. 0 is fully transparent, 1 is fully opaque. */
     opacity?: number;
+    /** The parent entity of the entity, entities with a parent will ignore creating their own colliders. */
+    parent?: Entity;
+    /** The name of the parent's node (if parent is a model entity) to attach the entity to. */
+    parentNodeName?: string;
     /** The rigid body options for the entity. */
     rigidBodyOptions?: RigidBodyOptions;
     /** An arbitrary identifier tag of the entity. Useful for your own logic. */
@@ -2106,6 +2123,7 @@ export declare class ModelRegistry {
 
 
 
+
     /**
      * Retrieves the bounding box of a model.
      *
@@ -2113,6 +2131,21 @@ export declare class ModelRegistry {
      * @returns The bounding box of the model.
      */
     getBoundingBox(modelUri: string): ModelBoundingBox;
+    /**
+     * Retrieves the names of all nodes in a model.
+     *
+     * @param modelUri - The URI of the model to retrieve the node names for.
+     * @returns The names of all nodes in the model.
+     */
+    getNodeNames(modelUri: string): string[];
+    /**
+     * Checks if a model has a node with the given name.
+     *
+     * @param modelUri - The URI of the model to check.
+     * @param nodeName - The name of the node to check for.
+     * @returns Whether the model has a node with the given name.
+     */
+    modelHasNode(modelUri: string, nodeName: string): boolean;
 
 
 }