[Home](./index.md) > [server](./server.md) > [ChunkLattice](./server.chunklattice.md) ## ChunkLattice class A lattice of chunks that represent a world's terrain. When to use: reading or mutating blocks in world space. Do NOT use for: per-entity placement logic; prefer higher-level game systems. **Signature:** ```typescript export default class ChunkLattice extends EventRouter ``` **Extends:** [EventRouter](./server.eventrouter.md) ## Remarks The lattice owns all chunks and keeps physics colliders in sync with blocks.

Coordinate System

- \*\*Global (world) coordinates:\*\* integer block positions in world space. - \*\*Chunk origin:\*\* world coordinate at the chunk's minimum corner (multiples of 16). - \*\*Local coordinates:\*\* 0..15 per axis within a chunk. - \*\*Axes:\*\* +X right, +Y up, -Z forward. - \*\*Origin:\*\* (0,0,0) is the world origin. \*\*Category:\*\* Blocks ## Constructors
Constructor Modifiers Description
[(constructor)(world)](./server.chunklattice._constructor_.md) Creates a new chunk lattice instance.
## Properties
Property Modifiers Type Description
[chunkCount](./server.chunklattice.chunkcount.md) `readonly` number The number of chunks in the lattice. \*\*Category:\*\* Blocks
## Methods
Method Modifiers Description
[clear()](./server.chunklattice.clear.md) Removes and clears all chunks and their blocks from the lattice. Use for: full world resets or map reloads. Do NOT use for: incremental changes; use `ChunkLattice.setBlock`.
[getAllChunks()](./server.chunklattice.getallchunks.md) Gets all chunks in the lattice.
[getBlockId(globalCoordinate)](./server.chunklattice.getblockid.md) Gets the block type ID at a specific global coordinate.
[getBlockType(globalCoordinate)](./server.chunklattice.getblocktype.md) Gets the block type at a specific global coordinate.
[getBlockTypeCount(blockTypeId)](./server.chunklattice.getblocktypecount.md) Gets the number of blocks of a specific block type in the lattice.
[getChunk(globalCoordinate)](./server.chunklattice.getchunk.md) Gets the chunk that contains the given global coordinate.
[getOrCreateChunk(globalCoordinate)](./server.chunklattice.getorcreatechunk.md) Gets the chunk for a given global coordinate, creating it if it doesn't exist.
[hasBlock(globalCoordinate)](./server.chunklattice.hasblock.md) Checks if a block exists at a specific global coordinate.
[hasChunk(globalCoordinate)](./server.chunklattice.haschunk.md) Checks if a chunk exists for a given global coordinate.
[initializeBlocks(blocks)](./server.chunklattice.initializeblocks.md) Initializes all blocks in the lattice in bulk, replacing existing blocks. Use for: loading maps or generating terrain in one pass. Do NOT use for: incremental edits; use `ChunkLattice.setBlock`.
[setBlock(globalCoordinate, blockTypeId, blockRotation)](./server.chunklattice.setblock.md) Sets the block at a global coordinate by block type ID. Use for: incremental terrain edits. Do NOT use for: bulk terrain loading; use `ChunkLattice.initializeBlocks`.