minerender 2.1.0-alpha.62 → 2.1.0-alpha.64

package/dist/browser/index.d.mts

@@ -1054,6 +1054,7 @@ interface Instanceable {
     isInstanceActive(index: number, reference: InstanceReference<Instanceable>): boolean;
     getMatrixAt(index: number, matrix?: Matrix4): Matrix4;
     setMatrixAt(index: number, matrix: Matrix4): void;
+    setInstanceVisibleAt(index: number, visible: boolean): void;
     setPositionRotationScaleAt(index: number, position?: Vector3, rotation?: Euler, scale?: Vector3): void;
     setPositionAt(index: number, position: Vector3): void;
     getPositionAt(index: number, vector?: Vector3): Vector3;
@@ -1075,6 +1076,7 @@ declare class InstanceReference<T extends Instanceable> implements Transformable
     dispose(): void;
     getMatrix(matrix?: Matrix4): Matrix4;
     setMatrix(matrix: Matrix4): void;
+    setVisible(visible: boolean): void;
     setPositionRotationScale(position?: Vector3, rotation?: Euler, scale?: Vector3): void;
     setPosition(position: Vector3): void;
     getPosition(): Vector3;
@@ -1365,6 +1367,7 @@ declare class SceneObject extends Object3D<Object3DEventMap & {
     protected instanceMesh?: InstancedMesh;
     private readonly instanceReferences;
     private readonly freeInstanceIndices;
+    private readonly hiddenInstanceMatrices;
     constructor(options?: Partial<SceneObjectOptions>);
     set scene(scene: MineRenderScene);
     get scene(): MineRenderScene;
@@ -1412,6 +1415,7 @@ declare class SceneObject extends Object3D<Object3DEventMap & {
     protected activeInstanceIndices(): Iterable<number>;
     getMatrixAt(index: number, matrix?: Matrix4): Matrix4;
     setMatrixAt(index: number, matrix: Matrix4): void;
+    setInstanceVisibleAt(index: number, visible: boolean): void;
     setPositionRotationScaleAt(index: number, position?: Vector3, rotation?: Euler, scale?: Vector3): void;
     setPositionAt(index: number, position: Vector3): void;
     getPositionAt(index: number, vector?: Vector3): Vector3;
@@ -1479,6 +1483,8 @@ declare class BlockObject extends SceneObject {
     private removeEntities;
     /** Entity models drawn for this block instead of its block model; they are scene children, unlike the block. */
     get blockEntities(): readonly EntityObject[];
+    /** Sets visibility for this block's model instances and block entities. */
+    setVisible(visible: boolean): void;
     /**
      * Draws the block through the dataset's block-entity index. Returns false, leaving nothing behind,
      * when the block is not listed or one of its models cannot be loaded.
@@ -1551,7 +1557,11 @@ interface MultiBlockBlock extends Block {
 }
 
 declare class SchematicParser {
-    static parse(nbt: NBT): Promise<MultiBlockStructure>;
+    /**
+     * Parses a legacy schematic using custom mappings before the bundled defaults.
+     * Keys are `id:metadata`; values are block states such as `minecraft:oak_log[axis=x]`.
+     */
+    static parse(nbt: NBT, customMappings?: Readonly<Record<string, string>>): Promise<MultiBlockStructure>;
 }
 
 declare class StructureParser {
@@ -2308,6 +2318,7 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     private readonly data;
     private readonly renderedBlocks;
     private readonly sectionBlocks;
+    private readonly hiddenBlocks;
     private sectionMesh?;
     private meshDirty;
     constructor(scene: MineRenderScene, x: number, y: number, z: number, onBlocksChanged?: ((positions: Vector3[]) => Promise<void>) | undefined, sectionModels?: SectionModels | undefined);
@@ -2324,6 +2335,8 @@ declare class Chunk<SectionMeshing extends boolean = false> {
      * Set a block at integer chunk-local coordinates from 0 to 15.
      */
     setBlockInChunkAt(pos: Vector3, block?: Block, worldPos?: Vector3, onBlocksChanged?: ((positions: Vector3[]) => Promise<void>) | undefined): Promise<Maybe<BlockInfo<SectionMeshing>>>;
+    setBlockVisibleAt(pos: Vector3, visible: boolean): Promise<void>;
+    isBlockVisibleAt(pos: Vector3): boolean;
     isOccludingAt(pos: Vector3): boolean;
     setCullMaskAt(pos: Vector3, mask: number): Promise<void>;
     rebuildSectionMesh(): void;
@@ -2349,6 +2362,13 @@ declare class MineRenderWorld<SectionMeshing extends boolean = false> {
     setBlockAt(pos: Vector3, block: Maybe<Block>): Promise<Maybe<BlockInfo<SectionMeshing>>>;
     setBlockAt(pos: TripleArray, block: Maybe<Block>): Promise<Maybe<BlockInfo<SectionMeshing>>>;
     private placeBlock;
+    /**
+     * Shows or hides a placed block without changing its data. Hidden blocks do not occlude neighbors.
+     * Missing blocks are ignored; replacing or removing a block resets its visibility.
+     */
+    setBlockVisibleAt(x: number, y: number, z: number, visible: boolean): Promise<void>;
+    setBlockVisibleAt(pos: Vector3, visible: boolean): Promise<void>;
+    setBlockVisibleAt(pos: TripleArray, visible: boolean): Promise<void>;
     placeMultiBlock(multiblock: MultiBlockStructure, useBatches?: boolean, executor?: BatchedExecutor): Promise<void>;
     private placeBlocks;
     /** Replaces one chunk column's blocks. Entity NBT remains available on the parsed chunk. */

package/dist/browser/index.d.ts

@@ -1054,6 +1054,7 @@ interface Instanceable {
     isInstanceActive(index: number, reference: InstanceReference<Instanceable>): boolean;
     getMatrixAt(index: number, matrix?: Matrix4): Matrix4;
     setMatrixAt(index: number, matrix: Matrix4): void;
+    setInstanceVisibleAt(index: number, visible: boolean): void;
     setPositionRotationScaleAt(index: number, position?: Vector3, rotation?: Euler, scale?: Vector3): void;
     setPositionAt(index: number, position: Vector3): void;
     getPositionAt(index: number, vector?: Vector3): Vector3;
@@ -1075,6 +1076,7 @@ declare class InstanceReference<T extends Instanceable> implements Transformable
     dispose(): void;
     getMatrix(matrix?: Matrix4): Matrix4;
     setMatrix(matrix: Matrix4): void;
+    setVisible(visible: boolean): void;
     setPositionRotationScale(position?: Vector3, rotation?: Euler, scale?: Vector3): void;
     setPosition(position: Vector3): void;
     getPosition(): Vector3;
@@ -1365,6 +1367,7 @@ declare class SceneObject extends Object3D<Object3DEventMap & {
     protected instanceMesh?: InstancedMesh;
     private readonly instanceReferences;
     private readonly freeInstanceIndices;
+    private readonly hiddenInstanceMatrices;
     constructor(options?: Partial<SceneObjectOptions>);
     set scene(scene: MineRenderScene);
     get scene(): MineRenderScene;
@@ -1412,6 +1415,7 @@ declare class SceneObject extends Object3D<Object3DEventMap & {
     protected activeInstanceIndices(): Iterable<number>;
     getMatrixAt(index: number, matrix?: Matrix4): Matrix4;
     setMatrixAt(index: number, matrix: Matrix4): void;
+    setInstanceVisibleAt(index: number, visible: boolean): void;
     setPositionRotationScaleAt(index: number, position?: Vector3, rotation?: Euler, scale?: Vector3): void;
     setPositionAt(index: number, position: Vector3): void;
     getPositionAt(index: number, vector?: Vector3): Vector3;
@@ -1479,6 +1483,8 @@ declare class BlockObject extends SceneObject {
     private removeEntities;
     /** Entity models drawn for this block instead of its block model; they are scene children, unlike the block. */
     get blockEntities(): readonly EntityObject[];
+    /** Sets visibility for this block's model instances and block entities. */
+    setVisible(visible: boolean): void;
     /**
      * Draws the block through the dataset's block-entity index. Returns false, leaving nothing behind,
      * when the block is not listed or one of its models cannot be loaded.
@@ -1551,7 +1557,11 @@ interface MultiBlockBlock extends Block {
 }
 
 declare class SchematicParser {
-    static parse(nbt: NBT): Promise<MultiBlockStructure>;
+    /**
+     * Parses a legacy schematic using custom mappings before the bundled defaults.
+     * Keys are `id:metadata`; values are block states such as `minecraft:oak_log[axis=x]`.
+     */
+    static parse(nbt: NBT, customMappings?: Readonly<Record<string, string>>): Promise<MultiBlockStructure>;
 }
 
 declare class StructureParser {
@@ -2308,6 +2318,7 @@ declare class Chunk<SectionMeshing extends boolean = false> {
     private readonly data;
     private readonly renderedBlocks;
     private readonly sectionBlocks;
+    private readonly hiddenBlocks;
     private sectionMesh?;
     private meshDirty;
     constructor(scene: MineRenderScene, x: number, y: number, z: number, onBlocksChanged?: ((positions: Vector3[]) => Promise<void>) | undefined, sectionModels?: SectionModels | undefined);
@@ -2324,6 +2335,8 @@ declare class Chunk<SectionMeshing extends boolean = false> {
      * Set a block at integer chunk-local coordinates from 0 to 15.
      */
     setBlockInChunkAt(pos: Vector3, block?: Block, worldPos?: Vector3, onBlocksChanged?: ((positions: Vector3[]) => Promise<void>) | undefined): Promise<Maybe<BlockInfo<SectionMeshing>>>;
+    setBlockVisibleAt(pos: Vector3, visible: boolean): Promise<void>;
+    isBlockVisibleAt(pos: Vector3): boolean;
     isOccludingAt(pos: Vector3): boolean;
     setCullMaskAt(pos: Vector3, mask: number): Promise<void>;
     rebuildSectionMesh(): void;
@@ -2349,6 +2362,13 @@ declare class MineRenderWorld<SectionMeshing extends boolean = false> {
     setBlockAt(pos: Vector3, block: Maybe<Block>): Promise<Maybe<BlockInfo<SectionMeshing>>>;
     setBlockAt(pos: TripleArray, block: Maybe<Block>): Promise<Maybe<BlockInfo<SectionMeshing>>>;
     private placeBlock;
+    /**
+     * Shows or hides a placed block without changing its data. Hidden blocks do not occlude neighbors.
+     * Missing blocks are ignored; replacing or removing a block resets its visibility.
+     */
+    setBlockVisibleAt(x: number, y: number, z: number, visible: boolean): Promise<void>;
+    setBlockVisibleAt(pos: Vector3, visible: boolean): Promise<void>;
+    setBlockVisibleAt(pos: TripleArray, visible: boolean): Promise<void>;
     placeMultiBlock(multiblock: MultiBlockStructure, useBatches?: boolean, executor?: BatchedExecutor): Promise<void>;
     private placeBlocks;
     /** Replaces one chunk column's blocks. Entity NBT remains available on the parsed chunk. */

package/dist/browser/index.js

@@ -3461,6 +3461,9 @@ var init_InstanceReference = __esm({
       setMatrix(matrix) {
         this.activeInstanceable.setMatrixAt(this.index, matrix);
       }
+      setVisible(visible) {
+        this.activeInstanceable.setInstanceVisibleAt(this.index, visible);
+      }
       setPositionRotationScale(position, rotation, scale) {
         this.activeInstanceable.setPositionRotationScaleAt(this.index, position, rotation, scale);
       }
@@ -3515,6 +3518,7 @@ var init_SceneObject = __esm({
         this._instanceCounter = 0;
         this.instanceReferences = /* @__PURE__ */ new Map();
         this.freeInstanceIndices = [];
+        this.hiddenInstanceMatrices = /* @__PURE__ */ new Map();
         this.options = (0, import_ts_deepmerge3.default)({}, _SceneObject.DEFAULT_OPTIONS, options ?? {});
         console.log("SceneObject options", this.options);
       }
@@ -3709,6 +3713,7 @@ var init_SceneObject = __esm({
       removeInstanceAt(index) {
         if (!this.instanceReferences.has(index)) return;
         const mesh = this.instanceMesh;
+        this.hiddenInstanceMatrices.delete(index);
         this.setMatrixAt(index, new import_three12.Matrix4().makeScale(0, 0, 0));
         this.instanceReferences.delete(index);
         this.freeInstanceIndices.push(index);
@@ -3741,18 +3746,46 @@ var init_SceneObject = __esm({
       //<editor-fold desc="TRANSFORMATION">
       getMatrixAt(index, matrix = new import_three12.Matrix4()) {
         if (!this.instanceReferences.has(index)) throw new MineRenderError("Instance is not active");
+        const hidden = this.hiddenInstanceMatrices.get(index);
+        if (hidden) {
+          return matrix.copy(hidden);
+        }
         this.instanceMesh.getMatrixAt(index, matrix);
         return matrix;
       }
       setMatrixAt(index, matrix) {
         if (!this.instanceReferences.has(index)) throw new MineRenderError("Instance is not active");
         const mesh = this.instanceMesh;
-        mesh.setMatrixAt(index, matrix);
+        const hidden = this.hiddenInstanceMatrices.get(index);
+        if (hidden) {
+          hidden.copy(matrix);
+        }
+        mesh.setMatrixAt(index, hidden ? new import_three12.Matrix4().makeScale(0, 0, 0) : matrix);
         mesh.instanceMatrix.needsUpdate = true;
         mesh.boundingBox = null;
         mesh.boundingSphere = null;
         this.notifyDirty();
       }
+      setInstanceVisibleAt(index, visible) {
+        if (!this.instanceReferences.has(index)) {
+          throw new MineRenderError("Instance is not active");
+        }
+        const hidden = this.hiddenInstanceMatrices.get(index);
+        if (visible) {
+          if (!hidden) {
+            return;
+          }
+          this.hiddenInstanceMatrices.delete(index);
+          this.setMatrixAt(index, hidden);
+        } else {
+          if (hidden) {
+            return;
+          }
+          const matrix = this.getMatrixAt(index);
+          this.hiddenInstanceMatrices.set(index, matrix);
+          this.setMatrixAt(index, matrix);
+        }
+      }
       setPositionRotationScaleAt(index, position, rotation, scale) {
         if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
         const oldPosition = new import_three12.Vector3();
@@ -3892,6 +3925,7 @@ var init_SceneObject = __esm({
           if (this._scene) this._scene.stats.instanceCount -= this.instanceReferences.size;
           this.instanceReferences.clear();
           this.freeInstanceIndices.length = 0;
+          this.hiddenInstanceMatrices.clear();
           this._instanceCounter = 0;
           this.instanceMesh.count = 0;
           this.instanceMesh.dispose();
@@ -9263,6 +9297,21 @@ var _BlockObject = class _BlockObject extends SceneObject {
   get blockEntities() {
     return this._entities;
   }
+  /** Sets visibility for this block's model instances and block entities. */
+  setVisible(visible) {
+    this.visible = visible;
+    for (const model of this._models) {
+      if (isInstanceReference(model)) {
+        model.setVisible(visible);
+      } else {
+        model.visible = visible;
+      }
+    }
+    for (const entity of this._entities) {
+      entity.visible = visible;
+    }
+    this.notifyDirty();
+  }
   /**
    * Draws the block through the dataset's block-entity index. Returns false, leaving nothing behind,
    * when the block is not listed or one of its models cannot be loaded.
@@ -9296,6 +9345,7 @@ var _BlockObject = class _BlockObject extends SceneObject {
     BlockEntities.matrix(resolved, this._entityPlacement);
     this._entities = created;
     this.placeEntities();
+    this.setVisible(this.visible);
     return true;
   }
   placeEntities() {
@@ -9305,6 +9355,9 @@ var _BlockObject = class _BlockObject extends SceneObject {
     }
   }
   get isOccluding() {
+    if (!this.visible) {
+      return false;
+    }
     return this._models.some((model) => {
       const object = isInstanceReference(model) ? model.instanceable : model;
       return object.isOpaqueFullCube && this.getModelCullMask(model, 63) === 63;
@@ -9360,6 +9413,9 @@ var _BlockObject = class _BlockObject extends SceneObject {
     this._models = replacements;
     this._cullMask = worldMask;
     this.removeModels(previous.filter((model) => !replacements.includes(model)));
+    if (!this.visible) {
+      this.setVisible(false);
+    }
     this.notifyDirty();
   }
   get state() {
@@ -9395,6 +9451,9 @@ var _BlockObject = class _BlockObject extends SceneObject {
     this._isInstanced || (this._isInstanced = isInstanceReference(replacement));
     this._instanceCounter = this._isInstanced ? 1 : 0;
     if (previous) this.removeModels([previous]);
+    if (!this.visible) {
+      this.setVisible(false);
+    }
     this.notifyDirty();
   }
   nextInstance() {
@@ -9423,6 +9482,7 @@ var _BlockObject = class _BlockObject extends SceneObject {
       this._models.push(await this.createVariant(blockStateVariant));
     }
     await this.updateFluid(this._fluidSampler);
+    this.setVisible(this.visible);
   }
   async hasGeometry(variant) {
     const modelKey = AssetKey.parse("models", variant.model);
@@ -11260,7 +11320,11 @@ var legacyBlocks_default = {
 
 // src/model/multiblock/SchematicParser.ts
 var SchematicParser = class {
-  static async parse(nbt) {
+  /**
+   * Parses a legacy schematic using custom mappings before the bundled defaults.
+   * Keys are `id:metadata`; values are block states such as `minecraft:oak_log[axis=x]`.
+   */
+  static async parse(nbt, customMappings = {}) {
     const tags = nbt.value;
     if (tags.Materials?.type !== "string" || tags.Materials.value !== "Alpha") {
       throw new MineRenderError("Schematic Materials must be Alpha");
@@ -11302,15 +11366,16 @@ var SchematicParser = class {
       const high = packed >> (index & 1) * 4 & 15;
       const id = high << 8 | ids.value[index] & 255;
       const metadata = data.value[index] & 255;
-      const mapped = mapping[`${id}:${metadata}`];
+      const key = `${id}:${metadata}`;
+      const mapped = customMappings[key] ?? mapping[key];
       if (!mapped) throw new MineRenderError(`Unsupported legacy block ${id}:${metadata} at schematic index ${index}`);
       const [type, state] = mapped.split("[");
       if (type === "minecraft:air") continue;
       const properties = {};
       if (state) {
         for (const property of state.slice(0, -1).split(",")) {
-          const [key, value] = property.split("=");
-          properties[key] = value;
+          const [key2, value] = property.split("=");
+          properties[key2] = value;
         }
       }
       blocks.push({
@@ -14206,6 +14271,16 @@ var MineRenderWorld = class {
     const chunk = Chunk.isAir(value) ? this.getChunkAt(pos) : this.getOrCreateChunkAt(pos);
     return chunk?.setBlockInChunkAt(chunk.worldPosToChunkPos(pos), value, pos, onBlocksChanged);
   }
+  async setBlockVisibleAt(posOrX, yOrVisible, z, visible) {
+    if (typeof posOrX === "number") {
+      return this.setBlockVisibleAt(new import_three38.Vector3(posOrX, yOrVisible, z), visible);
+    }
+    if (isTripleArray(posOrX)) {
+      return this.setBlockVisibleAt(new import_three38.Vector3(...posOrX), yOrVisible);
+    }
+    this.validatePosBounds(posOrX);
+    await this.getChunkAt(posOrX)?.setBlockVisibleAt(posOrX, yOrVisible);
+  }
   async placeMultiBlock(multiblock, useBatches = true, executor) {
     const changes = /* @__PURE__ */ new Map();
     try {
@@ -14321,12 +14396,14 @@ var MineRenderWorld = class {
             if (!chunk) continue;
             changed.add(chunk);
             const block = chunk.getBlockAt(pos);
-            if (!block) continue;
+            if (!block || !chunk.isBlockVisibleAt(pos)) {
+              continue;
+            }
             if (block.object?.fluidKind) {
               await block.object.updateFluid((x, y, z) => {
                 const neighbor = pos.clone().add(new import_three38.Vector3(x, y, z));
                 const section = this.getChunkAt(neighbor);
-                const object = section?.getBlockAt(neighbor)?.object;
+                const object = section?.isBlockVisibleAt(neighbor) ? section.getBlockAt(neighbor)?.object : void 0;
                 return {
                   fluid: object?.fluidKind,
                   level: object?.fluidLevel,
@@ -14513,6 +14590,7 @@ var Chunk = class _Chunk {
     this.data = new ChunkData();
     this.renderedBlocks = /* @__PURE__ */ new Map();
     this.sectionBlocks = /* @__PURE__ */ new Map();
+    this.hiddenBlocks = /* @__PURE__ */ new Set();
     this.meshDirty = false;
     this.scene = scene;
     this.x = x;
@@ -14550,6 +14628,7 @@ var Chunk = class _Chunk {
       worldPos = this.chunkPosToWorldPos(pos);
     }
     const index = _Chunk.chunkPosToBlockIndex(pos);
+    this.hiddenBlocks.delete(index);
     this.data.set(index, block);
     const readBlock = this.data.snapshot(index);
     this.renderedBlocks.get(index)?.object?.removeFromScene();
@@ -14591,9 +14670,31 @@ var Chunk = class _Chunk {
       await onBlocksChanged?.([worldPos]);
     }
   }
+  async setBlockVisibleAt(pos, visible) {
+    const index = _Chunk.chunkPosToBlockIndex(this.worldPosToChunkPos(pos));
+    const block = this.renderedBlocks.get(index);
+    if (!block || visible === !this.hiddenBlocks.has(index)) {
+      return;
+    }
+    if (visible) {
+      this.hiddenBlocks.delete(index);
+    } else {
+      this.hiddenBlocks.add(index);
+    }
+    block.object?.setVisible(visible);
+    if (this.sectionBlocks.has(index)) {
+      this.meshDirty = true;
+    }
+    this.scene.dirty = true;
+    await this.onBlocksChanged?.([pos]);
+  }
+  isBlockVisibleAt(pos) {
+    const index = _Chunk.chunkPosToBlockIndex(this.worldPosToChunkPos(pos));
+    return this.renderedBlocks.has(index) && !this.hiddenBlocks.has(index);
+  }
   isOccludingAt(pos) {
     const index = _Chunk.chunkPosToBlockIndex(this.worldPosToChunkPos(pos));
-    return this.sectionBlocks.has(index) || (this.renderedBlocks.get(index)?.object?.isOccluding ?? false);
+    return !this.hiddenBlocks.has(index) && (this.sectionBlocks.has(index) || (this.renderedBlocks.get(index)?.object?.isOccluding ?? false));
   }
   async setCullMaskAt(pos, mask) {
     const index = _Chunk.chunkPosToBlockIndex(this.worldPosToChunkPos(pos));
@@ -14609,7 +14710,10 @@ var Chunk = class _Chunk {
   }
   rebuildSectionMesh() {
     if (!this.meshDirty) return;
-    const next = this.sectionBlocks.size ? SectionMesh.build([...this.sectionBlocks.values()], this.sectionModels.maxAtlasSize) : void 0;
+    const next = this.sectionBlocks.size ? SectionMesh.build(
+      [...this.sectionBlocks.values()].filter((entry) => !this.hiddenBlocks.has(entry.index)),
+      this.sectionModels.maxAtlasSize
+    ) : void 0;
     this.sectionMesh?.dispose();
     this.sectionMesh = next;
     if (next) {
@@ -14629,6 +14733,7 @@ var Chunk = class _Chunk {
     this.sectionMesh = void 0;
     this.meshDirty = false;
     this.renderedBlocks.clear();
+    this.hiddenBlocks.clear();
     this.data.clear();
     await onBlocksChanged?.(positions);
   }