hytopia 0.14.53 → 0.14.55

package/docs/server.blocktexturemetadata.md

@@ -19,5 +19,6 @@ export type BlockTextureMetadata = {
     averageRGB: [number, number, number];
     isTransparent: boolean;
     needsAlphaTest: boolean;
+    transparencyRatio: number;
 };
 ```

package/docs/server.defaultplayerentitycontroller.facescamerawhenidle.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; [DefaultPlayerEntityController](./server.defaultplayerentitycontroller.md) &gt; [facesCameraWhenIdle](./server.defaultplayerentitycontroller.facescamerawhenidle.md)
+
+## DefaultPlayerEntityController.facesCameraWhenIdle property
+
+Whether the entity rotates to face the camera direction when idle. When `true`<!-- -->, the entity always faces the camera direction. When `false`<!-- -->, the entity only rotates while actively moving.
+
+**Signature:**
+
+```typescript
+facesCameraWhenIdle: boolean;
+```

package/docs/server.defaultplayerentitycontroller.md

@@ -212,7 +212,7 @@ A function allowing custom logic to determine if the entity can walk.
 </td></tr>
 <tr><td>
 
-[faceForwardOnStop](./server.defaultplayerentitycontroller.faceforwardonstop.md)
+[facesCameraWhenIdle](./server.defaultplayerentitycontroller.facescamerawhenidle.md)
 
 
 </td><td>
@@ -225,7 +225,7 @@ boolean
 
 </td><td>
 
-Whether to face forward when the entity stops moving.
+Whether the entity rotates to face the camera direction when idle. When `true`<!-- -->, the entity always faces the camera direction. When `false`<!-- -->, the entity only rotates while actively moving.
 
 
 </td></tr>

package/docs/server.defaultplayerentitycontrolleroptions.facescamerawhenidle.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; [DefaultPlayerEntityControllerOptions](./server.defaultplayerentitycontrolleroptions.md) &gt; [facesCameraWhenIdle](./server.defaultplayerentitycontrolleroptions.facescamerawhenidle.md)
+
+## DefaultPlayerEntityControllerOptions.facesCameraWhenIdle property
+
+Whether the entity rotates to face the camera direction when idle.
+
+**Signature:**
+
+```typescript
+facesCameraWhenIdle?: boolean;
+```

package/docs/server.defaultplayerentitycontrolleroptions.md

@@ -155,7 +155,7 @@ _(Optional)_ A function allowing custom logic to determine if the entity can wal
 </td></tr>
 <tr><td>
 
-[faceForwardOnStop?](./server.defaultplayerentitycontrolleroptions.faceforwardonstop.md)
+[facesCameraWhenIdle?](./server.defaultplayerentitycontrolleroptions.facescamerawhenidle.md)
 
 
 </td><td>
@@ -168,7 +168,7 @@ boolean
 
 </td><td>
 
-_(Optional)_ Whether to face forward when the entity stops moving.
+_(Optional)_ Whether the entity rotates to face the camera direction when idle.
 
 
 </td></tr>

package/docs/server.entity.md

@@ -850,6 +850,18 @@ Triggers an interaction on the entity from a player.
 Use for: programmatic interactions that should mimic a player click/tap. Do NOT use for: server-only effects without player context.
 
 
+</td></tr>
+<tr><td>
+
+[setBlockTextureUri(blockTextureUri)](./server.entity.setblocktextureuri.md)
+
+
+</td><td>
+
+
+</td><td>
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.entity.setblocktextureuri.md

@@ -0,0 +1,49 @@
+<!-- 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; [setBlockTextureUri](./server.entity.setblocktextureuri.md)
+
+## Entity.setBlockTextureUri() method
+
+**Signature:**
+
+```typescript
+setBlockTextureUri(blockTextureUri: string | undefined): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+blockTextureUri
+
+
+</td><td>
+
+string \| undefined
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.entityevent.md

@@ -117,6 +117,20 @@ INTERACT
 </td><td>
 
 
+</td></tr>
+<tr><td>
+
+SET\_BLOCK\_TEXTURE\_URI
+
+
+</td><td>
+
+`"ENTITY.SET_BLOCK_TEXTURE_URI"`
+
+
+</td><td>
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.entityeventpayloads._entity.set_block_texture_uri_.md

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [EntityEventPayloads](./server.entityeventpayloads.md) &gt; ["ENTITY.SET\_BLOCK\_TEXTURE\_URI"](./server.entityeventpayloads._entity.set_block_texture_uri_.md)
+
+## EntityEventPayloads."ENTITY.SET\_BLOCK\_TEXTURE\_URI" property
+
+Emitted when the texture uri of a block entity is set.
+
+**Signature:**
+
+```typescript
+[EntityEvent.SET_BLOCK_TEXTURE_URI]: {
+        entity: Entity;
+        blockTextureUri: string | undefined;
+    };
+```

