[Home](./index.md) > [server](./server.md) > [BlockTextureRegistry](./server.blocktextureregistry.md) ## BlockTextureRegistry class Manages block textures and block texture atlas generation of the game. When to use: querying texture atlas UVs and transparency hints for blocks. Do NOT use for: runtime texture modifications; regenerate atlas offline in dev. **Signature:** ```typescript export default class BlockTextureRegistry ``` ## Remarks The BlockTextureRegistry is created internally as a global singleton accessible via `BlockTextureRegistry.instance`. The atlas is preloaded during server startup and cached in memory. Pattern: call `BlockTextureRegistry.hasBlockTexture` before lookup to avoid warnings. Anti-pattern: assuming missing textures are silently ignored. The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `BlockTextureRegistry` class. ## Example ```typescript import { BlockTextureRegistry } from 'hytopia'; const blockTextureRegistry = BlockTextureRegistry.instance; const metadata = blockTextureRegistry.getBlockTextureMetadata('blocks/stone.png'); ``` \*\*Category:\*\* Textures ## Properties

Property	Modifiers	Type	Description
[generate](./server.blocktextureregistry.generate.md)		boolean	Whether to generate the atlas if needed. Defaults to `true` in development, `false` in production. \*\*Category:\*\* Textures
[instance](./server.blocktextureregistry.instance.md)	`static` `readonly`	[BlockTextureRegistry](./server.blocktextureregistry.md)	The global BlockTextureRegistry instance as a singleton. \*\*Category:\*\* Textures

## Methods

Method	Modifiers	Description
[getBlockTextureMetadata(textureUri)](./server.blocktextureregistry.getblocktexturemetadata.md)		Retrieves metadata for a block texture. Returns array for cubemaps (6 faces) or standard textures (1 face).
[hasBlockTexture(textureUri)](./server.blocktextureregistry.hasblocktexture.md)		Checks if a block texture is registered in the atlas.