minerender 2.1.0-alpha.143 → 2.1.0-alpha.145

package/dist/bundle.js

@@ -1896,40 +1896,6 @@ var MineRender = (() => {
     }
   });
 
-  // src/cache/PersistentCache.ts
-  var _PersistentCache, PersistentCache;
-  var init_PersistentCache = __esm({
-    "src/cache/PersistentCache.ts"() {
-      init_dirname();
-      init_buffer2();
-      init_process2();
-      init_Env();
-      _PersistentCache = class _PersistentCache {
-        constructor(backing) {
-          this.backing = backing;
-        }
-        /** Opens a named store in the active environment using the current cache schema version. */
-        static open(name2) {
-          return Env.provider.openCache(name2, _PersistentCache.VERSION);
-        }
-        /** Loads a missing entry and stores only non-nullish results. */
-        async getOrLoad(key, loader) {
-          let v5 = await this.get(key);
-          if (typeof v5 === "undefined" || v5 === null) {
-            v5 = await loader(key);
-            if (typeof v5 !== "undefined" && v5 !== null) {
-              await this.put(key, v5);
-            }
-          }
-          return v5;
-        }
-      };
-      /** Bump to invalidate every persisted entry. */
-      _PersistentCache.VERSION = 2;
-      PersistentCache = _PersistentCache;
-    }
-  });
-
   // src/util/log.ts
   function readSwitch() {
     switchRead = true;
@@ -2014,6 +1980,40 @@ var MineRender = (() => {
     }
   });
 