package/docs/server.entityeventpayloads.md

@@ -150,6 +150,25 @@ Emitted when an entity's contact force is applied to another entity.
 Emitted when a player interacts with the entity by clicking or tapping it.
 
 
+</td></tr>
+<tr><td>
+
+["ENTITY.SET\_BLOCK\_TEXTURE\_URI"](./server.entityeventpayloads._entity.set_block_texture_uri_.md)
+
+
+</td><td>
+
+
+</td><td>
+
+{ entity: [Entity](./server.entity.md)<!-- -->; blockTextureUri: string \| undefined; }
+
+
+</td><td>
+
+Emitted when the texture uri of a block entity is set.
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.outline.md

@@ -90,7 +90,7 @@ boolean
 
 </td><td>
 
-_(Optional)_ Whether the outline should be visible when the entity is occluded by other objects. Defaults to true.
+_(Optional)_ Whether the outline should be hidden when the entity is occluded by other objects. If false, the outline is always visible (shows through walls). Defaults to true.
 
 
 </td></tr>
@@ -128,7 +128,7 @@ number
 
 </td><td>
 
-_(Optional)_ The thickness of the outline in world units. Defaults to 0.05.
+_(Optional)_ The thickness of the outline in world units. Defaults to 0.03.
 
 
 </td></tr>

package/docs/server.outline.occluded.md

@@ -4,7 +4,7 @@
 
 ## Outline.occluded property
 
-Whether the outline should be visible when the entity is occluded by other objects. Defaults to true.
+Whether the outline should be hidden when the entity is occluded by other objects. If false, the outline is always visible (shows through walls). Defaults to true.
 
 **Signature:**
 

package/docs/server.outline.thickness.md

@@ -4,7 +4,7 @@
 
 ## Outline.thickness property
 
-The thickness of the outline in world units. Defaults to 0.05.
+The thickness of the outline in world units. Defaults to 0.03.
 
 **Signature:**
 

package/docs/server.particleemitterorientation.md

@@ -11,5 +11,5 @@ The orientation mode for particles.
 **Signature:**
 
 ```typescript
-export type ParticleEmitterOrientation = 'billboard' | 'billboardY' | 'fixed';
+export type ParticleEmitterOrientation = 'billboard' | 'billboardY' | 'fixed' | 'velocity';
 ```

package/docs/server.playercamera.collideswithblocks.md

@@ -0,0 +1,15 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [PlayerCamera](./server.playercamera.md) &gt; [collidesWithBlocks](./server.playercamera.collideswithblocks.md)
+
+## PlayerCamera.collidesWithBlocks property
+
+Whether the camera collides with blocks instead of clipping through them.
+
+\*\*Category:\*\* Players
+
+**Signature:**
+
+```typescript
+get collidesWithBlocks(): boolean;
+```

package/docs/{server.playercamera.lookatentity.md → server.playercamera.faceentity.md}

@@ -1,8 +1,8 @@
 <!-- Do not edit this file. It is automatically generated by API Documenter. -->
 
-[Home](./index.md) &gt; [server](./server.md) &gt; [PlayerCamera](./server.playercamera.md) &gt; [lookAtEntity](./server.playercamera.lookatentity.md)
+[Home](./index.md) &gt; [server](./server.md) &gt; [PlayerCamera](./server.playercamera.md) &gt; [faceEntity](./server.playercamera.faceentity.md)
 
-## PlayerCamera.lookAtEntity() method
+## PlayerCamera.faceEntity() method
 
 Makes the camera look at an entity once.
 
@@ -11,7 +11,7 @@ Use for: one-off focus moments (e.g., cutscene beats). Do NOT use for: continuou
 **Signature:**
 
 ```typescript
-lookAtEntity(entity: Entity): void;
+faceEntity(entity: Entity): void;
 ```
 
 ## Parameters

package/docs/{server.playercamera.lookatposition.md → server.playercamera.faceposition.md}

@@ -1,8 +1,8 @@
 <!-- Do not edit this file. It is automatically generated by API Documenter. -->
 
-[Home](./index.md) &gt; [server](./server.md) &gt; [PlayerCamera](./server.playercamera.md) &gt; [lookAtPosition](./server.playercamera.lookatposition.md)
+[Home](./index.md) &gt; [server](./server.md) &gt; [PlayerCamera](./server.playercamera.md) &gt; [facePosition](./server.playercamera.faceposition.md)
 
-## PlayerCamera.lookAtPosition() method
+## PlayerCamera.facePosition() method
 
 Makes the camera look at a position once.
 
@@ -11,7 +11,7 @@ Use for: one-off focus moments (e.g., points of interest). Do NOT use for: conti
 **Signature:**
 
 ```typescript
-lookAtPosition(position: Vector3Like): void;
+facePosition(position: Vector3Like): void;
 ```
 
 ## Parameters