hytopia 0.1.27 → 0.1.29

package/docs/server.basecharactercontroller.md

@@ -96,7 +96,7 @@ The entity the controller is for.
 </td></tr>
 <tr><td>
 
-[onTickPathfindingMovement?](./server.basecharactercontroller.ontickpathfindingmovement.md)
+[onTick?](./server.basecharactercontroller.ontick.md)
 
 
 </td><td>
@@ -104,12 +104,12 @@ The entity the controller is for.
 
 </td><td>
 
-(destination: [Vector3](./server.vector3.md)<!-- -->, deltaTimeMs: number) =&gt; void
+(deltaTimeMs: number) =&gt; void
 
 
 </td><td>
 
-_(Optional)_ A callback function for when the controller ticks pathfinding movement.
+_(Optional)_ A callback function for when the controller ticks.
 
 
 </td></tr>
@@ -168,7 +168,7 @@ Override this method to create sensor colliders to be attached to the controlled
 </td></tr>
 <tr><td>
 
-[tickPathfindingMovement(destination, deltaTimeMs)](./server.basecharactercontroller.tickpathfindingmovement.md)
+[tick(deltaTimeMs)](./server.basecharactercontroller.tick.md)
 
 
 </td><td>
@@ -176,7 +176,7 @@ Override this method to create sensor colliders to be attached to the controlled
 
 </td><td>
 
-Override this method to implement pathfinding movement logic for your character controller. NOTE: This method is not fully supported yet.
+Override this method to handle entity movements based on your character controller.
 
 
 </td></tr>

package/docs/server.basecharactercontroller.ontick.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; [BaseCharacterController](./server.basecharactercontroller.md) &gt; [onTick](./server.basecharactercontroller.ontick.md)
+
+## BaseCharacterController.onTick property
+
+A callback function for when the controller ticks.
+
+**Signature:**
+
+```typescript
+onTick?: (deltaTimeMs: number) => void;
+```

