hytopia 0.1.34 → 0.1.36

package/README.md

@@ -5,12 +5,14 @@
 
 ## What is HYTOPIA?
 
-![HYTOPIA Demo](./readme/assets/demo.gif)
+![HYTOPIA Banner](./readme/assets/banner-2.jpeg)
 
 HYTOPIA is a modern games platform inspired by Minecraft, Roblox, and Rec Room.
 
 HYTOPIA allows you to create your own highly-sharable, immersive, massively multiplayer games in a voxel-like style by writing TypeScript or JavaScript. All playable in a web browser on any device!
 
+No need to deal with hosting or complex server infrastructure either, simply upload your game to HYTOPIA and we'll handle the scaling, server costs, and more!
+
 ## What is this SDK?
 
 *Note: This SDK is currently in alpha development. Expect breaking changes with new version releases.*

package/docs/server.audio.md

@@ -22,7 +22,7 @@ Audio instances are created directly as instances. They support a variety of con
 
 ```typescript
 (new Audio({
-  uri: 'assets/music/song.mp3',
+  uri: 'music/song.mp3', // relative to the server's assets directory in the project root, resolves to assets/music/song.mp3
   loop: true,
   volume: 0.5,
 })).play(world);

package/docs/server.blocktype.md

@@ -24,7 +24,7 @@ Block types are created directly as instances. They support a variety of configu
 const stoneBlockTypeId = 10;
 world.blockTypeRegistry.registerBlockType(stoneBlockTypeId, new BlockType({
   id: stoneBlockTypeId,
-  textureUri: 'assets/textures/stone.png',
+  textureUri: 'textures/stone.png',
   name: 'Stone',
 }));
 

package/docs/server.blocktyperegistry.md

@@ -25,7 +25,7 @@ The constructor for this class is marked as internal. Third-party code should no
 ```typescript
 world.blockTypeRegistry.registerGenericBlockType({
   id: 15,
-  textureUri: 'assets/textures/dirt.png',
+  textureUri: 'textures/dirt.png',
   name: 'Dirt',
 });
 ```
@@ -124,7 +124,7 @@ Get a registered block type by its id.
 </td></tr>
 <tr><td>
 
-[registerBlockType(id, blockTypeReference)](./server.blocktyperegistry.registerblocktype.md)
+[registerBlockType(blockType)](./server.blocktyperegistry.registerblocktype.md)
 
 
 </td><td>

package/docs/server.blocktyperegistry.registerblocktype.md

@@ -9,7 +9,7 @@ Register a block type.
 **Signature:**
 
 ```typescript
-registerBlockType(id: number, blockTypeReference: BlockType): void;
+registerBlockType(blockType: BlockType): void;
 ```
 
 ## Parameters
@@ -32,23 +32,7 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
-id
-
-
-</td><td>
-
-number
-
-
-</td><td>
-
-The id of the block type to register.
-
-
-</td></tr>
-<tr><td>
-
-blockTypeReference
+blockType
 
 
 </td><td>

package/docs/server.chunk.getblock.md

@@ -0,0 +1,55 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [Chunk](./server.chunk.md) &gt; [getBlock](./server.chunk.getblock.md)
+
+## Chunk.getBlock() method
+
+Get the block type id at a specific local coordinate.
+
+**Signature:**
+
+```typescript
+getBlock(localCoordinate: Vector3): number;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+localCoordinate
+
+
+</td><td>
+
+[Vector3](./server.vector3.md)
+
+
+</td><td>
+
+The local coordinate of the block to get.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+number
+
+The block type id.
+

package/docs/server.chunk.hasblock.md

@@ -0,0 +1,55 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [Chunk](./server.chunk.md) &gt; [hasBlock](./server.chunk.hasblock.md)
+
+## Chunk.hasBlock() method
+
+Check if a block exists at a specific local coordinate.
+
+**Signature:**
+
+```typescript
+hasBlock(localCoordinate: Vector3): boolean;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+localCoordinate
+
+
+</td><td>
+
+[Vector3](./server.vector3.md)
+
+
+</td><td>
+
+The local coordinate of the block to check.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+boolean
+
+Whether a block exists.
+

package/docs/server.chunk.md

@@ -244,6 +244,20 @@ Convert a block index to a local coordinate.
 Despawn the chunk from the world.
 
 
+</td></tr>
+<tr><td>
+
+[getBlock(localCoordinate)](./server.chunk.getblock.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Get the block type id at a specific local coordinate.
+
+
 </td></tr>
 <tr><td>
 
@@ -276,6 +290,20 @@ Convert a global coordinate to a local coordinate.
 Convert a global coordinate to an origin coordinate.
 
 
+</td></tr>
+<tr><td>
+
+[hasBlock(localCoordinate)](./server.chunk.hasblock.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Check if a block exists at a specific local coordinate.
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.chunklattice.getblock.md

@@ -0,0 +1,55 @@
+<!-- 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; [getBlock](./server.chunklattice.getblock.md)
+
+## ChunkLattice.getBlock() method
+
+Get the block type id at a specific global coordinate.
+
+**Signature:**
+
+```typescript
+getBlock(globalCoordinate: Vector3): number;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+globalCoordinate
+
+
+</td><td>
+
+[Vector3](./server.vector3.md)
+
+
+</td><td>
+
+The global coordinate of the block to get.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+number
+
+The block type id, 0 if no block is set.
+

package/docs/server.chunklattice.hasblock.md

