hytopia 0.1.27 → 0.1.30

package/docs/server.hytopia.defaultcharactercontroller.md

@@ -101,7 +101,7 @@ Description
 
 </td><td>
 
-(this: [DefaultCharacterController](./server.defaultcharactercontroller.md)<!-- -->) =&gt; boolean
+(defaultCharacterController: [DefaultCharacterController](./server.defaultcharactercontroller.md)<!-- -->) =&gt; boolean
 
 
 </td><td>
@@ -120,7 +120,7 @@ A function allowing custom logic to determine if the entity can jump.
 
 </td><td>
 
-(this: [DefaultCharacterController](./server.defaultcharactercontroller.md)<!-- -->) =&gt; boolean
+(defaultCharacterController: [DefaultCharacterController](./server.defaultcharactercontroller.md)<!-- -->) =&gt; boolean
 
 
 </td><td>
@@ -139,7 +139,7 @@ A function allowing custom logic to determine if the entity can run.
 
 </td><td>
 
-(this: [DefaultCharacterController](./server.defaultcharactercontroller.md)<!-- -->) =&gt; boolean
+(defaultCharacterController: [DefaultCharacterController](./server.defaultcharactercontroller.md)<!-- -->) =&gt; boolean
 
 
 </td><td>
@@ -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.entity.createcustomcharactercontroller.md

@@ -4,10 +4,10 @@
 
 ## HYTOPIA.Entity.createCustomCharacterController property
 
-A function that creates a custom character controller for the entity.
+A function that creates a custom character controller for the entity when it spawns.
 
 **Signature:**
 
 ```typescript
-createCustomCharacterController?: (this: Entity) => BaseCharacterController;
+createCustomCharacterController?: (entity: Entity) => BaseCharacterController;
 ```

package/docs/server.hytopia.entity.md

@@ -133,12 +133,12 @@ The character controller for the entity.
 
 </td><td>
 
-(this: [Entity](./server.entity.md)<!-- -->) =&gt; [BaseCharacterController](./server.basecharactercontroller.md)
+(entity: [Entity](./server.entity.md)<!-- -->) =&gt; [BaseCharacterController](./server.basecharactercontroller.md)
 
 
 </td><td>
 
-_(Optional)_ A function that creates a custom character controller for the entity.
+_(Optional)_ A function that creates a custom character controller for the entity when it spawns.
 
 
 </td></tr>
@@ -278,7 +278,7 @@ The name of the entity.
 
 </td><td>
 
-(this: [Entity](./server.entity.md)<!-- -->, block: [BlockType](./server.blocktype.md)<!-- -->, started: boolean) =&gt; void
+(entity: [Entity](./server.entity.md)<!-- -->, block: [BlockType](./server.blocktype.md)<!-- -->, started: boolean) =&gt; void
 
 
 </td><td>
@@ -297,7 +297,7 @@ _(Optional)_ A function that is called when the entity collides with a block.
 
 </td><td>
 
-(this: [Entity](./server.entity.md)<!-- -->, block: [BlockType](./server.blocktype.md)<!-- -->, contactForceData: ContactForceData) =&gt; void
+(entity: [Entity](./server.entity.md)<!-- -->, block: [BlockType](./server.blocktype.md)<!-- -->, contactForceData: ContactForceData) =&gt; void
 
 
 </td><td>
@@ -316,7 +316,7 @@ _(Optional)_ A function that is called when the entity collides with a block.
 
 </td><td>
 
-(this: [Entity](./server.entity.md)<!-- -->) =&gt; void
+(entity: [Entity](./server.entity.md)<!-- -->) =&gt; void
 
 
 </td><td>
@@ -335,7 +335,7 @@ _(Optional)_ A function that is called when the entity is despawned.
 
 </td><td>
 
-(this: [Entity](./server.entity.md)<!-- -->, entity: [Entity](./server.entity.md)<!-- -->, started: boolean) =&gt; void
+(entity: [Entity](./server.entity.md)<!-- -->, otherEntity: [Entity](./server.entity.md)<!-- -->, started: boolean) =&gt; void
 
 
 </td><td>
@@ -354,7 +354,7 @@ _(Optional)_ A function that is called when the entity collides with another ent
 
 </td><td>
 
-(this: [Entity](./server.entity.md)<!-- -->, entity: [Entity](./server.entity.md)<!-- -->, contactForceData: ContactForceData) =&gt; void
+(entity: [Entity](./server.entity.md)<!-- -->, otherEntity: [Entity](./server.entity.md)<!-- -->, contactForceData: ContactForceData) =&gt; void
 
 
 </td><td>