package/docs/server.basecharactercontroller.tick.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; [BaseCharacterController](./server.basecharactercontroller.md) &gt; [tick](./server.basecharactercontroller.tick.md)
+
+## BaseCharacterController.tick() method
+
+Override this method to handle entity movements based on your character controller.
+
+**Signature:**
+
+```typescript
+tick(deltaTimeMs: number): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+deltaTimeMs
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+The delta time in milliseconds since the last tick.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.defaultcharactercontroller.md

@@ -301,20 +301,6 @@ Description
 Creates the sensor colliders for the character controller, overriding the default implementation.
 
 
-</td></tr>
-<tr><td>
-
-[tickPathfindingMovement(destination, deltaTimeMs)](./server.defaultcharactercontroller.tickpathfindingmovement.md)
-
-
-</td><td>
-
-
-</td><td>
-
-Ticks the pathfinding movement for the character controller, overriding the default implementation.
-
-
 </td></tr>
 <tr><td>
 

package/docs/server.facecallback.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; [FaceCallback](./server.facecallback.md)
+
+## FaceCallback type
+
+A callback function called when the entity associated with the SimpleCharacterController updates its rotation as it is attempting to face a target coordinate.
+
+**Signature:**
+
+```typescript
+export type FaceCallback = (currentRotation: Rotation, targetRotation: Rotation) => void;
+```
+**References:** [Rotation](./server.rotation.md)
+

package/docs/server.facecompletecallback.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; [FaceCompleteCallback](./server.facecompletecallback.md)
+
+## FaceCompleteCallback type
+
+A callback function called when the entity associated with the SimpleCharacterController finishes rotating and is now facing a target coordinate.
+
+**Signature:**
+
+```typescript
+export type FaceCompleteCallback = (endRotation: Rotation) => void;
+```
+**References:** [Rotation](./server.rotation.md)
+

package/docs/server.faceoptions.md

@@ -0,0 +1,18 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [FaceOptions](./server.faceoptions.md)
+
+## FaceOptions type
+
+Options for the [SimpleCharacterController.face()](./server.simplecharactercontroller.face.md) method.
+
+**Signature:**
+
+```typescript
+export type FaceOptions = {
+    faceCallback?: FaceCallback;
+    faceCompleteCallback?: FaceCompleteCallback;
+};
+```
+**References:** [FaceCallback](./server.facecallback.md)<!-- -->, [FaceCompleteCallback](./server.facecompletecallback.md)
+

package/docs/server.hytopia.basecharactercontroller.md

@@ -96,7 +96,7 @@ The entity the controller is for.
 </td></tr>
 <tr><td>
 
-[onTickPathfindingMovement?](./server.hytopia.basecharactercontroller.ontickpathfindingmovement.md)
+[onTick?](./server.hytopia.basecharactercontroller.ontick.md)
 
 
 </td><td>
@@ -104,12 +104,12 @@ The entity the controller is for.
 
 </td><td>
 
-(destination: [Vector3](./server.vector3.md)<!-- -->, deltaTimeMs: number) =&gt; void
+(deltaTimeMs: number) =&gt; void
 
 
 </td><td>
 
-_(Optional)_ A callback function for when the controller ticks pathfinding movement.
+_(Optional)_ A callback function for when the controller ticks.
 
 
 </td></tr>
@@ -168,7 +168,7 @@ Override this method to create sensor colliders to be attached to the controlled
 </td></tr>
 <tr><td>
 
-[tickPathfindingMovement(destination, deltaTimeMs)](./server.hytopia.basecharactercontroller.tickpathfindingmovement.md)
+[tick(deltaTimeMs)](./server.hytopia.basecharactercontroller.tick.md)
 
 
 </td><td>
@@ -176,7 +176,7 @@ Override this method to create sensor colliders to be attached to the controlled
 
 </td><td>
 
-Override this method to implement pathfinding movement logic for your character controller. NOTE: This method is not fully supported yet.
+Override this method to handle entity movements based on your character controller.
 
 
 </td></tr>

package/docs/server.hytopia.basecharactercontroller.ontick.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; [HYTOPIA](./server.hytopia.md) &gt; [BaseCharacterController](./server.hytopia.basecharactercontroller.md) &gt; [onTick](./server.hytopia.basecharactercontroller.ontick.md)
+
+## HYTOPIA.BaseCharacterController.onTick property
+
+A callback function for when the controller ticks.
+
+**Signature:**
+
+```typescript
+onTick?: (deltaTimeMs: number) => void;
+```

package/docs/server.hytopia.basecharactercontroller.tick.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; [HYTOPIA](./server.hytopia.md) &gt; [BaseCharacterController](./server.hytopia.basecharactercontroller.md) &gt; [tick](./server.hytopia.basecharactercontroller.tick.md)
+
+## HYTOPIA.BaseCharacterController.tick() method
+
+Override this method to handle entity movements based on your character controller.
+
+**Signature:**
+
+```typescript
+tick(deltaTimeMs: number): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+deltaTimeMs
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+The delta time in milliseconds since the last tick.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.hytopia.defaultcharactercontroller.md

@@ -301,20 +301,6 @@ Description
 Creates the sensor colliders for the character controller, overriding the default implementation.
 
 
-</td></tr>
-<tr><td>
-
-[tickPathfindingMovement(destination, deltaTimeMs)](./server.hytopia.defaultcharactercontroller.tickpathfindingmovement.md)
-
-
-</td><td>
-
-
-</td><td>
-
-Ticks the pathfinding movement for the character controller, overriding the default implementation.
-
-
 </td></tr>
 <tr><td>
 

package/docs/server.hytopia.facecallback.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; [HYTOPIA](./server.hytopia.md) &gt; [FaceCallback](./server.hytopia.facecallback.md)
+
+## HYTOPIA.FaceCallback type
+
+A callback function called when the entity associated with the SimpleCharacterController updates its rotation as it is attempting to face a target coordinate.
+
+**Signature:**
+
+```typescript
+export type FaceCallback = (currentRotation: Rotation, targetRotation: Rotation) => void;
+```
+**References:** [Rotation](./server.rotation.md)
+

