minerender 2.1.0-alpha.37 → 2.1.0-alpha.39

package/dist/node/index.d.mts

@@ -2,8 +2,8 @@ import * as three from 'three';
 import { Vector3, PixelFormat, BoxGeometry, Material, Mesh, Euler, Vector2, BufferAttribute, Float32BufferAttribute, BufferGeometry, Object3D, Box3, InstancedMesh, PerspectiveCamera, OrthographicCamera, Matrix4, Scene, Object3DEventMap, Texture, Camera, MOUSE, TOUCH, WebGLRenderer, EventDispatcher, Raycaster, Intersection, MeshBasicMaterial, CanvasTexture, InterleavedBufferAttribute, TrianglesDrawModes, Line, Points } from 'three';
 import * as nodeCanvas from 'canvas';
 import { ImageData as ImageData$1, CanvasRenderingContext2D } from 'canvas';
-import { Buffer as Buffer$1 } from 'buffer';
-import { NBT } from 'prismarine-nbt';
+import { Buffer } from 'buffer';
+import { NBT, NBTFormat, Metadata } from 'prismarine-nbt';
 import { ZipReader } from '@zip.js/zip.js';
 import { AsyncLoadingCache, SimpleCache } from '@inventivetalent/loading-cache';
 import Stats from 'stats.js';
@@ -39,6 +39,7 @@ declare enum CubeFaceIndex {
     NORTH = 5
 }
 declare const CUBE_FACES: CubeFace[];