@@ -373,7 +373,7 @@ _(Optional)_ A function that is called when the entity contacts another entity.
 
 </td><td>
 
-(this: [Entity](./server.entity.md)<!-- -->) =&gt; void
+(entity: [Entity](./server.entity.md)<!-- -->) =&gt; void
 
 
 </td><td>
@@ -392,7 +392,7 @@ _(Optional)_ A function that is called when the entity is spawned.
 
 </td><td>
 
-(this: [Entity](./server.entity.md)<!-- -->, tickDeltaMs: number) =&gt; void
+(entity: [Entity](./server.entity.md)<!-- -->, tickDeltaMs: number) =&gt; void
 
 
 </td><td>

package/docs/server.hytopia.entity.onblockcollision.md

@@ -9,5 +9,5 @@ A function that is called when the entity collides with a block.
 **Signature:**
 
 ```typescript
-onBlockCollision?: (this: Entity, block: BlockType, started: boolean) => void;
+onBlockCollision?: (entity: Entity, block: BlockType, started: boolean) => void;
 ```

package/docs/server.hytopia.entity.onblockcontactforce.md

@@ -9,5 +9,5 @@ A function that is called when the entity collides with a block.
 **Signature:**
 
 ```typescript
-onBlockContactForce?: (this: Entity, block: BlockType, contactForceData: ContactForceData) => void;
+onBlockContactForce?: (entity: Entity, block: BlockType, contactForceData: ContactForceData) => void;
 ```

package/docs/server.hytopia.entity.ondespawn.md

@@ -9,5 +9,5 @@ A function that is called when the entity is despawned.
 **Signature:**
 
 ```typescript
-onDespawn?: (this: Entity) => void;
+onDespawn?: (entity: Entity) => void;
 ```

package/docs/server.hytopia.entity.onentitycollision.md

@@ -9,5 +9,5 @@ A function that is called when the entity collides with another entity.
 **Signature:**
 
 ```typescript
-onEntityCollision?: (this: Entity, entity: Entity, started: boolean) => void;
+onEntityCollision?: (entity: Entity, otherEntity: Entity, started: boolean) => void;
 ```

package/docs/server.hytopia.entity.onentitycontactforce.md

@@ -9,5 +9,5 @@ A function that is called when the entity contacts another entity.
 **Signature:**
 
 ```typescript
-onEntityContactForce?: (this: Entity, entity: Entity, contactForceData: ContactForceData) => void;
+onEntityContactForce?: (entity: Entity, otherEntity: Entity, contactForceData: ContactForceData) => void;
 ```

package/docs/server.hytopia.entity.onspawn.md

@@ -9,5 +9,5 @@ A function that is called when the entity is spawned.
 **Signature:**
 
 ```typescript
-onSpawn?: (this: Entity) => void;
+onSpawn?: (entity: Entity) => void;
 ```

package/docs/server.hytopia.entity.ontick.md

@@ -9,5 +9,5 @@ A function that is called every tick.
 **Signature:**
 
 ```typescript
-onTick?: (this: Entity, tickDeltaMs: number) => void;
+onTick?: (entity: Entity, tickDeltaMs: number) => void;
 ```

package/docs/server.hytopia.entityoptions.createcustomcharactercontroller.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; [EntityOptions](./server.hytopia.entityoptions.md) &gt; [createCustomCharacterController](./server.hytopia.entityoptions.createcustomcharactercontroller.md)
+
+## HYTOPIA.EntityOptions.createCustomCharacterController property
+
+A function that creates a custom character controller for the entity when it spawns.
+
+**Signature:**
+
+```typescript
+createCustomCharacterController?: (entity: Entity) => BaseCharacterController;
+```

package/docs/server.hytopia.entityoptions.md

@@ -37,6 +37,25 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[createCustomCharacterController?](./server.hytopia.entityoptions.createcustomcharactercontroller.md)
+
+
+</td><td>
+
+
+</td><td>
+
+(entity: [Entity](./server.entity.md)<!-- -->) =&gt; [BaseCharacterController](./server.basecharactercontroller.md)
+
+
+</td><td>
+
+_(Optional)_ A function that creates a custom character controller for the entity when it spawns.
+
+
+</td></tr>
+<tr><td>
+
 [modelLoopedAnimations?](./server.hytopia.entityoptions.modelloopedanimations.md)
 
 

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,23 @@
+<!-- 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;
+    moveIgnoreAxes?: {
+        x?: boolean;
+        y?: boolean;
+        z?: boolean;
+    };
+};
+```
+**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. Compatible with entities that have kinematic or dynamic rigid body types.
+
+## 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>