@@ -0,0 +1,55 @@
+<!-- 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; [hasBlock](./server.chunklattice.hasblock.md)
+
+## ChunkLattice.hasBlock() method
+
+Check if a block exists at a specific global coordinate.
+
+**Signature:**
+
+```typescript
+hasBlock(globalCoordinate: Vector3): boolean;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+globalCoordinate
+
+
+</td><td>
+
+[Vector3](./server.vector3.md)
+
+
+</td><td>
+
+The global coordinate of the block to check.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+boolean
+
+Whether a block exists.
+

package/docs/server.chunklattice.md

@@ -81,6 +81,20 @@ Description
 Get all chunks in the lattice.
 
 
+</td></tr>
+<tr><td>
+
+[getBlock(globalCoordinate)](./server.chunklattice.getblock.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Get the block type id at a specific global coordinate.
+
+
 </td></tr>
 <tr><td>
 
@@ -95,6 +109,20 @@ Get all chunks in the lattice.
 Get a chunk by its origin coordinate.
 
 
+</td></tr>
+<tr><td>
+
+[hasBlock(globalCoordinate)](./server.chunklattice.hasblock.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Check if a block exists at a specific global coordinate.
+
+
 </td></tr>
 <tr><td>
 
@@ -120,7 +148,7 @@ Check if a chunk exists by its origin coordinate.
 
 </td><td>
 
-Set the block at a global coordinate by block type id, automatically creating a chunk if it doesn't exist.
+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.
 
 
 </td></tr>

package/docs/server.chunklattice.setblock.md

@@ -4,7 +4,7 @@
 
 ## ChunkLattice.setBlock() method
 
-Set the block at a global coordinate by block type id, automatically creating a chunk if it doesn't exist.
+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.
 
 **Signature:**
 
@@ -58,7 +58,7 @@ number
 
 </td><td>
 
-The block type id to set.
+The block type id to set. Use 0 to remove the block and replace with air.
 
 
 </td></tr>

package/docs/server.entity.md

@@ -463,6 +463,27 @@ string \| undefined
 An arbitrary identifier tag of the entity. Useful for your own logic.
 
 
+</td></tr>
+<tr><td>
+
+[tintColor](./server.entity.tintcolor.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+[RgbColor](./server.rgbcolor.md) \| undefined
+
+
+</td><td>
+
+The tint color of the entity.
+
+
 </td></tr>
 <tr><td>
 
@@ -532,6 +553,20 @@ Despawns the entity from the world.
 Sets the character controller for the entity.
 
 
+</td></tr>
+<tr><td>
+
+[setTintColor(tintColor)](./server.entity.settintcolor.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Sets the tint color of the entity.
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.entity.settintcolor.md

@@ -0,0 +1,53 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [Entity](./server.entity.md) &gt; [setTintColor](./server.entity.settintcolor.md)
+
+## Entity.setTintColor() method
+
+Sets the tint color of the entity.
+
+**Signature:**
+
+```typescript
+setTintColor(tintColor: RgbColor | undefined): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+tintColor
+
+
+</td><td>
+
+[RgbColor](./server.rgbcolor.md) \| undefined
+
+
+</td><td>
+
+The tint color of the entity.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.entity.tintcolor.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [Entity](./server.entity.md) &gt; [tintColor](./server.entity.tintcolor.md)
+
+## Entity.tintColor property
+
+The tint color of the entity.
+
+**Signature:**
+
+```typescript
+get tintColor(): RgbColor | undefined;
+```

package/docs/server.entityeventpayload.md

@@ -33,6 +33,15 @@ Description
 </td><td>
 
 
+</td></tr>
+<tr><td>
+
+[SetTintColor](./server.entityeventpayload.settintcolor.md)
+
+
+</td><td>
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.entityeventpayload.settintcolor.entity.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [EntityEventPayload](./server.entityeventpayload.md) &gt; [SetTintColor](./server.entityeventpayload.settintcolor.md) &gt; [entity](./server.entityeventpayload.settintcolor.entity.md)
+
+## EntityEventPayload.SetTintColor.entity property
+
+**Signature:**
+
+```typescript
+entity: Entity;
+```

package/docs/server.entityeventpayload.settintcolor.md

@@ -0,0 +1,70 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [EntityEventPayload](./server.entityeventpayload.md) &gt; [SetTintColor](./server.entityeventpayload.settintcolor.md)
+
+## EntityEventPayload.SetTintColor interface
+
+**Signature:**
+
+```typescript
+interface SetTintColor 
+```
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[entity](./server.entityeventpayload.settintcolor.entity.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[Entity](./server.entity.md)
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+[tintColor](./server.entityeventpayload.settintcolor.tintcolor.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[RgbColor](./server.rgbcolor.md) \| undefined
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>

package/docs/server.entityeventpayload.settintcolor.tintcolor.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [EntityEventPayload](./server.entityeventpayload.md) &gt; [SetTintColor](./server.entityeventpayload.settintcolor.md) &gt; [tintColor](./server.entityeventpayload.settintcolor.tintcolor.md)
+
+## EntityEventPayload.SetTintColor.tintColor property
+
+**Signature:**
+
+```typescript
+tintColor: RgbColor | undefined;
+```

package/docs/server.entityeventtype.md

@@ -43,6 +43,20 @@ DESPAWN
 </td><td>
 
 
+</td></tr>
+<tr><td>
+
+SET\_TINT\_COLOR
+
+
+</td><td>
+
+`"ENTITY.SET_TINT_COLOR"`
+
+
+</td><td>
+
+
 </td></tr>
 <tr><td>
 
@@ -65,7 +79,7 @@ START\_MODEL\_LOOPED\_ANIMATIONS
 
 </td><td>
 
-`"ENTITY.UPDATE_MODEL_LOOPED_ANIMATIONS"`
+`"ENTITY.START_MODEL_LOOPED_ANIMATIONS"`
 
 
 </td><td>