+  // src/cache/PersistentCache.ts
+  var _PersistentCache, PersistentCache;
+  var init_PersistentCache = __esm({
+    "src/cache/PersistentCache.ts"() {
+      init_dirname();
+      init_buffer2();
+      init_process2();
+      init_Env();
+      _PersistentCache = class _PersistentCache {
+        constructor(backing) {
+          this.backing = backing;
+        }
+        /** Opens a named store in the active environment using the current cache schema version. */
+        static open(name2) {
+          return Env.provider.openCache(name2, _PersistentCache.VERSION);
+        }
+        /** Loads a missing entry and stores only non-nullish results. */
+        async getOrLoad(key, loader) {
+          let v5 = await this.get(key);
+          if (typeof v5 === "undefined" || v5 === null) {
+            v5 = await loader(key);
+            if (typeof v5 !== "undefined" && v5 !== null) {
+              await this.put(key, v5);
+            }
+          }
+          return v5;
+        }
+      };
+      /** Bump to invalidate every persisted entry. */
+      _PersistentCache.VERSION = 2;
+      PersistentCache = _PersistentCache;
+    }
+  });
+
   // ../../node_modules/localforage/dist/localforage.js
   var require_localforage = __commonJS({
     "../../node_modules/localforage/dist/localforage.js"(exports13, module2) {
@@ -4180,7 +4180,7 @@ var MineRender = (() => {
     canvas.style.display = "block";
     return canvas;
   }
-  function log2(...params) {
+  function log3(...params) {
     const message = "THREE." + params.shift();
     if (_setConsoleFunction) {
       _setConsoleFunction("log", message, ...params);
@@ -15870,7 +15870,7 @@ var MineRender = (() => {
          */
         clone(data) {
           if (data === void 0) {
-            log2("InterleavedBufferAttribute.clone(): Cloning an interleaved buffer attribute will de-interleave buffer data.");
+            log3("InterleavedBufferAttribute.clone(): Cloning an interleaved buffer attribute will de-interleave buffer data.");
             const array = [];
             for (let i4 = 0; i4 < this.count; i4++) {
               const index = i4 * this.data.stride + this.offset;
@@ -15899,7 +15899,7 @@ var MineRender = (() => {
          */
         toJSON(data) {
           if (data === void 0) {
-            log2("InterleavedBufferAttribute.toJSON(): Serializing an interleaved buffer attribute will de-interleave buffer data.");
+            log3("InterleavedBufferAttribute.toJSON(): Serializing an interleaved buffer attribute will de-interleave buffer data.");
             const array = [];
             for (let i4 = 0; i4 < this.count; i4++) {
               const index = i4 * this.data.stride + this.offset;
@@ -31890,11 +31890,11 @@ void main() {
           };
           function onContextLost(event) {
             event.preventDefault();
-            log2("WebGLRenderer: Context Lost.");
+            log3("WebGLRenderer: Context Lost.");
             _isContextLost = true;
           }
           function onContextRestore() {
-            log2("WebGLRenderer: Context Restored.");
+            log3("WebGLRenderer: Context Restored.");
             _isContextLost = false;
             const infoAutoReset = info.autoReset;
             const shadowMapEnabled = shadowMap.enabled;
@@ -36232,7 +36232,7 @@ void main() {
       signal.removeEventListener("abort", abort2);
     }
   }
-  var import_jobqu, log3, RequestError, RequestQueue, Requests;
+  var import_jobqu, log4, RequestError, RequestQueue, Requests;
   var init_Requests = __esm({
     "src/request/Requests.ts"() {
       init_dirname();
@@ -36240,7 +36240,7 @@ void main() {
       init_process2();
       import_jobqu = __toESM(require_src());
       init_log();
-      log3 = logger("Requests");
+      log4 = logger("Requests");
       RequestError = class extends Error {
         constructor(message, response, cause) {
           super(message);
@@ -36267,7 +36267,7 @@ void main() {
               try {
                 return await abortable(this.queue.add(request), signal);
               } catch (error2) {
-                log3.debug("Request failed", error2);
+                log4.debug("Request failed", error2);
                 const delay = this.retryDelay(error2, request, retries);
                 if (delay === void 0) {
                   throw error2;
@@ -36455,7 +36455,7 @@ void main() {
   });
 
   // src/image/ImageLoader.ts
-  var log4, ImageLoader2;
+  var log5, ImageLoader2;
   var init_ImageLoader = __esm({
     "src/image/ImageLoader.ts"() {
       init_dirname();
@@ -36469,7 +36469,7 @@ void main() {
       init_WrappedImage();
       init_base64();
       init_log();
-      log4 = logger("ImageLoader");
+      log5 = logger("ImageLoader");
       ImageLoader2 = class _ImageLoader {
         static _createImage() {
           return createImage();
@@ -36494,7 +36494,7 @@ void main() {
           return image;
         }
         static async loadData(src) {
-          log4.debug("loadData", src);
+          log5.debug("loadData", src);
           const image = await this.loadCanvasData(src);
           return image.data.getImageData(0, 0, image.width, image.height);
         }
@@ -36601,7 +36601,7 @@ void main() {
   });
 
   // src/texture/TextureLoader.ts
-  var log5, TextureLoader2;
+  var log6, TextureLoader2;
   var init_TextureLoader = __esm({
     "src/texture/TextureLoader.ts"() {
       init_dirname();
@@ -36612,7 +36612,7 @@ void main() {
       init_ImageLoader();
       init_Textures();
       init_log();
-      log5 = logger("TextureLoader");
+      log6 = logger("TextureLoader");
       TextureLoader2 = class {
         /** Reports whether image loading failed, so cached textures can be retried. */
         static hasFailed(texture) {
@@ -36628,7 +36628,7 @@ void main() {
             texture.needsUpdate = true;
           }, (error2) => {
             this.failedTextures.add(texture);
-            log5.warn("Failed to load texture", src, error2);
+            log6.warn("Failed to load texture", src, error2);
           });
           texture.image = image;
           texture.format = format3;
@@ -36644,7 +36644,7 @@ void main() {
             texture.needsUpdate = true;
           }).catch((error2) => {
             this.failedTextures.add(texture);
-            log5.warn("Failed to load texture", src, error2);
+            log6.warn("Failed to load texture", src, error2);
           });
           texture.format = format3;
           texture.rotation = rotation;
@@ -36723,7 +36723,7 @@ void main() {
   });
 
   // src/Materials.ts
-  var log6, Materials;
+  var log7, Materials;
   var init_Materials = __esm({
     "src/Materials.ts"() {
       init_dirname();
@@ -36735,7 +36735,7 @@ void main() {
       init_TextureLoader();
       init_Caching();
       init_log();
-      log6 = logger("Materials");
+      log7 = logger("Materials");
       Materials = class _Materials {
         /** Shared checkerboard material, created on first access. */
         static get MISSING_TEXTURE() {
@@ -37006,7 +37006,7 @@ void main() {
             Object.assign(material.defaultAttributeValues, { shade: [1], uvBounds: [0, 0, 1, 1] });
             return material;
           } catch (e6) {
-            log6.warn(e6);
+            log7.warn(e6);
           }
           return this.createBasicCanvasMaterial(canvas, transparent, shade);
         }
@@ -58568,7 +58568,7 @@ void main() {
     exports$17.callbackify = callbackify2;
     return exports$17;
   }
-  var exports$c4, _dewExec$b4, exports$b4, _dewExec$a4, exports$a4, _dewExec$94, exports$94, _dewExec$84, exports$84, _dewExec$74, exports$74, _dewExec$64, exports$64, _dewExec$54, _global$22, exports$54, _dewExec$44, _global$12, exports$44, _dewExec$34, exports$34, _dewExec$25, exports$25, _dewExec$15, exports$17, _dewExec9, _global4, exports11, _extend, callbackify, debuglog, deprecate, format, inherits, inspect, isArray, isBoolean, isBuffer, isDate, isError, isFunction, isNull, isNullOrUndefined, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, log7, promisify3, types, TextEncoder2, TextDecoder2;
+  var exports$c4, _dewExec$b4, exports$b4, _dewExec$a4, exports$a4, _dewExec$94, exports$94, _dewExec$84, exports$84, _dewExec$74, exports$74, _dewExec$64, exports$64, _dewExec$54, _global$22, exports$54, _dewExec$44, _global$12, exports$44, _dewExec$34, exports$34, _dewExec$25, exports$25, _dewExec$15, exports$17, _dewExec9, _global4, exports11, _extend, callbackify, debuglog, deprecate, format, inherits, inspect, isArray, isBoolean, isBuffer, isDate, isError, isFunction, isNull, isNullOrUndefined, isNumber, isObject, isPrimitive, isRegExp, isString, isSymbol, isUndefined, log8, promisify3, types, TextEncoder2, TextDecoder2;
   var init_util3 = __esm({
     "../../node_modules/@jspm/core/nodelibs/browser/util.js"() {
       init_dirname();
@@ -58652,7 +58652,7 @@ void main() {
       isString = exports11.isString;
       isSymbol = exports11.isSymbol;
       isUndefined = exports11.isUndefined;
-      log7 = exports11.log;
+      log8 = exports11.log;
       promisify3 = exports11.promisify;
       types = exports11.types;
       TextEncoder2 = exports11.TextEncoder = globalThis.TextEncoder;
@@ -71058,7 +71058,7 @@ return ${compiler2.callType("value", tagType)}
   });
 
   // src/assets/source/HostedAssetSource.ts
-  var BINARY_TIMEOUT, log8, DEFAULT_OPTIONS2, _HostedAssetSource, HostedAssetSource;
+  var BINARY_TIMEOUT, log9, DEFAULT_OPTIONS2, _HostedAssetSource, HostedAssetSource;
   var init_HostedAssetSource = __esm({
     "src/assets/source/HostedAssetSource.ts"() {
       init_dirname();
@@ -71075,7 +71075,7 @@ return ${compiler2.callType("value", tagType)}
       init_parser();
       init_merge();
       BINARY_TIMEOUT = 6e4;
-      log8 = logger("HostedAssetSource");
+      log9 = logger("HostedAssetSource");
       DEFAULT_OPTIONS2 = {
         retryDefaults: true
       };
@@ -71087,14 +71087,14 @@ return ${compiler2.callType("value", tagType)}
             return direct;
           }
           if (key.namespace !== DEFAULT_NAMESPACE) {
-            log8.debug("Retrying", key, "with default namespace");
+            log9.debug("Retrying", key, "with default namespace");
             const namespaceKey = new AssetKey(DEFAULT_NAMESPACE, key.path, key.assetType, key.type, key.rootType, key.extension, key.root);
             const namespaced = await this.load(namespaceKey, parser);
             if (typeof namespaced !== "undefined") {
               return namespaced;
             }
             if (typeof key.root !== "undefined" && key.root !== AssetLoader.ROOT || typeof this.root !== "undefined" && this.root !== AssetLoader.ROOT) {
-              log8.debug("Retrying", key, "with default root+namespace");
+              log9.debug("Retrying", key, "with default root+namespace");
               const namespacedRootedKey = new AssetKey(DEFAULT_NAMESPACE, key.path, key.assetType, key.type, key.rootType, key.extension, AssetLoader.ROOT);
               const namespacedRooted = await this.load(namespacedRootedKey, parser);
               if (typeof namespacedRooted !== "undefined") {
@@ -71102,7 +71102,7 @@ return ${compiler2.callType("value", tagType)}
               }
             }
           } else if (typeof key.root !== "undefined" && key.root !== AssetLoader.ROOT || typeof this.root !== "undefined" && this.root !== AssetLoader.ROOT) {
-            log8.debug("Retrying", key, "with default root");
+            log9.debug("Retrying", key, "with default root");
             const rootKey = new AssetKey(key.namespace, key.path, key.assetType, key.type, key.rootType, key.extension, AssetLoader.ROOT);
             const rooted = await this.load(rootKey, parser);
             if (typeof rooted !== "undefined") {
@@ -71113,7 +71113,7 @@ return ${compiler2.callType("value", tagType)}
         }
         async load(key, parser) {
           const url = `${this.assetBasePath(key)}${key.type !== void 0 ? key.type + "/" : ""}${key.path}${key.extension}`;
-          log8.debug("Loading", url);
+          log9.debug("Loading", url);
           const request = { url };
           try {
             parser.config(request);
@@ -81239,7 +81239,7 @@ return ${compiler2.callType("value", tagType)}
   });
 
   // src/assets/AssetLoader.ts
-  var log9, AssetLoader;
+  var log10, AssetLoader;
   var init_AssetLoader = __esm({
     "src/assets/AssetLoader.ts"() {
       init_dirname();
@@ -81250,7 +81250,7 @@ return ${compiler2.callType("value", tagType)}
       init_log();
       init_source();
       init_Caching();
-      log9 = logger("AssetLoader");
+      log10 = logger("AssetLoader");
       AssetLoader = class {
         static get _SOURCES() {
           return this.sources ?? (this.sources = [{ key: "mcassets", source: new HostedAssetSource(this.ROOT, { retryDefaults: false }) }]);
@@ -81305,11 +81305,11 @@ ${key}` : key;
           if (override) {
             const existing = this.removeSource(key);
             if (existing) {
-              log9.info("Removed existing AssetSource", key);
+              log10.info("Removed existing AssetSource", key);
             }
           }
           this._SOURCES.unshift({ key, source });
-          log9.info("Added AssetSource", key);
+          log10.info("Added AssetSource", key);
         }
         /** Removes and returns the first source with this name. Call {@link Caching.clear} to reload assets. */
         static removeSource(key) {
@@ -81495,14 +81495,14 @@ ${key}` : key;
   });
 
   // src/Ticker.ts
-  var log10, _Ticker, Ticker;
+  var log11, _Ticker, Ticker;
   var init_Ticker = __esm({
     "src/Ticker.ts"() {
       init_dirname();
       init_buffer2();
       init_process2();
       init_log();
-      log10 = logger("Ticker");
+      log11 = logger("Ticker");
       _Ticker = class _Ticker {
         static schedule(fn, ms) {
           const handle = setInterval(fn, ms);
@@ -81520,7 +81520,7 @@ ${key}` : key;
               try {
                 t5();
               } catch (e6) {
-                log10.warn(e6);
+                log11.warn(e6);
               }
             });
             _Ticker.oneSecondTicks++;
@@ -81774,7 +81774,7 @@ ${key}` : key;
   });
 
   // src/UVMapper.ts
-  var log11, X3, Y4, Z3, FACE_UV_AXES, UVMapper, MinecraftFaceUV;
+  var log12, X3, Y4, Z3, FACE_UV_AXES, UVMapper, MinecraftFaceUV;
   var init_UVMapper = __esm({
     "src/UVMapper.ts"() {
       init_dirname();
@@ -81792,7 +81792,7 @@ ${key}` : key;
       init_ModelGenerator();
       init_log();
       init_cubeUv();
-      log11 = logger("UVMapper");
+      log12 = logger("UVMapper");
       X3 = 0;
       Y4 = 1;
       Z3 = 2;
@@ -82025,7 +82025,7 @@ ${key}` : key;
             model.elements = originalModel.elements.map((element) => ({ ...element }));
           }
           const isItemModel = !("elements" in model);
-          log11.debug("Creating Atlas for", model.key);
+          log12.debug("Creating Atlas for", model.key);
           if (model.textures) {
             const promises = [];
             const uniqueTextureNames = [];
@@ -82039,7 +82039,7 @@ ${key}` : key;
                 const assetKey = AssetKey.parse("textures", textureValue, model.key);
                 promises.push(ModelTextures.get(assetKey).then((asset2) => {
                   if (!asset2) {
-                    log11.warn("Missing texture", assetKey);
+                    log12.warn("Missing texture", assetKey);
                     return;
                   }
                   textureMap[textureKey] = new WrappedImage(asset2);
@@ -82051,7 +82051,7 @@ ${key}` : key;
             }
             await Promise.all(promises);
             const textureCount = uniqueTextureNames.length;
-            log11.debug("Creating Atlas for", textureCount, "textures");
+            log12.debug("Creating Atlas for", textureCount, "textures");
             this.fillMissingTextureKeys(model.textures, textureMap);
             this.fillMissingTextureKeys(model.textures, metaMap);
             const sizes = {};
@@ -82082,7 +82082,7 @@ ${key}` : key;
             this.fillMissingTextureKeys(model.textures, sizes);
             const s4 = Math.ceil(Math.sqrt(textureCount + 1));
             const size = Math.ceil(s4 * maxWidth);
-            log11.debug("Atlas size:", size);
+            log12.debug("Atlas size:", size);
             const squaredSize = size * size;
             const image = new CanvasImage(size, size);
             const missing = Textures.getMissing().image;
@@ -82161,7 +82161,7 @@ ${key}` : key;
             }
             this.fillMissingTextureKeys(model.textures, positions);
             if (isItemModel) {
-              log11.debug("Generating item model for", model);
+              log12.debug("Generating item model for", model);
               model.elements = [];
               for (let layerName of ModelGenerator.ITEM_LAYERS) {
                 const textureImage = textureMap[layerName];
@@ -82177,7 +82177,7 @@ ${key}` : key;
                   ), layerName));
                 }
               }
-              log11.debug("Item model elements", model.elements);
+              log12.debug("Item model elements", model.elements);
             }
             if (!model.elements) {
             }
@@ -82234,7 +82234,7 @@ ${key}` : key;
               hasTranslucency
             );
           } else {
-            log11.warn("Model does not have any textures", model);
+            log12.warn("Model does not have any textures", model);
           }
           return void 0;
         }
@@ -83770,7 +83770,7 @@ ${key}` : key, async () => {
   });
 
   // src/assets/BlockEntities.ts
-  var log12, BlockEntities;
+  var log13, BlockEntities;
   var init_BlockEntities = __esm({
     "src/assets/BlockEntities.ts"() {
       init_dirname();
@@ -83783,7 +83783,7 @@ ${key}` : key, async () => {
       init_source();
       init_Caching();
       init_log();
-      log12 = logger("BlockEntities");
+      log13 = logger("BlockEntities");
       BlockEntities = class {
         /**
          * Loads the block index of a version. Versions and sources without one yield an empty index, and so does
@@ -83798,7 +83798,7 @@ ${key}` : key, async () => {
               key.root = await Entities.getDatasetRoot(root);
               return await AssetLoader.get(key, "json" /* JSON */) ?? {};
             } catch (error2) {
-              log12.warn("Could not load the block entity index; block entities are drawn as plain block models", error2);
+              log13.warn("Could not load the block entity index; block entities are drawn as plain block models", error2);
               return {};
             }
           });
@@ -83942,7 +83942,7 @@ ${key}` : key, async () => {
       }
       return { indices, rows, metrics };
     } catch (error2) {
-      log13.warn(`Could not load Unihex file ${key.toNamespacedString()}`, error2);
+      log14.warn(`Could not load Unihex file ${key.toNamespacedString()}`, error2);
       return void 0;
     }
   }
@@ -83961,7 +83961,7 @@ ${key}` : key, async () => {
         return { ...override, from, to };
       });
     } catch (error2) {
-      log13.warn(`Could not load Unihex file ${key.toNamespacedString()}`, error2);
+      log14.warn(`Could not load Unihex file ${key.toNamespacedString()}`, error2);
       return glyphs;
     }
     const file = await Caching.unihexCache.get(key.serialize(), () => parseUnihex(key));
@@ -84009,7 +84009,7 @@ ${key}` : key, async () => {
     }
     return glyphs;
   }
-  var log13, ATLAS_SIZE, GLYPH_HEIGHT, UnihexAtlas, atlases;
+  var log14, ATLAS_SIZE, GLYPH_HEIGHT, UnihexAtlas, atlases;
   var init_Unihex = __esm({
     "src/assets/_fonts/Unihex.ts"() {
       init_dirname();
@@ -84023,7 +84023,7 @@ ${key}` : key, async () => {
       init_AssetParsers();
       init_CanvasCompat();
       init_log();
-      log13 = logger("Unihex");
+      log14 = logger("Unihex");
       ATLAS_SIZE = 512;
       GLYPH_HEIGHT = 16;
       UnihexAtlas = class {
@@ -88252,7 +88252,7 @@ ${key}` : key, async () => {
   });
 
   // src/skin/Skins.ts
-  var log14, Skins;
+  var log15, Skins;
   var init_Skins = __esm({
     "src/skin/Skins.ts"() {
       init_dirname();
@@ -88261,7 +88261,7 @@ ${key}` : key, async () => {
       init_Requests();
       init_Caching();
       init_log();
-      log14 = logger("Skins");
+      log15 = logger("Skins");
       Skins = class {
         //<editor-fold desc="Skins">
         /** Returns a skin URL for {@link MineRenderScene.addSkin}, or `undefined` if name lookup fails. */
@@ -88333,7 +88333,7 @@ ${key}` : key, async () => {
             }
             return void 0;
           }).catch((err2) => {
-            log14.warn(err2);
+            log15.warn(err2);
             return void 0;
           });
         }
@@ -88348,7 +88348,7 @@ ${key}` : key, async () => {
             }
             return void 0;
           }).catch((err2) => {
-            log14.warn(err2);
+            log15.warn(err2);
             return void 0;
           });
         }
@@ -88362,7 +88362,7 @@ ${key}` : key, async () => {
             }
             return void 0;
           }).catch((err2) => {
-            log14.warn(err2);
+            log15.warn(err2);
             return void 0;
           });
         }
@@ -88386,7 +88386,7 @@ ${key}` : key, async () => {
             }
             return void 0;
           }).catch((err2) => {
-            log14.warn(err2);
+            log15.warn(err2);
             return void 0;
           });
         }
@@ -91940,7 +91940,7 @@ ${shader.fragmentShader}`.replace(
   function isModelObject(obj) {
     return obj.isModelObject;
   }
-  var log15, _ModelObject, ModelObject;
+  var log16, _ModelObject, ModelObject;
   var init_ModelObject = __esm({
     "src/model/scene/ModelObject.ts"() {
       init_dirname();
@@ -91963,7 +91963,7 @@ ${shader.fragmentShader}`.replace(
       init_GuiLight();
       init_ItemTints();
       init_ItemGlint();
-      log15 = logger("ModelObject");
+      log16 = logger("ModelObject");
       _ModelObject = class _ModelObject extends SceneObject {
         constructor(originalModel, options) {
           super(options);
@@ -92145,10 +92145,10 @@ ${shader.fragmentShader}`.replace(
                 }
               });
             } else {
-              log15.debug(this.atlas.model, "has no elements");
+              log16.debug(this.atlas.model, "has no elements");
             }
           } else {
-            log15.debug("Missing atlas for", this);
+            log16.debug("Missing atlas for", this);
           }
           if (this.options.mergeMeshes) {
             let combinedGeo;
@@ -92978,7 +92978,7 @@ ${shader.fragmentShader}`.replace(
   function isBlockObject(obj) {
     return obj.isBlockObject;
   }
-  var log18, _BlockObject, BlockObject;
+  var log19, _BlockObject, BlockObject;
   var init_BlockObject = __esm({
     "src/model/block/scene/BlockObject.ts"() {
       init_dirname();
@@ -93001,7 +93001,7 @@ ${shader.fragmentShader}`.replace(
       init_Entities();
       init_Biomes();
       init_log();
-      log18 = logger("BlockObject");
+      log19 = logger("BlockObject");
       _BlockObject = class _BlockObject extends SceneObject {
         constructor(blockState3, options) {
           super(options);
@@ -93106,7 +93106,7 @@ ${shader.fragmentShader}`.replace(
               created.push(await this.scene.addEntity(entity, { wireframe: this.options.wireframe }));
             }
           } catch (error2) {
-            log18.warn(`Could not draw block entity ${key.toNamespacedString()}, using its block model`, error2);
+            log19.warn(`Could not draw block entity ${key.toNamespacedString()}, using its block model`, error2);
             this.removeEntities(created);
             return false;
           }
@@ -94486,6 +94486,7 @@ ${shader.fragmentShader}`.replace(
   init_buffer2();
   init_process2();
   init_Env();
+  init_log();
 
   // src/env/browser/BrowserCache.ts
   init_dirname();
@@ -94592,6 +94593,7 @@ ${shader.fragmentShader}`.replace(
 
   // src/env/browser/BrowserEnv.ts
   var import_meta = {};
+  var log2 = logger("BrowserEnv");
   function lazyLocalForage(options) {
     let instance;
     const store = () => instance ?? (instance = Promise.resolve().then(() => __toESM(require_localforage())).then((module2) => module2.default.createInstance(options)));
@@ -94607,7 +94609,8 @@ ${shader.fragmentShader}`.replace(
     };
   }
   var BrowserEnv = class {
-    constructor() {
+    constructor(options = {}) {
+      this.options = options;
       this.name = "browser";
     }
     createCanvas(width, height) {
@@ -94636,14 +94639,18 @@ ${shader.fragmentShader}`.replace(
     createWorker(name2) {
       if (name2 !== "section" || typeof Worker === "undefined") return void 0;
       try {
+        const sectionWorker = this.options.sectionWorker;
+        if (typeof sectionWorker === "function") return sectionWorker();
+        if (sectionWorker !== void 0) return new Worker(sectionWorker, { type: "module" });
         return new Worker(new URL("./section.worker.mjs", import_meta.url), { type: "module" });
-      } catch {
+      } catch (error2) {
+        log2.warn("Could not start the section worker, so sections build on the main thread. Pass sectionWorker to registerBrowserEnv to load it from another URL.", error2);
         return void 0;
       }
     }
   };
-  function registerBrowserEnv() {
-    const env3 = new BrowserEnv();
+  function registerBrowserEnv(options) {
+    const env3 = new BrowserEnv(options);
     Env.register(env3);
     return env3;
   }
@@ -96138,7 +96145,7 @@ property list uchar int vertex_index
   init_util();
   init_log();
   init_three();
-  var log16 = logger("SceneInspector");
+  var log17 = logger("SceneInspector");
   var help = "<span>Ctrl/Cmd+Click to Select<br/></span><br/>";
   var SceneInspector = class {
     constructor(renderer) {
@@ -96232,7 +96239,7 @@ property list uchar int vertex_index
     }
     selectObject(targetObject, targetIntersection, instance = this.getIntersectionInstance(targetIntersection)) {
       this.selectedObject = targetObject;
-      log16.debug("selected", targetObject);
+      log17.debug("selected", targetObject);
       this.redraw(targetObject, targetIntersection, instance);
     }
     redraw(targetObject, targetIntersection, instance) {
@@ -96503,7 +96510,7 @@ property list uchar int vertex_index
   init_buffer2();
   init_process2();
   init_log();
-  var log17 = logger("InstanceManager");
+  var log18 = logger("InstanceManager");
   var InstanceManager = class {
     constructor() {
       this.isInstanceManager = true;
@@ -96512,7 +96519,7 @@ property list uchar int vertex_index
     /** Allocates a new placement of a cached model, or returns `undefined` if the key is unknown. */
     async get(key) {
       if (key in this.instanceCache) {
-        log17.debug("key in cache", key);
+        log18.debug("key in cache", key);
         return (await this.instanceCache[key]).nextInstance();
       }
       return void 0;
@@ -96522,7 +96529,7 @@ property list uchar int vertex_index
       if (key in this.instanceCache) {
         return await this.get(key);
       }
-      log17.debug("key not in cache", key);
+      log18.debug("key not in cache", key);
       const pending = Promise.resolve().then(supplier).then((obj) => obj.nextInstance());
       this.instanceCache[key] = pending;
       try {
@@ -101213,7 +101220,7 @@ gl_FragDepth=readDepth(vUv);
 
   // src/renderer/Renderer.ts
   init_log();
-  var log19 = logger("Renderer");
+  var log20 = logger("Renderer");
   var _Renderer = class _Renderer {
     constructor(options, surface) {
       this._width = 0;
@@ -101458,10 +101465,10 @@ gl_FragDepth=readDepth(vUv);
       this._element = element;
       this._element.appendChild(this.renderer.domElement);
       if (this.viewWidth == 0) {
-        log19.warn("0 element width");
+        log20.warn("0 element width");
       }
       if (this.viewHeight == 0) {
-        log19.warn("0 element height");
+        log20.warn("0 element height");
       }
       this.resize(this.viewWidth, this.viewHeight);
     }
@@ -103237,6 +103244,7 @@ gl_FragDepth=readDepth(vUv);
   init_dirname();
   init_buffer2();
   init_process2();
+  init_BlockObject();
   init_three_module();
   init_BlockStates();
   init_AssetKey();
@@ -103250,6 +103258,7 @@ gl_FragDepth=readDepth(vUv);
   init_util();
   init_AssetKey();
   init_BlockStates();
+  init_BlockEntities();
   init_CubeFace();
 
   // src/world/SectionModels.ts
@@ -103350,6 +103359,10 @@ gl_FragDepth=readDepth(vUv);
         biomeTint: source ? [...templates.values()].some((template) => template.biomeTint?.some((value) => value === 1)) || void 0 : void 0
       };
     }
+    /** Starts loading the state's models and atlases so a later `prepareState` with the same properties finds them loaded. */
+    async preload(blockState3, properties = {}) {
+      await this.state(blockState3, properties);
+    }
     async state(blockState3, properties) {
       let states = this.states.get(blockState3);
       if (!states) this.states.set(blockState3, states = /* @__PURE__ */ new Map());
@@ -103372,22 +103385,24 @@ gl_FragDepth=readDepth(vUv);
     async prepare(blockState3, properties) {
       const state = { ...await BlockStateResolver.defaults(blockState3), ...properties };
       const groups = BlockStateResolver.matching(blockState3, state);
-      if (!groups.length) return void 0;
+      if (!groups.length || groups.some((group) => Array.isArray(group) && !group.length)) return void 0;
+      const variants = groups.flatMap((group) => Array.isArray(group) ? group : [group]);
+      if (variants.some((variant) => !variant.model)) return void 0;
+      const settled = await Promise.allSettled(variants.map(async (variant) => {
+        const modelKey = AssetKey.parse("models", variant.model);
+        modelKey.root = blockState3.key?.root;
+        const model = await Models.getMerged(modelKey);
+        if (!model?.elements?.length) return void 0;
+        const atlas = await UVMapper.getAtlas(model);
+        const rotation = BlockStateResolver.rotation(variant);
+        if (!atlas || atlas.image.width > this.maxAtlasSize || atlas.image.height > this.maxAtlasSize) return void 0;
+        return { model, atlas, rotation };
+      }));
       const prepared = /* @__PURE__ */ new Map();
-      for (const group of groups) {
-        const choices = Array.isArray(group) ? group : [group];
-        if (!choices.length) return void 0;
-        for (const variant of choices) {
-          if (!variant.model) return void 0;
-          const modelKey = AssetKey.parse("models", variant.model);
-          modelKey.root = blockState3.key?.root;
-          const model = await Models.getMerged(modelKey);
-          if (!model?.elements?.length) return void 0;
-          const atlas = await UVMapper.getAtlas(model);
-          const rotation = BlockStateResolver.rotation(variant);
-          if (!atlas || atlas.image.width > this.maxAtlasSize || atlas.image.height > this.maxAtlasSize) return void 0;
-          prepared.set(variant, { model, atlas, rotation });
-        }
+      for (const [i4, result] of settled.entries()) {
+        if (result.status === "rejected") throw result.reason;
+        if (!result.value) return void 0;
+        prepared.set(variants[i4], result.value);
       }
       return { state, groups, choices: prepared };
     }
@@ -103573,7 +103588,7 @@ gl_FragDepth=readDepth(vUv);
 
   // src/world/_entities/WorldEntities.ts
   init_log();
-  var log20 = logger("WorldEntities");
+  var log21 = logger("WorldEntities");
   var WorldEntities = class {
     constructor(scene) {
       this.scene = scene;
@@ -103642,7 +103657,7 @@ gl_FragDepth=readDepth(vUv);
             placement.owner.set(object4, { type: key.toNamespacedString(), position: placement.position });
             this.scene.add(object4);
           } catch (error2) {
-            log20.warn(`Could not draw saved entity ${placement.key.toNamespacedString()}, skipping it`, error2);
+            log21.warn(`Could not draw saved entity ${placement.key.toNamespacedString()}, skipping it`, error2);
           } finally {
             if (object4 && !placement.owner.has(object4)) object4.dispose();
           }
@@ -103864,7 +103879,7 @@ gl_FragDepth=readDepth(vUv);
 
   // src/world/MineRenderWorld.ts
   init_log();
-  var log21 = logger("MineRenderWorld");
+  var log22 = logger("MineRenderWorld");
   var YIELD_INTERVAL_MS = 8;
   var MineRenderWorld = class {
     constructor(scene, options = {}) {
@@ -104080,15 +104095,18 @@ gl_FragDepth=readDepth(vUv);
         const key = AssetKey.parse("blockstates", block.type);
         keys.set(key.serialize(), key);
       }
-      await BlockStates.getAll(keys.values());
+      const loaded = await BlockStates.getAll(keys.values());
+      const states = new Map([...keys.keys()].map((key, i4) => [key, loaded[i4]]));
       if (!useBatches) {
         for (const block of multiblock.blocks) await place(block);
         return;
       }
       if (!executor) {
         const groups2 = /* @__PURE__ */ new Map();
+        const distinct = /* @__PURE__ */ new Map();
         const position = new Vector3();
         for (const block of multiblock.blocks) {
+          if (this.sectionModels && !Chunk.isAir(block)) distinct.set(ChunkData.paletteKey(block), block);
           const [x4, y5, z4] = block.position;
           this.validatePosBounds(position.set(x4, y5, z4));
           const cx = Math.floor(x4 / 16), cy = Math.floor(y5 / 16), cz = Math.floor(z4 / 16);
@@ -104099,6 +104117,16 @@ gl_FragDepth=readDepth(vUv);
           if (!group) groups2.set(chunk, group = []);
           group.push({ index: (y5 - cy * 16) * 256 + (z4 - cz * 16) * 16 + x4 - cx * 16, block });
         }
+        if (this.sectionModels) {
+          for (const block of distinct.values()) {
+            const state = states.get(AssetKey.parse("blockstates", block.type).serialize());
+            if (!state) continue;
+            void (async () => {
+              if (state.key && BlockEntities.entry(await BlockEntities.getIndex(state.key.root), state.key.toNamespacedString())) return;
+              await this.sectionModels.preload(state, block.properties);
+            })().catch(() => void 0);
+          }
+        }
         await this.placeChunkGroups(groups2, changes);
         return;
       }
@@ -104179,7 +104207,7 @@ gl_FragDepth=readDepth(vUv);
       } finally {
         try {
           const failures = await this.refreshBiomes(true);
-          if (failures.size) log21.warn("Failed to refresh biome colors", failures.values().next().value);
+          if (failures.size) log22.warn("Failed to refresh biome colors", failures.values().next().value);
         } catch (error2) {
           if (!failed) {
             failed = true;
@@ -104285,7 +104313,7 @@ gl_FragDepth=readDepth(vUv);
         if (deferCulling) await this.updateCulling([...changes.values()], true);
         else {
           const failures = await this.refreshBiomes();
-          if (failures.size) log21.warn("Failed to refresh biome colors", failures.values().next().value);
+          if (failures.size) log22.warn("Failed to refresh biome colors", failures.values().next().value);
           await this.updateCulling([...changes.values()]);
         }
       }
@@ -104324,7 +104352,7 @@ gl_FragDepth=readDepth(vUv);
         }
       } finally {
         const failures = await this.refreshBiomes(true);
-        if (failures.size) log21.warn("Failed to refresh biome colors", failures.values().next().value);
+        if (failures.size) log22.warn("Failed to refresh biome colors", failures.values().next().value);
         await this.updateCulling([]);
       }
     }
@@ -104881,6 +104909,8 @@ gl_FragDepth=readDepth(vUv);
   init_buffer2();
   init_process2();
   init_Env();
+  init_log();
+  var log23 = logger("SectionWorker");
   var _SectionWorker = class _SectionWorker {
     constructor(worker) {
       this.worker = worker;
@@ -104894,8 +104924,12 @@ gl_FragDepth=readDepth(vUv);
         if (reply.type === "pages") pending.resolve(reply.pages);
         else pending.reject(new Error(reply.message));
       });
-      worker.addEventListener("error", (event) => this.fail(event.message || "Section worker failed"));
-      worker.addEventListener("messageerror", () => this.fail("Section worker message could not be deserialized"));
+      const fallBack = (message) => {
+        log23.warn(`${message}, so sections build on the main thread`);
+        this.fail(message);
+      };
+      worker.addEventListener("error", (event) => fallBack(event.message || "Section worker failed"));
+      worker.addEventListener("messageerror", () => fallBack("Section worker message could not be deserialized"));
     }
     /** The shared worker, or undefined when the environment has none or a previous worker failed. */
     static shared() {
@@ -105440,8 +105474,10 @@ gl_FragDepth=readDepth(vUv);
         if (rejected?.status === "rejected") throw rejected.reason;
       }
       const positions = [];
-      let failed = false, failure;
-      for (const { index, key, block } of placements) {
+      const jobs = /* @__PURE__ */ new Map();
+      let failureOrder = Infinity, failure;
+      for (const [order, { index, key, block }] of placements.entries()) {
+        jobs.delete(index);
         this.hiddenBlocks.delete(index);
         this.data.assign(index, this.data.intern(block), block?.nbt);
         const readBlock = this.data.snapshot(index);
@@ -105457,7 +105493,6 @@ gl_FragDepth=readDepth(vUv);
           this.z * 16 + Math.floor(index / 16) % 16
         );
         positions.push(worldPos);
-        let object4;
         try {
           if (!readBlock) continue;
           const resolved = resolutions.get(key);
@@ -105479,7 +105514,7 @@ gl_FragDepth=readDepth(vUv);
             this.sectionBlocks.set(index, templates.map((template) => ({ index, template, cullMask: 0, biomeTint: context?.tint })));
             this.meshDirty = true;
           } else {
-            object4 = await this.scene.addBlock(blockState3, {
+            jobs.set(index, { order, readBlock, blockState: blockState3, position: MineRenderWorld.worldToScenePosition(worldPos), options: {
               mergeMeshes: true,
               instanceMeshes: true,
               maxInstanceCount: 2e3,
@@ -105487,13 +105522,12 @@ gl_FragDepth=readDepth(vUv);
               variantPosition,
               biome: context?.biome,
               biomePosition: this.biomePosition(index, blockState3, stored)
-            });
-            object4.setPosition(MineRenderWorld.worldToScenePosition(worldPos));
+            } });
+            continue;
           }
           this.renderedBlocks.set(index, { get block() {
             return readBlock();
-          }, object: object4 });
-          if (object4) this.objectBlocks.add(index);
+          }, object: void 0 });
         } catch (error2) {
           if (preserveDataOnFailure && readBlock) {
             this.renderedBlocks.set(index, { get block() {
@@ -105501,12 +105535,35 @@ gl_FragDepth=readDepth(vUv);
             }, object: void 0 });
           } else this.data.assign(index, 0);
           this.fluidCells[index] = 0;
-          object4?.removeFromScene();
-          if (!failed) failure = error2;
-          failed = true;
+          if (order < failureOrder) {
+            failureOrder = order;
+            failure = error2;
+          }
         }
       }
-      if (failed) throw failure;
+      const pending = [...jobs];
+      const objects = await Promise.allSettled(pending.map(([, job]) => this.createBlockObject(job.blockState, job.position, job.options)));
+      for (const [i4, [index, { order, readBlock }]] of pending.entries()) {
+        const result = objects[i4];
+        if (result.status === "fulfilled") {
+          this.renderedBlocks.set(index, { get block() {
+            return readBlock();
+          }, object: result.value });
+          this.objectBlocks.add(index);
+        } else {
+          if (preserveDataOnFailure) {
+            this.renderedBlocks.set(index, { get block() {
+              return readBlock();
+            }, object: void 0 });
+          } else this.data.assign(index, 0);
+          this.fluidCells[index] = 0;
+          if (order < failureOrder) {
+            failureOrder = order;
+            failure = result.reason;
+          }
+        }
+      }
+      if (failureOrder < Infinity) throw failure;
       return positions;
     }
     /** Replaces every cell from parsed section data. The caller refreshes neighbor culling. */
@@ -105577,37 +105634,42 @@ gl_FragDepth=readDepth(vUv);
           failed = true;
         }
       }
-      for (const { index, blockState: blockState3, biome } of perBlocks) {
-        let object4;
-        try {
-          object4 = await this.scene.addBlock(blockState3, {
-            mergeMeshes: true,
-            instanceMeshes: true,
-            maxInstanceCount: 2e3,
-            initialState: this.data.stateAt(this.data.idAt(index)).properties,
-            variantPosition: this.positionAt(index),
-            biome,
-            biomePosition: this.biomePosition(index, blockState3, this.data.stateAt(this.data.idAt(index)))
-          });
-          object4.setPosition(new Vector3(
-            this.x * 256 + index % 16 * 16,
-            this.y * 256 + Math.floor(index / 256) * 16,
-            this.z * 256 + Math.floor(index / 16) % 16 * 16
-          ));
-          this.renderedBlocks.get(index).object = object4;
+      const objects = await Promise.allSettled(perBlocks.map(({ index, blockState: blockState3, biome }) => this.createBlockObject(blockState3, new Vector3(
+        this.x * 256 + index % 16 * 16,
+        this.y * 256 + Math.floor(index / 256) * 16,
+        this.z * 256 + Math.floor(index / 16) % 16 * 16
+      ), {
+        mergeMeshes: true,
+        instanceMeshes: true,
+        maxInstanceCount: 2e3,
+        initialState: this.data.stateAt(this.data.idAt(index)).properties,
+        variantPosition: this.positionAt(index),
+        biome,
+        biomePosition: this.biomePosition(index, blockState3, this.data.stateAt(this.data.idAt(index)))
+      })));
+      for (const [i4, { index }] of perBlocks.entries()) {
+        const result = objects[i4];
+        if (result.status === "fulfilled") {
+          this.renderedBlocks.get(index).object = result.value;
           this.objectBlocks.add(index);
-        } catch (error2) {
+        } else {
           this.data.assign(index, 0);
           this.fluidCells[index] = 0;
           this.renderedBlocks.delete(index);
           this.objectBlocks.delete(index);
-          object4?.removeFromScene();
-          if (!failed) failure = error2;
+          if (!failed) failure = result.reason;
           failed = true;
         }
       }
       if (failed) throw failure;
     }
+    createBlockObject(blockState3, position, options) {
+      return this.scene.addSceneObject(blockState3, () => {
+        const object4 = new BlockObject(blockState3, options);
+        object4.position.copy(position);
+        return object4;
+      }, options);
+    }
     positionAt(index) {
       return [this.x * 16 + index % 16, this.y * 16 + Math.floor(index / 256), this.z * 16 + Math.floor(index / 16) % 16];
     }