hytopia 0.1.26 → 0.1.29

package/README.md

@@ -1,7 +1,7 @@
 # HYTOPIA SDK
 
 ## Quick Links
-[Quickstart](#quickstart) • [API Reference](./docs/server.md) • [Examples](./examples) • [Join Our Developer Discord](https://discord.gg/hytopia-developers) • [Report Bugs or Request Features](https://github.com/hytopiagg/sdk/issues)
+[Quickstart](#quickstart) • [Developer Docs](https://dev.hytopia.com/) • [API Reference](./docs/server.md) • [Examples](./examples) • [Join Our Developer Discord](https://discord.gg/hytopia-developers) • [Report Bugs or Request Features](https://github.com/hytopiagg/sdk/issues)
 
 ## What is HYTOPIA?
 
@@ -56,6 +56,7 @@ bun --watch index.ts
 **Note: If you'd prefer to use JavaScript instead of TypeScript, simply change the file extension of index.ts to index.js - Your editor will highlight the TypeScript syntax errors, simple delete the type annotations and everything should work the same without any TypeScript usage.**
 
 Once you're up and running, here's some other resources to go further:
+- [Developer Docs](https://dev.hytopia.com/)
 - [Game Examples](./examples)
 - [API Reference](./docs/server.md)
 

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>
 
@@ -420,6 +431,17 @@ Event types a Player can emit.
 The types a RigidBody can be.
 
 
+</td></tr>
+<tr><td>
+
+[WorldLoopEventType](./server.hytopia.worldloopeventtype.md)
+
+
+</td><td>
+
+Event types a WorldLoop instance can emit.
+
+
 </td></tr>
 </tbody></table>
 
@@ -707,6 +729,17 @@ Payloads for events emitted by a GameServer instance.
 Payloads for events a Player can emit.
 
 
+</td></tr>
+<tr><td>
+
+[WorldLoopEventPayload](./server.hytopia.worldloopeventpayload.md)
+
+
+</td><td>
+
+Payloads for events emitted by a WorldLoop instance.
+
+
 </td></tr>
 </tbody></table>
 
@@ -814,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.
+