+declare const CUBE_FACE_OFFSETS: readonly [readonly [1, 0, 0], readonly [-1, 0, 0], readonly [0, 1, 0], readonly [0, -1, 0], readonly [0, 0, 1], readonly [0, 0, -1]];
 
 interface Disposable {
     dispose(): void;
@@ -320,7 +321,7 @@ interface ImageInfo {
     width: number;
     height: number;
     type?: string;
-    data: Buffer$1;
+    data: Buffer;
 }
 declare class ImageLoader {
     protected static _createImage(): CompatImage;
@@ -805,6 +806,11 @@ declare class DisplayTransforms {
     static apply(geometry: BufferGeometry, matrix: Matrix4): void;
 }
 
+declare class ModelCulling {
+    static toLocalMask(worldMask: number, rotation: Euler): number;
+    static isOpaqueFullCube(atlas: Maybe<TextureAtlas>): boolean;
+}
+
 declare class ModelGenerator {
     static readonly ITEM_LAYERS: string[];
     static generateItemModel(imageData: ImageData$1, layer: string): ModelElement[];
@@ -882,6 +888,7 @@ declare class ModelObject extends SceneObject {
     constructor(originalModel: Model, options?: Partial<ModelObjectOptions>);
     init(): Promise<void>;
     get textureAtlas(): Maybe<TextureAtlas>;
+    get isOpaqueFullCube(): boolean;
     protected loadTextures(): Promise<void>;
     protected createMeshes(force?: boolean): void;
     protected applyTextures(): void;
@@ -893,6 +900,8 @@ interface ModelObjectOptions extends SceneObjectOptions {
     uvLockRotation?: TripleArray;
     /** sRGB 0xRRGGBB colors by face tint index; omitted indices stay white. */
     tints?: Record<number, number>;
+    /** Hidden neighbor directions in CUBE_FACES order, before the model's block rotation. */
+    cullMask?: number;
 }
 declare function isModelObject(obj: any): obj is ModelObject;
 
@@ -1096,11 +1105,17 @@ declare class BlockObject extends SceneObject {
     private _instanceModel;
     private _variants;
     private _models;
+    private _cullMask;
     constructor(blockState: BlockState, options?: Partial<BlockObjectOptions>);
     init(): Promise<void>;
     dispose(): void;
     removeFromScene(): void;
     private clearModels;
+    private removeModels;
+    get isOccluding(): boolean;
+    private getModelMatrix;
+    private getModelCullMask;
+    setCullMask(worldMask: number): Promise<void>;
     get state(): {
         [key: string]: string;
     };
@@ -1128,20 +1143,27 @@ declare function isBlockObject(obj: any): obj is BlockObject;
 interface MultiBlockStructure {
     readonly size: TripleArray;
     readonly blocks: MultiBlockBlock[];
+    readonly dataVersion?: number;
+    readonly entities?: MultiBlockEntity[];
+}
+interface MultiBlockEntity {
+    position: TripleArray;
+    blockPosition?: TripleArray;
+    nbt: unknown;
 }
 interface MultiBlockBlock extends Block {
     position: TripleArray;
 }
 
 declare class SchematicParser {
-    static parse(): Promise<MultiBlockStructure>;
+    static parse(nbt: NBT): Promise<MultiBlockStructure>;
 }
 
 declare class StructureParser {
     static parse(_nbt: NBT, paletteIndex?: number): Promise<MultiBlockStructure>;
 }
 interface StructureNBT {
-    DataVersion: {
+    DataVersion?: {
         type: "int";
         value: number;
     };
@@ -1153,7 +1175,13 @@ interface StructureNBT {
         };
     };
     palette?: Palette;
-    palettes?: Palette[];
+    palettes?: {
+        type: "list";
+        value: {
+            type: "list";
+            value: Palette["value"][];
+        };
+    };
     blocks: {
         type: "list";
         value: {
@@ -1161,7 +1189,32 @@ interface StructureNBT {
             value: BlockEntry[];
         };
     };
-    entities: {};
+    entities?: {
+        type: "list";
+        value: {
+            type: "compound";
+            value: {
+                pos: {
+                    type: "list";
+                    value: {
+                        type: "double";
+                        value: TripleArray;
+                    };
+                };
+                blockPos: {
+                    type: "list";
+                    value: {
+                        type: "int";
+                        value: TripleArray;
+                    };
+                };
+                nbt: {
+                    type: "compound";
+                    value: any;
+                };
+            }[];
+        };
+    };
 }
 interface Palette {
     type: "list";
@@ -1205,9 +1258,12 @@ interface BlockEntry {
 }
 
 declare class NBTHelper {
-    static fromBuffer(buffer: Buffer): Promise<NBTAsset>;
+    static fromBuffer(data: Uint8Array | ArrayBuffer, format?: NBTFormat): Promise<NBTAsset>;
 }
 interface NBTAsset extends MinecraftAsset, NBT {
+    format?: NBTFormat;
+    metadata?: Metadata;
+    compression?: "gzip" | "none";
 }
 
 interface ResponseParser<T extends MinecraftAsset> {
@@ -1679,6 +1735,51 @@ declare function mergeVertices(geometry: BufferGeometry, tolerance?: number): Bu
 declare function toTrianglesDrawMode(geometry: BufferGeometry, drawMode: TrianglesDrawModes): BufferGeometry;
 declare function computeMorphedAttributes(object: Mesh | Line | Points): object;
 
+declare class ChunkData {
+    private readonly indices;
+    private readonly palette;
+    private readonly paletteIds;
+    private readonly freeIds;
+    private readonly nbt;
+    get(index: number): Maybe<Block>;
+    snapshot(index: number): Maybe<() => Block>;
+    set(index: number, block?: Block): void;
+    clear(): void;
+    static isAir(block: Maybe<Block>): boolean;
+    private static copyBlock;
+    private static validateIndex;
+}
+
+type RegionInput = Uint8Array | ArrayBuffer;
+interface AnvilRegion {
+    chunks: AnvilChunk[];
+}
+interface AnvilChunk {
+    x: number;
+    z: number;
+    dataVersion?: number;
+    sections: {
+        y: number;
+        data: ChunkData;
+    }[];
+    entities?: MultiBlockEntity[];
+}
+declare class AnvilParser {
+    static getChunkList(data: RegionInput): {
+        x: number;
+        z: number;
+    }[];
+    static parse(data: RegionInput): Promise<AnvilRegion>;
+    static parseChunk(data: RegionInput, localX: number, localZ: number): Promise<AnvilChunk | undefined>;
+    private static bytes;
+    private static locations;
+    private static readChunk;
+    private static compounds;
+    private static integer;
+    private static block;
+    private static unpack;
+}
+
 interface BlockInfo {
     /** Detached block data; use world or chunk setters to update stored blocks. */
     readonly block: Block;
@@ -1686,13 +1787,14 @@ interface BlockInfo {
 }
 
 declare class Chunk {
+    private readonly onBlocksChanged?;
     readonly scene: MineRenderScene;
     readonly x: number;
     readonly y: number;
     readonly z: number;
     private readonly data;
     private readonly renderedBlocks;
-    constructor(scene: MineRenderScene, x: number, y: number, z: number);
+    constructor(scene: MineRenderScene, x: number, y: number, z: number, onBlocksChanged?: ((positions: Vector3[]) => Promise<void>) | undefined);
     getBlockAt(x: number, y: number, z: number): Maybe<BlockInfo>;
     getBlockAt(pos: Vector3): Maybe<BlockInfo>;
     getBlockAt(pos: TripleArray): Maybe<BlockInfo>;
@@ -1714,24 +1816,11 @@ declare class Chunk {
     chunkPosToWorldPos(pos: Vector3): Vector3;
 }
 
-declare class ChunkData {
-    private readonly indices;
-    private readonly palette;
-    private readonly paletteIds;
-    private readonly freeIds;
-    private readonly nbt;
-    get(index: number): Maybe<Block>;
-    snapshot(index: number): Maybe<() => Block>;
-    set(index: number, block?: Block): void;
-    clear(): void;
-    static isAir(block: Maybe<Block>): boolean;
-    private static copyBlock;
-    private static validateIndex;
-}
-
 declare class MineRenderWorld {
     readonly scene: MineRenderScene;
     private readonly _chunks;
+    private readonly pendingCulling;
+    private culling?;
     constructor(scene: MineRenderScene);
     getBlockAt(x: number, y: number, z: number): Maybe<BlockInfo>;
     getBlockAt(pos: Vector3): Maybe<BlockInfo>;
@@ -1740,7 +1829,10 @@ declare class MineRenderWorld {
     setBlockAt(pos: Vector3, block: Maybe<Block>): Promise<Maybe<BlockInfo>>;
     setBlockAt(pos: TripleArray, block: Maybe<Block>): Promise<Maybe<BlockInfo>>;
     placeMultiBlock(multiblock: MultiBlockStructure, useBatches?: boolean, executor?: BatchedExecutor): Promise<void>;
+    /** Replaces one chunk column's blocks. Entity NBT remains available on the parsed chunk. */
+    placeChunk(chunk: AnvilChunk, executor?: BatchedExecutor): Promise<void>;
     clear(): Promise<void>;
+    private updateCulling;
     private getOrCreateChunkAt;
     getChunkAt(pos: Vector3): Maybe<Chunk>;
     static worldToScenePosition(pos: Vector3): Vector3;
@@ -1787,4 +1879,4 @@ declare class NodeCache extends PersistentCache<LocalStorage> {
     forEach<T>(callback: (v: T, k: string) => void): Promise<void>;
 }
 
-export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, ArchiveAssetSource, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, type Block, type BlockInfo, type BlockModel, type BlockModelTextures, BlockObject, type BlockObjectOptions, type BlockState, type BlockStateMultipart, type BlockStateProperties, type BlockStateProperty, type BlockStatePropertyDefaults, type BlockStatePropertyValue, type BlockStateVariant, type BlockStateVariants, BlockStates, BlockTints, type BoxGeometryKey, BrowserArchiveProxy, CUBE_FACES, type CacheKey, Caching, type CameraOptions, CanvasImage, type CapeLayout, Chunk, ChunkData, type CompatCanvas, type CompatImage, type ComposerOptions, type ControlsOptions, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, type DebugOptions, type DeepPartial, DefaultBlockStates, DisplayPosition, DisplayTransforms, type Disposable, type DoubleArray, type ElementFace, type ElementRotation, Entities, type EntityLayer, type EntityModel, type EntityModelCube, type EntityModelFile, type EntityModelLayer, type EntityModelOptions, type EntityModelPart, EntityObject, type EntityObjectOptions, Env, type EnvProvider, type ExtractableImageData, type FromTo, Geometries, GuiLight, GuiObject, type GuiObjectOptions, HostedAssetSource, type IModelTextures, ITEM_GENERATED, type ImageInfo, ImageLoader, type ImageSizeInfo, InstanceManager, InstanceReference, type Instanceable, type ItemModel, type ItemModelTextures, type ListAsset, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, MineRenderError, MineRenderScene, type MineRenderSceneOptions, MineRenderWorld, type MinecraftAsset, MinecraftCubeTexture, MinecraftFaceUV, type MinecraftTextureMeta, type Model, type ModelDisplay, type ModelElement, type ModelFaces, ModelGenerator, ModelMerger, ModelObject, type ModelObjectOptions, ModelTextures, Models, type MultiBlockBlock, type MultiBlockStructure, type MultipartCondition, type NBTAsset, NBTHelper, NodeCache, NodeEnv, OrbitControls, PersistentCache, type QuadArray, type RawImageKey, type RenderOptions, Renderer, type RendererOptions, type RequestConfig, RequestError, type RequestResponse, Requests, type ResponseParser, SKIN_PARTS, SceneInspector, SceneObject, type SceneObjectOptions, SceneStats, SceneStatsDisplay, SchematicParser, type Serializable, type SkinGeometries, SkinImage, SkinObject, type SkinObjectOptions, SkinPart, type SkinTexture, type SkinTextureCoordinates, SkinTextures, Skins, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, axisToVec3, base64decode, base64encode, capeTextureSizes, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, createCanvas, createImage, estimateBytesUsed, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isSceneObject, isTransformable, isTripleArray, isVector3, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, prefix, registerNodeEnv, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode };
+export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, type AnvilChunk, AnvilParser, type AnvilRegion, ArchiveAssetSource, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, type Block, type BlockInfo, type BlockModel, type BlockModelTextures, BlockObject, type BlockObjectOptions, type BlockState, type BlockStateMultipart, type BlockStateProperties, type BlockStateProperty, type BlockStatePropertyDefaults, type BlockStatePropertyValue, type BlockStateVariant, type BlockStateVariants, BlockStates, BlockTints, type BoxGeometryKey, BrowserArchiveProxy, CUBE_FACES, CUBE_FACE_OFFSETS, type CacheKey, Caching, type CameraOptions, CanvasImage, type CapeLayout, Chunk, ChunkData, type CompatCanvas, type CompatImage, type ComposerOptions, type ControlsOptions, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, type DebugOptions, type DeepPartial, DefaultBlockStates, DisplayPosition, DisplayTransforms, type Disposable, type DoubleArray, type ElementFace, type ElementRotation, Entities, type EntityLayer, type EntityModel, type EntityModelCube, type EntityModelFile, type EntityModelLayer, type EntityModelOptions, type EntityModelPart, EntityObject, type EntityObjectOptions, Env, type EnvProvider, type ExtractableImageData, type FromTo, Geometries, GuiLight, GuiObject, type GuiObjectOptions, HostedAssetSource, type IModelTextures, ITEM_GENERATED, type ImageInfo, ImageLoader, type ImageSizeInfo, InstanceManager, InstanceReference, type Instanceable, type ItemModel, type ItemModelTextures, type ListAsset, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, MineRenderError, MineRenderScene, type MineRenderSceneOptions, MineRenderWorld, type MinecraftAsset, MinecraftCubeTexture, MinecraftFaceUV, type MinecraftTextureMeta, type Model, ModelCulling, type ModelDisplay, type ModelElement, type ModelFaces, ModelGenerator, ModelMerger, ModelObject, type ModelObjectOptions, ModelTextures, Models, type MultiBlockBlock, type MultiBlockEntity, type MultiBlockStructure, type MultipartCondition, type NBTAsset, NBTHelper, NodeCache, NodeEnv, OrbitControls, PersistentCache, type QuadArray, type RawImageKey, type RenderOptions, Renderer, type RendererOptions, type RequestConfig, RequestError, type RequestResponse, Requests, type ResponseParser, SKIN_PARTS, SceneInspector, SceneObject, type SceneObjectOptions, SceneStats, SceneStatsDisplay, SchematicParser, type Serializable, type SkinGeometries, SkinImage, SkinObject, type SkinObjectOptions, SkinPart, type SkinTexture, type SkinTextureCoordinates, SkinTextures, Skins, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, axisToVec3, base64decode, base64encode, capeTextureSizes, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, createCanvas, createImage, estimateBytesUsed, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isSceneObject, isTransformable, isTripleArray, isVector3, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, prefix, registerNodeEnv, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode };

package/dist/node/index.d.ts

@@ -2,8 +2,8 @@ import * as three from 'three';
 import { Vector3, PixelFormat, BoxGeometry, Material, Mesh, Euler, Vector2, BufferAttribute, Float32BufferAttribute, BufferGeometry, Object3D, Box3, InstancedMesh, PerspectiveCamera, OrthographicCamera, Matrix4, Scene, Object3DEventMap, Texture, Camera, MOUSE, TOUCH, WebGLRenderer, EventDispatcher, Raycaster, Intersection, MeshBasicMaterial, CanvasTexture, InterleavedBufferAttribute, TrianglesDrawModes, Line, Points } from 'three';
 import * as nodeCanvas from 'canvas';
 import { ImageData as ImageData$1, CanvasRenderingContext2D } from 'canvas';
-import { Buffer as Buffer$1 } from 'buffer';
-import { NBT } from 'prismarine-nbt';
+import { Buffer } from 'buffer';
+import { NBT, NBTFormat, Metadata } from 'prismarine-nbt';
 import { ZipReader } from '@zip.js/zip.js';
 import { AsyncLoadingCache, SimpleCache } from '@inventivetalent/loading-cache';
 import Stats from 'stats.js';
@@ -39,6 +39,7 @@ declare enum CubeFaceIndex {
     NORTH = 5
 }
 declare const CUBE_FACES: CubeFace[];
+declare const CUBE_FACE_OFFSETS: readonly [readonly [1, 0, 0], readonly [-1, 0, 0], readonly [0, 1, 0], readonly [0, -1, 0], readonly [0, 0, 1], readonly [0, 0, -1]];
 
 interface Disposable {
     dispose(): void;
@@ -320,7 +321,7 @@ interface ImageInfo {
     width: number;
     height: number;
     type?: string;
-    data: Buffer$1;
+    data: Buffer;
 }
 declare class ImageLoader {
     protected static _createImage(): CompatImage;
@@ -805,6 +806,11 @@ declare class DisplayTransforms {
     static apply(geometry: BufferGeometry, matrix: Matrix4): void;
 }
 
+declare class ModelCulling {
+    static toLocalMask(worldMask: number, rotation: Euler): number;
+    static isOpaqueFullCube(atlas: Maybe<TextureAtlas>): boolean;
+}
+
 declare class ModelGenerator {
     static readonly ITEM_LAYERS: string[];
     static generateItemModel(imageData: ImageData$1, layer: string): ModelElement[];
@@ -882,6 +888,7 @@ declare class ModelObject extends SceneObject {
     constructor(originalModel: Model, options?: Partial<ModelObjectOptions>);
     init(): Promise<void>;
     get textureAtlas(): Maybe<TextureAtlas>;
+    get isOpaqueFullCube(): boolean;
     protected loadTextures(): Promise<void>;
     protected createMeshes(force?: boolean): void;
     protected applyTextures(): void;
@@ -893,6 +900,8 @@ interface ModelObjectOptions extends SceneObjectOptions {
     uvLockRotation?: TripleArray;
     /** sRGB 0xRRGGBB colors by face tint index; omitted indices stay white. */
     tints?: Record<number, number>;
+    /** Hidden neighbor directions in CUBE_FACES order, before the model's block rotation. */
+    cullMask?: number;
 }
 declare function isModelObject(obj: any): obj is ModelObject;
 
@@ -1096,11 +1105,17 @@ declare class BlockObject extends SceneObject {
     private _instanceModel;
     private _variants;
     private _models;
+    private _cullMask;
     constructor(blockState: BlockState, options?: Partial<BlockObjectOptions>);
     init(): Promise<void>;
     dispose(): void;
     removeFromScene(): void;
     private clearModels;
+    private removeModels;
+    get isOccluding(): boolean;
+    private getModelMatrix;
+    private getModelCullMask;
+    setCullMask(worldMask: number): Promise<void>;
     get state(): {
         [key: string]: string;
     };
@@ -1128,20 +1143,27 @@ declare function isBlockObject(obj: any): obj is BlockObject;
 interface MultiBlockStructure {
     readonly size: TripleArray;
     readonly blocks: MultiBlockBlock[];
+    readonly dataVersion?: number;
+    readonly entities?: MultiBlockEntity[];
+}
+interface MultiBlockEntity {
+    position: TripleArray;
+    blockPosition?: TripleArray;
+    nbt: unknown;
 }
 interface MultiBlockBlock extends Block {
     position: TripleArray;
 }
 
 declare class SchematicParser {
-    static parse(): Promise<MultiBlockStructure>;
+    static parse(nbt: NBT): Promise<MultiBlockStructure>;
 }
 
 declare class StructureParser {
     static parse(_nbt: NBT, paletteIndex?: number): Promise<MultiBlockStructure>;
 }
 interface StructureNBT {
-    DataVersion: {
+    DataVersion?: {
         type: "int";
         value: number;
     };
@@ -1153,7 +1175,13 @@ interface StructureNBT {
         };
     };
     palette?: Palette;
-    palettes?: Palette[];
+    palettes?: {
+        type: "list";
+        value: {
+            type: "list";
+            value: Palette["value"][];
+        };
+    };
     blocks: {
         type: "list";
         value: {
@@ -1161,7 +1189,32 @@ interface StructureNBT {
             value: BlockEntry[];
         };
     };
-    entities: {};
+    entities?: {
+        type: "list";
+        value: {
+            type: "compound";
+            value: {
+                pos: {
+                    type: "list";
+                    value: {
+                        type: "double";
+                        value: TripleArray;
+                    };
+                };
+                blockPos: {
+                    type: "list";
+                    value: {
+                        type: "int";
+                        value: TripleArray;
+                    };
+                };
+                nbt: {
+                    type: "compound";
+                    value: any;
+                };
+            }[];
+        };
+    };
 }
 interface Palette {
     type: "list";
@@ -1205,9 +1258,12 @@ interface BlockEntry {
 }
 
 declare class NBTHelper {
-    static fromBuffer(buffer: Buffer): Promise<NBTAsset>;
+    static fromBuffer(data: Uint8Array | ArrayBuffer, format?: NBTFormat): Promise<NBTAsset>;
 }
 interface NBTAsset extends MinecraftAsset, NBT {
+    format?: NBTFormat;
+    metadata?: Metadata;
+    compression?: "gzip" | "none";
 }
 
 interface ResponseParser<T extends MinecraftAsset> {
@@ -1679,6 +1735,51 @@ declare function mergeVertices(geometry: BufferGeometry, tolerance?: number): Bu
 declare function toTrianglesDrawMode(geometry: BufferGeometry, drawMode: TrianglesDrawModes): BufferGeometry;
 declare function computeMorphedAttributes(object: Mesh | Line | Points): object;
 
+declare class ChunkData {
+    private readonly indices;
+    private readonly palette;
+    private readonly paletteIds;
+    private readonly freeIds;
+    private readonly nbt;
+    get(index: number): Maybe<Block>;
+    snapshot(index: number): Maybe<() => Block>;
+    set(index: number, block?: Block): void;
+    clear(): void;
+    static isAir(block: Maybe<Block>): boolean;
+    private static copyBlock;
+    private static validateIndex;
+}
+
+type RegionInput = Uint8Array | ArrayBuffer;
+interface AnvilRegion {
+    chunks: AnvilChunk[];
+}
+interface AnvilChunk {
+    x: number;
+    z: number;
+    dataVersion?: number;
+    sections: {
+        y: number;
+        data: ChunkData;
+    }[];
+    entities?: MultiBlockEntity[];
+}
+declare class AnvilParser {
+    static getChunkList(data: RegionInput): {
+        x: number;
+        z: number;
+    }[];
+    static parse(data: RegionInput): Promise<AnvilRegion>;
+    static parseChunk(data: RegionInput, localX: number, localZ: number): Promise<AnvilChunk | undefined>;
+    private static bytes;
+    private static locations;
+    private static readChunk;
+    private static compounds;
+    private static integer;
+    private static block;
+    private static unpack;
+}
+
 interface BlockInfo {
     /** Detached block data; use world or chunk setters to update stored blocks. */
     readonly block: Block;
@@ -1686,13 +1787,14 @@ interface BlockInfo {
 }
 
 declare class Chunk {
+    private readonly onBlocksChanged?;
     readonly scene: MineRenderScene;
     readonly x: number;
     readonly y: number;
     readonly z: number;
     private readonly data;
     private readonly renderedBlocks;
-    constructor(scene: MineRenderScene, x: number, y: number, z: number);
+    constructor(scene: MineRenderScene, x: number, y: number, z: number, onBlocksChanged?: ((positions: Vector3[]) => Promise<void>) | undefined);
     getBlockAt(x: number, y: number, z: number): Maybe<BlockInfo>;
     getBlockAt(pos: Vector3): Maybe<BlockInfo>;
     getBlockAt(pos: TripleArray): Maybe<BlockInfo>;
@@ -1714,24 +1816,11 @@ declare class Chunk {
     chunkPosToWorldPos(pos: Vector3): Vector3;
 }
 
-declare class ChunkData {
-    private readonly indices;
-    private readonly palette;
-    private readonly paletteIds;
-    private readonly freeIds;
-    private readonly nbt;
-    get(index: number): Maybe<Block>;
-    snapshot(index: number): Maybe<() => Block>;
-    set(index: number, block?: Block): void;
-    clear(): void;
-    static isAir(block: Maybe<Block>): boolean;
-    private static copyBlock;
-    private static validateIndex;
-}
-
 declare class MineRenderWorld {
     readonly scene: MineRenderScene;
     private readonly _chunks;
+    private readonly pendingCulling;
+    private culling?;
     constructor(scene: MineRenderScene);
     getBlockAt(x: number, y: number, z: number): Maybe<BlockInfo>;
     getBlockAt(pos: Vector3): Maybe<BlockInfo>;
@@ -1740,7 +1829,10 @@ declare class MineRenderWorld {
     setBlockAt(pos: Vector3, block: Maybe<Block>): Promise<Maybe<BlockInfo>>;
     setBlockAt(pos: TripleArray, block: Maybe<Block>): Promise<Maybe<BlockInfo>>;
     placeMultiBlock(multiblock: MultiBlockStructure, useBatches?: boolean, executor?: BatchedExecutor): Promise<void>;
+    /** Replaces one chunk column's blocks. Entity NBT remains available on the parsed chunk. */
+    placeChunk(chunk: AnvilChunk, executor?: BatchedExecutor): Promise<void>;
     clear(): Promise<void>;
+    private updateCulling;
     private getOrCreateChunkAt;
     getChunkAt(pos: Vector3): Maybe<Chunk>;
     static worldToScenePosition(pos: Vector3): Vector3;
@@ -1787,4 +1879,4 @@ declare class NodeCache extends PersistentCache<LocalStorage> {
     forEach<T>(callback: (v: T, k: string) => void): Promise<void>;
 }
 
-export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, ArchiveAssetSource, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, type Block, type BlockInfo, type BlockModel, type BlockModelTextures, BlockObject, type BlockObjectOptions, type BlockState, type BlockStateMultipart, type BlockStateProperties, type BlockStateProperty, type BlockStatePropertyDefaults, type BlockStatePropertyValue, type BlockStateVariant, type BlockStateVariants, BlockStates, BlockTints, type BoxGeometryKey, BrowserArchiveProxy, CUBE_FACES, type CacheKey, Caching, type CameraOptions, CanvasImage, type CapeLayout, Chunk, ChunkData, type CompatCanvas, type CompatImage, type ComposerOptions, type ControlsOptions, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, type DebugOptions, type DeepPartial, DefaultBlockStates, DisplayPosition, DisplayTransforms, type Disposable, type DoubleArray, type ElementFace, type ElementRotation, Entities, type EntityLayer, type EntityModel, type EntityModelCube, type EntityModelFile, type EntityModelLayer, type EntityModelOptions, type EntityModelPart, EntityObject, type EntityObjectOptions, Env, type EnvProvider, type ExtractableImageData, type FromTo, Geometries, GuiLight, GuiObject, type GuiObjectOptions, HostedAssetSource, type IModelTextures, ITEM_GENERATED, type ImageInfo, ImageLoader, type ImageSizeInfo, InstanceManager, InstanceReference, type Instanceable, type ItemModel, type ItemModelTextures, type ListAsset, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, MineRenderError, MineRenderScene, type MineRenderSceneOptions, MineRenderWorld, type MinecraftAsset, MinecraftCubeTexture, MinecraftFaceUV, type MinecraftTextureMeta, type Model, type ModelDisplay, type ModelElement, type ModelFaces, ModelGenerator, ModelMerger, ModelObject, type ModelObjectOptions, ModelTextures, Models, type MultiBlockBlock, type MultiBlockStructure, type MultipartCondition, type NBTAsset, NBTHelper, NodeCache, NodeEnv, OrbitControls, PersistentCache, type QuadArray, type RawImageKey, type RenderOptions, Renderer, type RendererOptions, type RequestConfig, RequestError, type RequestResponse, Requests, type ResponseParser, SKIN_PARTS, SceneInspector, SceneObject, type SceneObjectOptions, SceneStats, SceneStatsDisplay, SchematicParser, type Serializable, type SkinGeometries, SkinImage, SkinObject, type SkinObjectOptions, SkinPart, type SkinTexture, type SkinTextureCoordinates, SkinTextures, Skins, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, axisToVec3, base64decode, base64encode, capeTextureSizes, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, createCanvas, createImage, estimateBytesUsed, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isSceneObject, isTransformable, isTripleArray, isVector3, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, prefix, registerNodeEnv, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode };
+export { AXES, type AnimationFrame, type AnimationMeta, type AnimatorFunction, type AnvilChunk, AnvilParser, type AnvilRegion, ArchiveAssetSource, type ArchiveEntry, type ArchiveProxy, AssetKey, AssetLoadError, AssetLoader, AssetParser, AssetSource, type AssetType, Assets, Axis, BUILTIN_ENTITY, BUILTIN_GENERATED, BasicAssetKey, type BasicMinecraftAsset, BatchedExecutor, type BedrockBone, type BedrockCube, type BedrockEntityDescription, type BedrockEntityFile, type BedrockGeometry, type BedrockGeometryFile, type Block, type BlockInfo, type BlockModel, type BlockModelTextures, BlockObject, type BlockObjectOptions, type BlockState, type BlockStateMultipart, type BlockStateProperties, type BlockStateProperty, type BlockStatePropertyDefaults, type BlockStatePropertyValue, type BlockStateVariant, type BlockStateVariants, BlockStates, BlockTints, type BoxGeometryKey, BrowserArchiveProxy, CUBE_FACES, CUBE_FACE_OFFSETS, type CacheKey, Caching, type CameraOptions, CanvasImage, type CapeLayout, Chunk, ChunkData, type CompatCanvas, type CompatImage, type ComposerOptions, type ControlsOptions, CubeFace, CubeFaceIndex, DEFAULT_ELEMENTS, DEFAULT_NAMESPACE, DEFAULT_ROOT, DEFAULT_UV, DISPLAY_POSITIONS, type DebugOptions, type DeepPartial, DefaultBlockStates, DisplayPosition, DisplayTransforms, type Disposable, type DoubleArray, type ElementFace, type ElementRotation, Entities, type EntityLayer, type EntityModel, type EntityModelCube, type EntityModelFile, type EntityModelLayer, type EntityModelOptions, type EntityModelPart, EntityObject, type EntityObjectOptions, Env, type EnvProvider, type ExtractableImageData, type FromTo, Geometries, GuiLight, GuiObject, type GuiObjectOptions, HostedAssetSource, type IModelTextures, ITEM_GENERATED, type ImageInfo, ImageLoader, type ImageSizeInfo, InstanceManager, InstanceReference, type Instanceable, type ItemModel, type ItemModelTextures, type ListAsset, MapControls, type MaterialKey, Materials, type Maybe, type MeshKey, Meshes, MineRenderError, MineRenderScene, type MineRenderSceneOptions, MineRenderWorld, type MinecraftAsset, MinecraftCubeTexture, MinecraftFaceUV, type MinecraftTextureMeta, type Model, ModelCulling, type ModelDisplay, type ModelElement, type ModelFaces, ModelGenerator, ModelMerger, ModelObject, type ModelObjectOptions, ModelTextures, Models, type MultiBlockBlock, type MultiBlockEntity, type MultiBlockStructure, type MultipartCondition, type NBTAsset, NBTHelper, NodeCache, NodeEnv, OrbitControls, PersistentCache, type QuadArray, type RawImageKey, type RenderOptions, Renderer, type RendererOptions, type RequestConfig, RequestError, type RequestResponse, Requests, type ResponseParser, SKIN_PARTS, SceneInspector, SceneObject, type SceneObjectOptions, SceneStats, SceneStatsDisplay, SchematicParser, type Serializable, type SkinGeometries, SkinImage, SkinObject, type SkinObjectOptions, SkinPart, type SkinTexture, type SkinTextureCoordinates, SkinTextures, Skins, type StructureNBT, StructureParser, type TextureAsset, TextureAtlas, type TextureKey, TextureLoader, Textures, Ticker, type TickerFunction, TintColors, type Transformable, type TripleArray, UVMapper, WrappedImage, addBox3WireframeToObject, addWireframeToMesh, addWireframeToObject, applyElementRotation, applyGenericRotation, axisToVec3, base64decode, base64encode, capeTextureSizes, captureException, changeEvent, clampRotationDegrees, classicSkinGeometries, classicSkinTextureCoordinates, computeMorphedAttributes, createCanvas, createImage, estimateBytesUsed, interleaveAttributes, isAssetKey, isBasicAssetKey, isBlockObject, isDisposable, isDoubleArray, isEntityObject, isInstanceManager, isInstanceReference, isInstanceable, isInstancedMesh, isMesh, isMineRenderScene, isModelObject, isObject3D, isOrthographicCamera, isPerspectiveCamera, isQuadArray, isSceneObject, isTransformable, isTripleArray, isVector3, md5, mergeBufferAttributes, mergeBufferGeometries, mergeVertices, prefix, registerNodeEnv, serializeBoxGeometryKey, serializeImageKey, serializeMaterialKey, serializeMeshKey, serializeTextureKey, sha1, sha256, sha512, shutdown, sleep, slimSkinGeometries, slimSkinTextureCoordinates, timingEnd, timingStart, toDegrees, toRadians, toTrianglesDrawMode };