package/docs/server.hytopia.facecompletecallback.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; [HYTOPIA](./server.hytopia.md) &gt; [FaceCompleteCallback](./server.hytopia.facecompletecallback.md)
+
+## HYTOPIA.FaceCompleteCallback type
+
+A callback function called when the entity associated with the SimpleCharacterController finishes rotating and is now facing a target coordinate.
+
+**Signature:**
+
+```typescript
+export type FaceCompleteCallback = (endRotation: Rotation) => void;
+```
+**References:** [Rotation](./server.rotation.md)
+

package/docs/server.hytopia.faceoptions.md

@@ -0,0 +1,18 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [HYTOPIA](./server.hytopia.md) &gt; [FaceOptions](./server.hytopia.faceoptions.md)
+
+## HYTOPIA.FaceOptions type
+
+Options for the [SimpleCharacterController.face()](./server.simplecharactercontroller.face.md) method.
+
+**Signature:**
+
+```typescript
+export type FaceOptions = {
+    faceCallback?: FaceCallback;
+    faceCompleteCallback?: FaceCompleteCallback;
+};
+```
+**References:** [FaceCallback](./server.facecallback.md)<!-- -->, [FaceCompleteCallback](./server.facecompletecallback.md)
+

package/docs/server.hytopia.md

@@ -225,6 +225,17 @@ Manages all connected players in a game server.
 Represents a rigid body in a world's physics simulation.
 
 
+</td></tr>
+<tr><td>
+
+[SimpleCharacterController](./server.hytopia.simplecharactercontroller.md)
+
+
+</td><td>
+
+A simple character controller with basic movement functions.
+
+
 </td></tr>
 <tr><td>
 
@@ -836,6 +847,72 @@ A callback function for a chat command.
 A decoded set of collision groups represented as their string equivalents.
 
 
+</td></tr>
+<tr><td>
+
+[FaceCallback](./server.hytopia.facecallback.md)
+
+
+</td><td>
+
+A callback function called when the entity associated with the SimpleCharacterController updates its rotation as it is attempting to face a target coordinate.
+
+
+</td></tr>
+<tr><td>
+
+[FaceCompleteCallback](./server.hytopia.facecompletecallback.md)
+
+
+</td><td>
+
+A callback function called when the entity associated with the SimpleCharacterController finishes rotating and is now facing a target coordinate.
+
+
+</td></tr>
+<tr><td>
+
+[FaceOptions](./server.hytopia.faceoptions.md)
+
+
+</td><td>
+
+Options for the [SimpleCharacterController.face()](./server.simplecharactercontroller.face.md) method.
+
+
+</td></tr>
+<tr><td>
+
+[MoveCallback](./server.hytopia.movecallback.md)
+
+
+</td><td>
+
+A callback function called when the entity associated with the SimpleCharacterController updates its translation as it is attempting to move to a target coordinate.
+
+
+</td></tr>
+<tr><td>
+
+[MoveCompleteCallback](./server.hytopia.movecompletecallback.md)
+
+
+</td><td>
+
+A callback function called when the entity associated with the SimpleCharacterController reaches the target coordinate. An entity must reach the x,y,z coordinate for the callback to be called.
+
+
+</td></tr>
+<tr><td>
+
+[MoveOptions](./server.hytopia.moveoptions.md)
+
+
+</td><td>
+
+Options for the [SimpleCharacterController.move()](./server.simplecharactercontroller.move.md) method.
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.hytopia.movecallback.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; [HYTOPIA](./server.hytopia.md) &gt; [MoveCallback](./server.hytopia.movecallback.md)
+
+## HYTOPIA.MoveCallback type
+
+A callback function called when the entity associated with the SimpleCharacterController updates its translation as it is attempting to move to a target coordinate.
+
+**Signature:**
+
+```typescript
+export type MoveCallback = (currentTranslation: Vector3, targetTranslation: Vector3) => void;
+```
+**References:** [Vector3](./server.vector3.md)
+

