hytopia 0.14.53 → 0.14.54

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.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

package/docs/server.playercamera.md

@@ -31,7 +31,16 @@ The constructor for this class is marked as internal. Third-party code should no
 
 
 ```typescript
-player.camera.setMode(PlayerCameraMode.FIRST_PERSON);
+// Camera follows player, continuously looks at enemy
+player.camera.setAttachedToEntity(playerEntity);
+player.camera.setTargetEntity(enemyEntity);
+
+// Camera at fixed position, continuously looks at player
+player.camera.setAttachedToPosition({ x: 0, y: 10, z: 0 });
+player.camera.setTargetEntity(playerEntity);
+
+// Stop targeting, restore manual camera control
+player.camera.setTargetEntity(undefined);
 ```
 \*\*Category:\*\* Players
 
@@ -103,6 +112,29 @@ The position the camera is attached to.
 \*\*Category:\*\* Players
 
 
+</td></tr>
+<tr><td>
+
+[collidesWithBlocks](./server.playercamera.collideswithblocks.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+Whether the camera collides with blocks instead of clipping through them.
+
+\*\*Category:\*\* Players
+
+
 </td></tr>
 <tr><td>
 
@@ -372,7 +404,7 @@ The shoulder angle of the camera in degrees.
 </td></tr>
 <tr><td>
 
-[trackedEntity](./server.playercamera.trackedentity.md)
+[targetEntity](./server.playercamera.targetentity.md)
 
 
 </td><td>
@@ -387,7 +419,7 @@ The shoulder angle of the camera in degrees.
 
 </td><td>
 
-The entity the camera will constantly look at, if set.
+The entity the camera continuously rotates to face.
 
 \*\*Category:\*\* Players
 
@@ -395,7 +427,7 @@ The entity the camera will constantly look at, if set.
 </td></tr>
 <tr><td>
 
-[trackedPosition](./server.playercamera.trackedposition.md)
+[targetPosition](./server.playercamera.targetposition.md)
 
 
 </td><td>
@@ -410,7 +442,120 @@ The entity the camera will constantly look at, if set.
 
 </td><td>
 
-The position the camera will constantly look at, if set.
+The position the camera continuously rotates to face.
+
+\*\*Category:\*\* Players
+
+
+</td></tr>
+<tr><td>
+
+[viewModelHiddenNodes](./server.playercamera.viewmodelhiddennodes.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+Set&lt;string&gt;
+
+
+</td><td>
+
+Node substrings to hide on the view model (or attached entity's model).
+
+\*\*Category:\*\* Players
+
+
+</td></tr>
+<tr><td>
+
+[viewModelPitchesWithCamera](./server.playercamera.viewmodelpitcheswithcamera.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+Whether the view model pitches up/down with the camera orientation.
+
+\*\*Category:\*\* Players
+
+
+</td></tr>
+<tr><td>
+
+[viewModelShownNodes](./server.playercamera.viewmodelshownnodes.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+Set&lt;string&gt;
+
+
+</td><td>
+
+Node substrings to show on the view model (or attached entity's model).
+
+\*\*Category:\*\* Players
+
+
+</td></tr>
+<tr><td>
+
+[viewModelUri](./server.playercamera.viewmodeluri.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+string \| undefined
+
+
+</td><td>
+
+The URI of the view model.
+
+
+</td></tr>
+<tr><td>
+
+[viewModelYawsWithCamera](./server.playercamera.viewmodelyawswithcamera.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+Whether the view model yaws left/right with the camera orientation.
 
 \*\*Category:\*\* Players
 
@@ -461,7 +606,7 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
-[lookAtEntity(entity)](./server.playercamera.lookatentity.md)
+[faceEntity(entity)](./server.playercamera.faceentity.md)
 
 
 </td><td>
@@ -477,7 +622,7 @@ Use for: one-off focus moments (e.g., cutscene beats). Do NOT use for: continuou
 </td></tr>
 <tr><td>
 
-[lookAtPosition(position)](./server.playercamera.lookatposition.md)
+[facePosition(position)](./server.playercamera.faceposition.md)
 
 
 </td><td>
@@ -538,6 +683,20 @@ Attaches the camera to a world position.
 Use for: fixed cameras or cinematic shots. Do NOT use for: tracking a moving target; use `PlayerCamera.setTrackedPosition`<!-- -->.
 
 
+</td></tr>
+<tr><td>
+
+[setCollidesWithBlocks(collidesWithBlocks)](./server.playercamera.setcollideswithblocks.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Sets whether the camera collides with blocks instead of clipping through them.
+
+
 </td></tr>
 <tr><td>
 
@@ -549,7 +708,7 @@ Use for: fixed cameras or cinematic shots. Do NOT use for: tracking a moving tar
 
 </td><td>
 
-Sets the film offset of the camera.
+Sets the film offset of the camera. A positive value shifts the camera right, a negative value shifts it left.
 
 
 </td></tr>
@@ -597,7 +756,7 @@ Sets the mode of the camera.
 </td></tr>
 <tr><td>
 
-[setModelHiddenNodes(modelHiddenNodes)](./server.playercamera.setmodelhiddennodes.md)
+[setOffset(offset)](./server.playercamera.setoffset.md)
 
 
 </td><td>
@@ -605,13 +764,13 @@ Sets the mode of the camera.
 
 </td><td>
 
-Sets model nodes that will not be rendered for this player.
+Sets the relative offset of the camera from its attachment target.
 
 
 </td></tr>
 <tr><td>
 
-[setModelShownNodes(modelShownNodes)](./server.playercamera.setmodelshownnodes.md)
+[setShoulderAngle(shoulderAngle)](./server.playercamera.setshoulderangle.md)
 
 
 </td><td>
@@ -619,13 +778,13 @@ Sets model nodes that will not be rendered for this player.
 
 </td><td>
 
-Sets model nodes that will be rendered for this player, overriding hidden nodes.
+Sets the shoulder angle of the camera in degrees (third-person mode only).
 
 
 </td></tr>
 <tr><td>
 
-[setOffset(offset)](./server.playercamera.setoffset.md)
+[setTargetEntity(entity)](./server.playercamera.settargetentity.md)
 
 
 </td><td>
@@ -633,13 +792,15 @@ Sets model nodes that will be rendered for this player, overriding hidden nodes.
 
 </td><td>
 
-Sets the relative offset of the camera from its attachment target.
+Sets the entity the camera will continuously look at.
+
+Use for: keeping the camera focused on a moving entity.
 
 
 </td></tr>
 <tr><td>
 
-[setShoulderAngle(shoulderAngle)](./server.playercamera.setshoulderangle.md)
+[setTargetPosition(position)](./server.playercamera.settargetposition.md)
 
 
 </td><td>
@@ -647,13 +808,15 @@ Sets the relative offset of the camera from its attachment target.
 
 </td><td>
 
-Sets the shoulder angle of the camera in degrees (third-person mode only).
+Sets the position the camera will continuously look at.
+
+Use for: fixed focal points in the scene.
 
 
 </td></tr>
 <tr><td>
 
-[setTrackedEntity(entity)](./server.playercamera.settrackedentity.md)
+[setViewModel(viewModelUri)](./server.playercamera.setviewmodel.md)
 
 
 </td><td>
@@ -661,15 +824,27 @@ Sets the shoulder angle of the camera in degrees (third-person mode only).
 
 </td><td>
 
-Sets the entity the camera will continuously look at.
+Sets a view model for first-person rendering.
 
-Use for: keeping the camera focused on a moving entity.
+
+</td></tr>
+<tr><td>
+
+[setViewModelHiddenNodes(viewModelHiddenNodes)](./server.playercamera.setviewmodelhiddennodes.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Hides nodes on the view model (or attached entity's model if no view model is set).
 
 
 </td></tr>
 <tr><td>
 
-[setTrackedPosition(position)](./server.playercamera.settrackedposition.md)
+[setViewModelPitchesWithCamera(viewModelPitchesWithCamera)](./server.playercamera.setviewmodelpitcheswithcamera.md)
 
 
 </td><td>
@@ -677,9 +852,35 @@ Use for: keeping the camera focused on a moving entity.
 
 </td><td>
 
-Sets the position the camera will continuously look at.
+Sets whether the view model pitches up/down with the camera orientation.
 
-Use for: fixed focal points in the scene.
+
+</td></tr>
+<tr><td>
+
+[setViewModelShownNodes(viewModelShownNodes)](./server.playercamera.setviewmodelshownnodes.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Shows nodes on the view model (or attached entity's model if no view model is set), overriding hidden nodes.
+
+
+</td></tr>
+<tr><td>
+
+[setViewModelYawsWithCamera(viewModelYawsWithCamera)](./server.playercamera.setviewmodelyawswithcamera.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Sets whether the view model yaws left/right with the camera orientation.
 
 
 </td></tr>

package/docs/server.playercamera.setcollideswithblocks.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; [PlayerCamera](./server.playercamera.md) &gt; [setCollidesWithBlocks](./server.playercamera.setcollideswithblocks.md)
+
+## PlayerCamera.setCollidesWithBlocks() method
+
+Sets whether the camera collides with blocks instead of clipping through them.
+
+**Signature:**
+
+```typescript
+setCollidesWithBlocks(collidesWithBlocks: boolean): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+collidesWithBlocks
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+Whether the camera should collide with blocks.
+
+\*\*Category:\*\* Players
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.playercamera.setfilmoffset.md

@@ -4,7 +4,7 @@
 
 ## PlayerCamera.setFilmOffset() method
 
-Sets the film offset of the camera.
+Sets the film offset of the camera. A positive value shifts the camera right, a negative value shifts it left.
 
 **Signature:**
 
@@ -57,7 +57,3 @@ The film offset to set.
 
 void
 
-## Remarks
-
-Positive shifts right, negative shifts left.
-

package/docs/{server.playercamera.settrackedentity.md → server.playercamera.settargetentity.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; [setTrackedEntity](./server.playercamera.settrackedentity.md)
+[Home](./index.md) &gt; [server](./server.md) &gt; [PlayerCamera](./server.playercamera.md) &gt; [setTargetEntity](./server.playercamera.settargetentity.md)
 
-## PlayerCamera.setTrackedEntity() method
+## PlayerCamera.setTargetEntity() method
 
 Sets the entity the camera will continuously look at.
 
@@ -11,7 +11,7 @@ Use for: keeping the camera focused on a moving entity.
 **Signature:**
 
 ```typescript
-setTrackedEntity(entity: Entity | undefined): void;
+setTargetEntity(entity: Entity | undefined): void;
 ```
 
 ## Parameters

package/docs/{server.playercamera.settrackedposition.md → server.playercamera.settargetposition.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; [setTrackedPosition](./server.playercamera.settrackedposition.md)
+[Home](./index.md) &gt; [server](./server.md) &gt; [PlayerCamera](./server.playercamera.md) &gt; [setTargetPosition](./server.playercamera.settargetposition.md)
 
-## PlayerCamera.setTrackedPosition() method
+## PlayerCamera.setTargetPosition() method
 
 Sets the position the camera will continuously look at.
 
@@ -11,7 +11,7 @@ Use for: fixed focal points in the scene.
 **Signature:**
 
 ```typescript
-setTrackedPosition(position: Vector3Like | undefined): void;
+setTargetPosition(position: Vector3Like | undefined): void;
 ```
 
 ## Parameters