hytopia 0.1.34 → 0.1.36

package/server.d.ts

@@ -23,7 +23,7 @@ import { WebSocket as WebSocket_2 } from 'ws';
  * @example
  * ```typescript
  * (new Audio({
- *   uri: 'assets/music/song.mp3',
+ *   uri: 'music/song.mp3', // relative to the server's assets directory in the project root, resolves to assets/music/song.mp3
  *   loop: true,
  *   volume: 0.5,
  * })).play(world);
@@ -365,7 +365,7 @@ export declare class Block {
  * const stoneBlockTypeId = 10;
  * world.blockTypeRegistry.registerBlockType(stoneBlockTypeId, new BlockType({
  *   id: stoneBlockTypeId,
- *   textureUri: 'assets/textures/stone.png',
+ *   textureUri: 'textures/stone.png',
  *   name: 'Stone',
  * }));
  *
@@ -435,7 +435,7 @@ export declare interface BlockTypeOptions {
  * ```typescript
  * world.blockTypeRegistry.registerGenericBlockType({
  *   id: 15,
- *   textureUri: 'assets/textures/dirt.png',
+ *   textureUri: 'textures/dirt.png',
  *   name: 'Dirt',
  * });
  * ```
@@ -467,10 +467,9 @@ export declare class BlockTypeRegistry implements protocol.Serializable {
     registerGenericBlockType(blockTypeOptions: BlockTypeOptions): BlockType;
     /**
      * Register a block type.
-     * @param id - The id of the block type to register.
-     * @param blockTypeReference - The block type to register.
+     * @param blockType - The block type to register.
      */
-    registerBlockType(id: number, blockTypeReference: BlockType): void;
+    registerBlockType(blockType: BlockType): void;
 
 }
 
@@ -664,6 +663,18 @@ export declare class Chunk implements protocol.Serializable {
      * Despawn the chunk from the world.
      */
     despawn(): void;
+    /**
+     * Get the block type id at a specific local coordinate.
+     * @param localCoordinate - The local coordinate of the block to get.
+     * @returns The block type id.
+     */
+    getBlock(localCoordinate: Vector3): number;
+    /**
+     * Check if a block exists at a specific local coordinate.
+     * @param localCoordinate - The local coordinate of the block to check.
+     * @returns Whether a block exists.
+     */
+    hasBlock(localCoordinate: Vector3): boolean;
     /**
      * Set the block at a specific local coordinate by block type id.
      * @param localCoordinate - The local coordinate of the block to set.
@@ -721,6 +732,12 @@ export declare class ChunkLattice {
     constructor(world: World);
 
 
+    /**
+     * Get the block type id at a specific global coordinate.
+     * @param globalCoordinate - The global coordinate of the block to get.
+     * @returns The block type id, 0 if no block is set.
+     */
+    getBlock(globalCoordinate: Vector3): number;
     /**
      * Get a chunk by its origin coordinate.
      * @param originCoordinate - The origin coordinate of the chunk to get.
@@ -732,6 +749,12 @@ export declare class ChunkLattice {
      * @returns An array of all chunks in the lattice.
      */
     getAllChunks(): Chunk[];
+    /**
+     * Check if a block exists at a specific global coordinate.
+     * @param globalCoordinate - The global coordinate of the block to check.
+     * @returns Whether a block exists.
+     */
+    hasBlock(globalCoordinate: Vector3): boolean;
     /**
      * Check if a chunk exists by its origin coordinate.
      * @param originCoordinate - The origin coordinate of the chunk to check.
@@ -740,9 +763,9 @@ export declare class ChunkLattice {
     hasChunk(originCoordinate: Vector3): boolean;
     /**
      * Set the block at a global coordinate by block type id, automatically
-     * creating a chunk if it doesn't exist.
+     * creating a chunk if it doesn't exist. Use block type id 0 for air.
      * @param globalCoordinate - The global coordinate of the block to set.
-     * @param blockTypeId - The block type id to set.
+     * @param blockTypeId - The block type id to set. Use 0 to remove the block and replace with air.
      */
     setBlock(globalCoordinate: Vector3, blockTypeId: number): void;
 
@@ -1269,6 +1292,7 @@ export declare class Entity extends RigidBody implements protocol.Serializable {
 
 
 
+
     /**
      * @param options - The options for the entity.
      */
@@ -1291,6 +1315,8 @@ export declare class Entity extends RigidBody implements protocol.Serializable {
     get name(): string;
     /** An arbitrary identifier tag of the entity. Useful for your own logic. */
     get tag(): string | undefined;
+    /** The tint color of the entity. */
+    get tintColor(): RgbColor | undefined;
     /** Whether the entity is spawned. */
     get isSpawned(): boolean;
     /** The world the entity is in. */
@@ -1310,6 +1336,11 @@ export declare class Entity extends RigidBody implements protocol.Serializable {
      * @param characterController - The character controller to set.
      */
     setCharacterController(characterController: BaseCharacterController): void;
+    /**
+     * Sets the tint color of the entity.
+     * @param tintColor - The tint color of the entity.
+     */
+    setTintColor(tintColor: RgbColor | undefined): void;
     /**
      * Starts looped animations for the entity, blending with
      * other animations currently playing.
@@ -1341,6 +1372,10 @@ export declare namespace EntityEventPayload {
     export interface Despawn {
         entity: Entity;
     }
+    export interface SetTintColor {
+        entity: Entity;
+        tintColor: RgbColor | undefined;
+    }
     export interface Spawn {
         entity: Entity;
     }
@@ -1369,8 +1404,9 @@ export declare namespace EntityEventPayload {
 /** Event types an Entity instance can emit. @public */
 export declare enum EntityEventType {
     DESPAWN = "ENTITY.DESPAWN",
+    SET_TINT_COLOR = "ENTITY.SET_TINT_COLOR",
     SPAWN = "ENTITY.SPAWN",
-    START_MODEL_LOOPED_ANIMATIONS = "ENTITY.UPDATE_MODEL_LOOPED_ANIMATIONS",
+    START_MODEL_LOOPED_ANIMATIONS = "ENTITY.START_MODEL_LOOPED_ANIMATIONS",
     START_MODEL_ONESHOT_ANIMATIONS = "ENTITY.START_MODEL_ONESHOT_ANIMATIONS",
     STOP_MODEL_ANIMATIONS = "ENTITY.STOP_MODEL_ANIMATIONS",
     UPDATE_ROTATION = "ENTITY.UPDATE_ROTATION",
@@ -1461,6 +1497,8 @@ export declare interface EntityOptions {
     rigidBodyOptions?: RigidBodyOptions;
     /** An arbitrary identifier tag of the entity. Useful for your own logic. */
     tag?: string;
+    /** The tint color of the entity as a hex code. */
+    tintColor?: RgbColor;
 }
 
 /** An EventRouter event. @public */
@@ -1658,6 +1696,7 @@ declare namespace HYTOPIA {
         GameServerEventType,
         startServer,
         GameServerEventPayload,
+        RgbColor,
         Rotation,
         SpdMatrix3,
         Vector3,
@@ -1687,7 +1726,6 @@ declare namespace HYTOPIA {
         MoveCompleteCallback,
         MoveOptions,
         Simulation,
-        WebServer,
         PORT,
         World,
         WorldMap,
@@ -2152,6 +2190,13 @@ declare type RayCastOptions = {
     filterPredicate?: (collider: RAPIER.Collider) => boolean;
 };
 
+/** A RGB color. @public */
+export declare interface RgbColor {
+    r: number;
+    g: number;
+    b: number;
+}
+
 /**
  * Represents a rigid body in a world's physics simulation.
  *
@@ -2724,6 +2769,11 @@ export declare class Simulation {
     enableDebugRendering(enabled: boolean): void;
 
 
+    /**
+     * Sets the gravity vector for the simulation.
+     * @param gravity - The gravity vector.
+     */
+    setGravity(gravity: RAPIER.Vector3): void;
 
 
 
@@ -2764,30 +2814,6 @@ export declare interface Vector3Boolean {
     x: boolean;
     y: boolean;
     z: boolean;
-}
-
-/**
- * Manages the internal HTTP server for the game server.
- *
- * @remarks
- * This class is used as a singleton and should be
- * accessed via the GameServer.webServer property.
- *
- * @public
- */
-export declare class WebServer {
-
-
-
-
-
-
-
-
-
-
-
-
 }
 
 /**
@@ -2956,14 +2982,7 @@ export declare enum WorldLoopEventType {
 /** A map representation for a world. @public */
 export declare interface WorldMap {
     /** The block types in the map. */
-    blockTypes: {
-        /** The ID of the block type. */
-        id: number;
-        /** The name of the block type. */
-        name: string;
-        /** The URI of the texture for the block type. */
-        textureUri: string;
-    }[];
+    blockTypes: BlockTypeOptions[];
     /** The blocks in the map */
     blocks: {
         /** The global coordinate to block type id mapping. */