package/docs/server.hytopia.movecompletecallback.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; [HYTOPIA](./server.hytopia.md) &gt; [MoveCompleteCallback](./server.hytopia.movecompletecallback.md)
+
+## HYTOPIA.MoveCompleteCallback type
+
+A callback function called when the entity associated with the SimpleCharacterController reaches the target coordinate. An entity must reach the x,y,z coordinate for the callback to be called.
+
+**Signature:**
+
+```typescript
+export type MoveCompleteCallback = (endTranslation: Vector3) => void;
+```
+**References:** [Vector3](./server.vector3.md)
+

package/docs/server.hytopia.moveoptions.md

@@ -0,0 +1,18 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [HYTOPIA](./server.hytopia.md) &gt; [MoveOptions](./server.hytopia.moveoptions.md)
+
+## HYTOPIA.MoveOptions type
+
+Options for the [SimpleCharacterController.move()](./server.simplecharactercontroller.move.md) method.
+
+**Signature:**
+
+```typescript
+export type MoveOptions = {
+    moveCallback?: MoveCallback;
+    moveCompleteCallback?: MoveCompleteCallback;
+};
+```
+**References:** [MoveCallback](./server.movecallback.md)<!-- -->, [MoveCompleteCallback](./server.movecompletecallback.md)
+

package/docs/server.hytopia.simplecharactercontroller.face.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; [HYTOPIA](./server.hytopia.md) &gt; [SimpleCharacterController](./server.hytopia.simplecharactercontroller.md) &gt; [face](./server.hytopia.simplecharactercontroller.face.md)
+
+## HYTOPIA.SimpleCharacterController.face() method
+
+Rotates the entity at a given speed to face a target coordinate.
+
+**Signature:**
+
+```typescript
+face(target: Vector3, speed: number, options?: FaceOptions): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+target
+
+
+</td><td>
+
+[Vector3](./server.vector3.md)
+
+
+</td><td>
+
+The target coordinate to face.
+
+
+</td></tr>
+<tr><td>
+
+speed
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+The speed at which to rotate to the target coordinate.
+
+
+</td></tr>
+<tr><td>
+
+options
+
+
+</td><td>
+
+[FaceOptions](./server.faceoptions.md)
+
+
+</td><td>
+
+_(Optional)_ Additional options for the face operation, such as callbacks.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+
+## Remarks
+
+If this method is called while the entity is already attempting to face another target, the previous target will be ignored and the entity will start attempting to face the new target.
+

package/docs/server.hytopia.simplecharactercontroller.md

@@ -0,0 +1,88 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [HYTOPIA](./server.hytopia.md) &gt; [SimpleCharacterController](./server.hytopia.simplecharactercontroller.md)
+
+## HYTOPIA.SimpleCharacterController class
+
+A simple character controller with basic movement functions.
+
+**Signature:**
+
+```typescript
+export default class SimpleCharacterController extends BaseCharacterController 
+```
+**Extends:** [BaseCharacterController](./server.basecharactercontroller.md)
+
+## Remarks
+
+This class implements simple movement methods that serve as a way to add realistic movement and rotational facing functionality to an entity. This is also a great base to extend for your own more complex character controller that implements things like pathfinding.
+
+## Example
+
+
+```typescript
+// Create a custom character controller for myEntity, prior to spawning it.
+myEntity.createCustomCharacterController = () => {
+  return new SimpleCharacterController(myEntity);
+};
+
+// Spawn the entity in the world.
+myEntity.spawn(world, { x: 53, y: 10, z: 23 });
+
+// Move the entity at a speed of 4 blocks
+// per second to the coordinate (10, 1, 10).
+// console.log when we reach the target.
+myEntity.characterController.move({ x: 10, y: 1, z: 10 }, 4, {
+  moveCompleteCallback: endPosition => {
+    console.log('Finished moving to', endPosition);
+  },
+});
+```
+
+## Methods
+
+<table><thead><tr><th>
+
+Method
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[face(target, speed, options)](./server.hytopia.simplecharactercontroller.face.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Rotates the entity at a given speed to face a target coordinate.
+
+
+</td></tr>
+<tr><td>
+
+[move(target, speed, options)](./server.hytopia.simplecharactercontroller.move.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Moves the entity at a given speed in a straight line to a target coordinate.
+
+
+</td></tr>
+</tbody></table>