hytopia 0.1.38 → 0.1.41

package/bin/scripts.js

@@ -29,9 +29,11 @@ const path = require('path');
 
     // Initialize project with latest HYTOPIA SDK
     console.log('🔧 Initializing project with latest HYTOPIA SDK...');
+   
     execSync('bun init --yes');
     execSync('bun add hytopia@latest');
-    
+    execSync('bun add @hytopia.com/assets');
+
     if (flags.template) {
       // Init from example template
       console.log(`🖨️ Initializing project with examples template "${flags.template}"...`);
@@ -53,6 +55,13 @@ const path = require('path');
       fs.cpSync(srcDir, destDir, { recursive: true });  
     }
 
+    // Copy assets into project, not overwriting existing files
+    fs.cpSync(
+      path.join(__dirname, 'node_modules', '@hytopia.com', 'assets'),
+      path.join(destDir, 'assets'),
+      { recursive: true, force: false }
+    );
+
     // Done, lfg!
     console.log('--------------------------------');
     console.log('🚀 Hytopia project initialized successfully!');

package/docs/server.basecharactercontroller.createcolliders.md

@@ -0,0 +1,19 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [BaseCharacterController](./server.basecharactercontroller.md) &gt; [createColliders](./server.basecharactercontroller.createcolliders.md)
+
+## BaseCharacterController.createColliders() method
+
+Override this method to create controller specific colliders to be attached to the controlled entity when it spawns.
+
+**Signature:**
+
+```typescript
+createColliders(): Collider[];
+```
+**Returns:**
+
+[Collider](./server.collider.md)<!-- -->\[\]
+
+An array of colliders.
+

package/docs/server.basecharactercontroller.md

@@ -154,7 +154,7 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
-[createSensorColliders()](./server.basecharactercontroller.createsensorcolliders.md)
+[createColliders()](./server.basecharactercontroller.createcolliders.md)
 
 
 </td><td>
@@ -162,7 +162,7 @@ Description
 
 </td><td>
 
-Override this method to create sensor colliders to be attached to the controlled entity when it spawns.
+Override this method to create controller specific colliders to be attached to the controlled entity when it spawns.
 
 
 </td></tr>

package/docs/server.blocktype.md

@@ -183,7 +183,7 @@ The name of the block type.
 
 </td><td>
 
-(blockType: [BlockType](./server.blocktype.md)<!-- -->, entity: [Entity](./server.entity.md)<!-- -->, started: boolean) =&gt; void
+((blockType: [BlockType](./server.blocktype.md)<!-- -->, entity: [Entity](./server.entity.md)<!-- -->, started: boolean) =&gt; void) \| ((blockType: [BlockType](./server.blocktype.md)<!-- -->, entity: [Entity](./server.entity.md)<!-- -->, started: boolean, colliderHandleA: number, colliderHandleB: number) =&gt; void)
 
 
 </td><td>

package/docs/server.blocktype.onentitycollision.md

@@ -9,5 +9,10 @@ A callback function that is invoked when an entity collides with blocks of this
 **Signature:**
 
 ```typescript
-onEntityCollision?: (blockType: BlockType, entity: Entity, started: boolean) => void;
+onEntityCollision?: ((blockType: BlockType, entity: Entity, started: boolean) => void) | ((blockType: BlockType, entity: Entity, started: boolean, colliderHandleA: number, colliderHandleB: number) => void);
 ```
+
+## Remarks
+
+This must be set before a block of this type is created. If it is set after a block is created, only future created blocks of this type will have the callback set.
+

package/docs/server.blocktype.onentitycontactforce.md

@@ -11,3 +11,8 @@ A callback function that is invoked when an entity contacts a block of this type
 ```typescript
 onEntityContactForce?: (blockType: BlockType, entity: Entity, contactForceData: ContactForceData) => void;
 ```
+
+## Remarks
+
+This must be set before a block of this type is created. If it is set after a block is created, only future created blocks of this type will have the callback set.
+

package/docs/server.coefficientcombinerule.md

@@ -0,0 +1,89 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [CoefficientCombineRule](./server.coefficientcombinerule.md)
+
+## CoefficientCombineRule enum
+
+The coefficient for friction or bounciness combine rule.
+
+**Signature:**
+
+```typescript
+export declare enum CoefficientCombineRule 
+```
+
+## Enumeration Members
+
+<table><thead><tr><th>
+
+Member
+
+
+</th><th>
+
+Value
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+Average
+
+
+</td><td>
+
+`0`
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+Max
+
+
+</td><td>
+
+`3`
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+Min
+
+
+</td><td>
+
+`1`
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+Multiply
+
+
+</td><td>
+
+`2`
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>

package/docs/server.collider.getbouncinesscombinerule.md

