hytopia 0.10.49 → 0.11.2

package/server.d.ts

@@ -563,6 +563,66 @@ export declare interface BlockEntityOptions extends BaseEntityOptions {
     blockHalfExtents?: Vector3Like;
     /** The texture uri of a entity if the entity is a block entity, if set rigidBodyOptions collider shape [0] must be a block */
     blockTextureUri?: string;
+}
+
+/** Block texture metadata including UVs and rendering hints. @public */
+export declare type BlockTextureMetadata = {
+    u0: number;
+    v0: number;
+    u1: number;
+    v1: number;
+    averageRGB: [number, number, number];
+    isTransparent: boolean;
+    needsAlphaTest: boolean;
+};
+
+/**
+ * Manages block textures and block texture atlas generation of the game.
+ *
+ * @remarks
+ * The BlockTextureRegistry is created internally as a global
+ * singletone accessible with the static property
+ * `BlockTextureRegistry.instance`.
+ *
+ * @example
+ * ```typescript
+ * import { BlockTextureRegistry } from 'hytopia';
+ *
+ * const blockTextureRegistry = BlockTextureRegistry.instance;
+ * const metadata = blockTextureRegistry.getBlockTextureMetadata('blocks/stone.png');
+ * ```
+ *
+ * @public
+ */
+export declare class BlockTextureRegistry {
+    /** The global BlockTextureRegistry instance as a singleton. */
+    static readonly instance: BlockTextureRegistry;
+    /** Whether to always generate the atlas on server start. */
+    generateEveryStart: boolean;
+
+
+    /**
+     * Checks if a block texture is registered in the atlas.
+     *
+     * @param textureUri - The URI of the texture (e.g., 'blocks/stone.png' or 'blocks/grass' for cubemaps).
+     * @returns Whether the texture is registered.
+     */
+    hasBlockTexture(textureUri: string): boolean;
+    /**
+     * Retrieves metadata for a block texture. Returns array for cubemaps (6 faces) or standard textures (1 face).
+     *
+     * @param textureUri - The URI of the texture (e.g., 'blocks/stone.png' or 'blocks/grass').
+     * @returns Array of texture metadata, or undefined if not found.
+     */
+    getBlockTextureMetadata(textureUri: string): BlockTextureMetadata[] | undefined;
+
+
+
+
+
+
+
+
 }
 
 /**
@@ -2390,8 +2450,11 @@ export declare class GameServer {
 
 
 
+
     /** The singleton instance of the game server. */
     static get instance(): GameServer;
+    /** The block texture registry for the game server. */
+    get blockTextureRegistry(): BlockTextureRegistry;
     /** The model manager for the game server. */
     get modelRegistry(): ModelRegistry;
     /** The player manager for the game server. */
@@ -3546,6 +3609,7 @@ export declare class ModelRegistry {
 
 
 
+
 }
 
 /** A trimesh for a model. @public */