@@ -0,0 +1,19 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [Collider](./server.collider.md) &gt; [getBouncinessCombineRule](./server.collider.getbouncinesscombinerule.md)
+
+## Collider.getBouncinessCombineRule() method
+
+Gets the bounciness combine rule of the collider.
+
+**Signature:**
+
+```typescript
+getBouncinessCombineRule(): CoefficientCombineRule;
+```
+**Returns:**
+
+[CoefficientCombineRule](./server.coefficientcombinerule.md)
+
+The bounciness combine rule of the collider.
+

package/docs/server.collider.getfrictioncombinerule.md

@@ -0,0 +1,19 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [Collider](./server.collider.md) &gt; [getFrictionCombineRule](./server.collider.getfrictioncombinerule.md)
+
+## Collider.getFrictionCombineRule() method
+
+Gets the friction combine rule of the collider.
+
+**Signature:**
+
+```typescript
+getFrictionCombineRule(): CoefficientCombineRule;
+```
+**Returns:**
+
+[CoefficientCombineRule](./server.coefficientcombinerule.md)
+
+The friction combine rule of the collider.
+

package/docs/server.collider.md

@@ -316,6 +316,20 @@ Enables or disables contact force events for the collider. This is automatically
 Gets the bounciness of the collider.
 
 
+</td></tr>
+<tr><td>
+
+[getBouncinessCombineRule()](./server.collider.getbouncinesscombinerule.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Gets the bounciness combine rule of the collider.
+
+
 </td></tr>
 <tr><td>
 
@@ -344,6 +358,20 @@ Gets the collision groups the collider belongs to.
 Gets the friction of the collider.
 
 
+</td></tr>
+<tr><td>
+
+[getFrictionCombineRule()](./server.collider.getfrictioncombinerule.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Gets the friction combine rule of the collider.
+
+
 </td></tr>
 <tr><td>
 
@@ -400,6 +428,20 @@ Removes the collider from the simulation.
 Sets the bounciness of the collider.
 
 
+</td></tr>
+<tr><td>
+
+[setBouncinessCombineRule(bouncinessCombineRule)](./server.collider.setbouncinesscombinerule.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Sets the bounciness combine rule of the collider.
+
+
 </td></tr>
 <tr><td>
 
@@ -442,6 +484,20 @@ Sets whether the collider is enabled.
 Sets the friction of the collider.
 
 
+</td></tr>
+<tr><td>
+
+[setFrictionCombineRule(frictionCombineRule)](./server.collider.setfrictioncombinerule.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Sets the friction combine rule of the collider.
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.collider.setbouncinesscombinerule.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; [Collider](./server.collider.md) &gt; [setBouncinessCombineRule](./server.collider.setbouncinesscombinerule.md)
+
+## Collider.setBouncinessCombineRule() method
+
+Sets the bounciness combine rule of the collider.
+
+**Signature:**
+
+```typescript
+setBouncinessCombineRule(bouncinessCombineRule: CoefficientCombineRule): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+bouncinessCombineRule
+
+
+</td><td>
+
+[CoefficientCombineRule](./server.coefficientcombinerule.md)
+
+
+</td><td>
+
+The bounciness combine rule of the collider.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.collider.setfrictioncombinerule.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; [Collider](./server.collider.md) &gt; [setFrictionCombineRule](./server.collider.setfrictioncombinerule.md)
+
+## Collider.setFrictionCombineRule() method
+
+Sets the friction combine rule of the collider.
+
+**Signature:**
+
+```typescript
+setFrictionCombineRule(frictionCombineRule: CoefficientCombineRule): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+frictionCombineRule
+
+
+</td><td>
+
+[CoefficientCombineRule](./server.coefficientcombinerule.md)
+
+
+</td><td>
+
+The friction combine rule of the collider.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.collideroptions.bouncinesscombinerule.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; [ColliderOptions](./server.collideroptions.md) &gt; [bouncinessCombineRule](./server.collideroptions.bouncinesscombinerule.md)
+
+## ColliderOptions.bouncinessCombineRule property
+
+The bounciness combine rule of the collider.
+
+**Signature:**
+
+```typescript
+bouncinessCombineRule?: CoefficientCombineRule;
+```

package/docs/server.collideroptions.frictioncombinerule.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; [ColliderOptions](./server.collideroptions.md) &gt; [frictionCombineRule](./server.collideroptions.frictioncombinerule.md)
+
+## ColliderOptions.frictionCombineRule property
+
+The friction combine rule of the collider.
+
+**Signature:**
+
+```typescript
+frictionCombineRule?: CoefficientCombineRule;
+```

package/docs/server.collideroptions.indices.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; [ColliderOptions](./server.collideroptions.md) &gt; [indices](./server.collideroptions.indices.md)
+
+## ColliderOptions.indices property
+
+The indices of the collider if the shape is a trimesh.
+
+**Signature:**
+
+```typescript
+indices?: Uint32Array;
+```

package/docs/server.collideroptions.md

@@ -72,6 +72,25 @@ number
 _(Optional)_ The bounciness of the collider.
 
 
+</td></tr>
+<tr><td>
+
+[bouncinessCombineRule?](./server.collideroptions.bouncinesscombinerule.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[CoefficientCombineRule](./server.coefficientcombinerule.md)
+
+
+</td><td>
+
+_(Optional)_ The bounciness combine rule of the collider.
+
+
 </td></tr>
 <tr><td>
 
@@ -129,6 +148,25 @@ number
 _(Optional)_ The friction of the collider.
 
 
+</td></tr>
+<tr><td>
+
+[frictionCombineRule?](./server.collideroptions.frictioncombinerule.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[CoefficientCombineRule](./server.coefficientcombinerule.md)
+
+
+</td><td>
+
+_(Optional)_ The friction combine rule of the collider.
+
+
 </td></tr>
 <tr><td>
 
@@ -167,6 +205,25 @@ number
 _(Optional)_ The half height of the collider if the shape is a capsule, cone, cylinder, or round cylinder.
 
 
+</td></tr>
+<tr><td>
+
+[indices?](./server.collideroptions.indices.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Uint32Array
+
+
+</td><td>
+
+_(Optional)_ The indices of the collider if the shape is a trimesh.
+
+
 </td></tr>
 <tr><td>
 
@@ -357,5 +414,24 @@ string
 _(Optional)_ An arbitrary identifier tag of the collider. Useful for your own logic.
 
 
+</td></tr>
+<tr><td>
+
+[vertices?](./server.collideroptions.vertices.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Float32Array
+
+
+</td><td>
+
+_(Optional)_ The vertices of the collider if the shape is a trimesh.
+
+
 </td></tr>
 </tbody></table>

package/docs/server.collideroptions.vertices.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; [ColliderOptions](./server.collideroptions.md) &gt; [vertices](./server.collideroptions.vertices.md)
+
+## ColliderOptions.vertices property
+
+The vertices of the collider if the shape is a trimesh.
+
+**Signature:**
+
+```typescript
+vertices?: Float32Array;
+```

package/docs/server.collidershape.md

@@ -113,5 +113,19 @@ ROUND\_CYLINDER
 </td><td>
 
 
+</td></tr>
+<tr><td>
+
+TRIMESH
+
+
+</td><td>
+
+`"trimesh"`
+
+
+</td><td>
+
+
 </td></tr>
 </tbody></table>

package/docs/server.collisioncallback.md

@@ -9,7 +9,7 @@ A callback function that is called when a collision occurs.
 **Signature:**
 
 ```typescript
-export type CollisionCallback = (other: BlockType | Entity, started: boolean) => void;
+export type CollisionCallback = ((other: BlockType | Entity, started: boolean) => void) | ((other: BlockType | Entity, started: boolean, colliderHandleA: number, colliderHandleB: number) => void);
 ```
 **References:** [BlockType](./server.blocktype.md)<!-- -->, [Entity](./server.entity.md)
 

package/docs/{server.defaultcharactercontroller.createsensorcolliders.md → server.defaultcharactercontroller.createcolliders.md}

@@ -1,15 +1,15 @@
 <!-- Do not edit this file. It is automatically generated by API Documenter. -->
 
-[Home](./index.md) &gt; [server](./server.md) &gt; [DefaultCharacterController](./server.defaultcharactercontroller.md) &gt; [createSensorColliders](./server.defaultcharactercontroller.createsensorcolliders.md)
+[Home](./index.md) &gt; [server](./server.md) &gt; [DefaultCharacterController](./server.defaultcharactercontroller.md) &gt; [createColliders](./server.defaultcharactercontroller.createcolliders.md)
 
-## DefaultCharacterController.createSensorColliders() method
+## DefaultCharacterController.createColliders() method
 
-Creates the sensor colliders for the character controller, overriding the default implementation.
+Creates the colliders for the character controller, overriding the default implementation.
 
 **Signature:**
 
 ```typescript
-createSensorColliders(): Collider[];
+createColliders(): Collider[];
 ```
 **Returns:**
 

package/docs/server.defaultcharactercontroller.md

@@ -290,7 +290,7 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
-[createSensorColliders()](./server.defaultcharactercontroller.createsensorcolliders.md)
+[createColliders()](./server.defaultcharactercontroller.createcolliders.md)
 
 
 </td><td>
@@ -298,7 +298,7 @@ Description
 
 </td><td>
 
-Creates the sensor colliders for the character controller, overriding the default implementation.
+Creates the colliders for the character controller, overriding the default implementation.
 
 
 </td></tr>

package/docs/server.entity.isblockentity.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; [isBlockEntity](./server.entity.isblockentity.md)
+
+## Entity.isBlockEntity property
+
+Whether the entity is a block entity.
+
+**Signature:**
+
+```typescript
+get isBlockEntity(): boolean;
+```

package/docs/server.entity.ismodelentity.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; [isModelEntity](./server.entity.ismodelentity.md)
+
+## Entity.isModelEntity property
+
+Whether the entity is a model entity.
+
+**Signature:**
+
+```typescript
+get isModelEntity(): boolean;
+```