minerender 2.1.0-alpha.136 → 2.1.0-alpha.138

package/dist/node/index.mjs

@@ -431,12 +431,80 @@ var init_CanvasCompat = __esm({
 });
 
 // src/util/log.ts
+function readSwitch() {
+  switchRead = true;
+  let value;
+  if (typeof runtime.process?.versions?.node === "string") {
+    value = runtime.process.env?.MINERENDER_LOG;
+  } else {
+    try {
+      value = runtime.localStorage?.getItem("minerender:log");
+    } catch {
+    }
+  }
+  if (value) {
+    for (const entry of value.split(",")) {
+      const separator = entry.indexOf("=");
+      const name = separator < 0 ? void 0 : entry.slice(0, separator).trim();
+      const setting = (separator < 0 ? entry : entry.slice(separator + 1)).trim();
+      if (!Object.prototype.hasOwnProperty.call(levels, setting) || name === "") continue;
+      if (name === void 0) {
+        switchThreshold = setting;
+      } else {
+        switchNamespaces ??= /* @__PURE__ */ new Map();
+        switchNamespaces.set(name, setting);
+      }
+    }
+  }
+}
+function logger(namespace) {
+  const write = (level, args) => {
+    if (!switchRead) readSwitch();
+    if (levels[level] < levels[switchNamespaces?.get(namespace) ?? switchThreshold ?? namespaces?.get(namespace) ?? threshold]) return;
+    if (logHandler) {
+      logHandler(level, namespace, args);
+      return;
+    }
+    if (tagStyle === void 0) {
+      tagStyle = typeof runtime.process?.versions?.node === "string" ? runtime.process.stdout?.isTTY === true ? "ansi" : "plain" : "browser";
+    }
+    if (tagStyle === "browser") {
+      console[level](`%cMineRender%c ${namespace}`, "background:#3c8527;color:#fff;border-radius:3px;padding:0 4px", "font-weight:bold", ...args);
+    } else {
+      const color2 = colors[level];
+      const tag = `[minerender:${namespace}]`;
+      console[level](tagStyle === "ansi" ? `\x1B[${color2}m${tag}\x1B[0m` : tag, ...args);
+    }
+  };
+  return {
+    debug: (...args) => write("debug", args),
+    info: (...args) => write("info", args),
+    warn: (...args) => write("warn", args),
+    error: (...args) => write("error", args)
+  };
+}
 function prefix(prefix2) {
   return `${FgGreen}MR${BgBlack}${prefix2 ?? ""}${Reset}`;
 }
-var Reset, FgGreen, BgBlack;
+var runtime, levels, colors, threshold, namespaces, logHandler, tagStyle, switchRead, switchThreshold, switchNamespaces, Logging, Reset, FgGreen, BgBlack;
 var init_log = __esm({
   "src/util/log.ts"() {
+    runtime = globalThis;
+    levels = { debug: 0, info: 1, warn: 2, error: 3, silent: 4 };
+    colors = { debug: 90, info: 36, warn: 33, error: 31 };
+    threshold = "warn";
+    switchRead = false;
+    Logging = class {
+      /** Updates the given settings and keeps the others. */
+      static configure(options) {
+        if (options.level !== void 0) threshold = options.level;
+        if (options.namespaces !== void 0) namespaces = new Map(Object.entries(options.namespaces));
+      }
+      /** Sends messages to `handler` instead of the console. Call without an argument to restore console output. */
+      static setHandler(handler) {
+        logHandler = handler;
+      }
+    };
     Reset = "\x1B[0m";
     FgGreen = "\x1B[32m";
     BgBlack = "\x1B[40m";
@@ -497,11 +565,11 @@ async function abortable(promise, signal) {
     signal.removeEventListener("abort", abort);
   }
 }
-var p, RequestError, RequestQueue, Requests;
+var log, RequestError, RequestQueue, Requests;
 var init_Requests = __esm({
   "src/request/Requests.ts"() {
     init_log();
-    p = prefix("Requests");
+    log = logger("Requests");
     RequestError = class extends Error {
       constructor(message, response, cause) {
         super(message);
@@ -528,7 +596,7 @@ var init_Requests = __esm({
             try {
               return await abortable(this.queue.add(request), signal);
             } catch (error) {
-              console.debug(p, "Request failed", error);
+              log.debug("Request failed", error);
               const delay = this.retryDelay(error, request, retries);
               if (delay === void 0) {
                 throw error;
@@ -714,7 +782,7 @@ var init_base64 = __esm({
 });
 
 // src/image/ImageLoader.ts
-var p2, ImageLoader;
+var log2, ImageLoader;
 var init_ImageLoader = __esm({
   "src/image/ImageLoader.ts"() {
     init_CanvasCompat();
@@ -725,7 +793,7 @@ var init_ImageLoader = __esm({
     init_WrappedImage();
     init_base64();
     init_log();
-    p2 = prefix("ImageLoader");
+    log2 = logger("ImageLoader");
     ImageLoader = class _ImageLoader {
       static _createImage() {
         return createImage();
@@ -750,7 +818,7 @@ var init_ImageLoader = __esm({
         return image;
       }
       static async loadData(src) {
-        console.debug(p2, "loadData", src);
+        log2.debug("loadData", src);
         const image = await this.loadCanvasData(src);
         return image.data.getImageData(0, 0, image.width, image.height);
       }
@@ -859,11 +927,13 @@ var init_ImageLoader = __esm({
 // src/texture/TextureLoader.ts
 import { RGBAFormat, Texture } from "three";
 import * as THREE from "three";
-var TextureLoader;
+var log3, TextureLoader;
 var init_TextureLoader = __esm({
   "src/texture/TextureLoader.ts"() {
     init_ImageLoader();
     init_Textures();
+    init_log();
+    log3 = logger("TextureLoader");
     TextureLoader = class {
       static {
         this.failedTextures = /* @__PURE__ */ new WeakSet();
@@ -882,7 +952,7 @@ var init_TextureLoader = __esm({
           texture.needsUpdate = true;
         }, (error) => {
           this.failedTextures.add(texture);
-          console.warn("Failed to load texture", src, error);
+          log3.warn("Failed to load texture", src, error);
         });
         texture.image = image;
         texture.format = format2;
@@ -898,7 +968,7 @@ var init_TextureLoader = __esm({
           texture.needsUpdate = true;
         }).catch((error) => {
           this.failedTextures.add(texture);
-          console.warn("Failed to load texture", src, error);
+          log3.warn("Failed to load texture", src, error);
         });
         texture.format = format2;
         texture.rotation = rotation;
@@ -974,13 +1044,15 @@ var init_Textures = __esm({
 
 // src/Materials.ts
 import { Color, CustomBlending, DoubleSide, OneFactor, OneMinusSrcAlphaFactor, RepeatWrapping, FrontSide, MeshBasicMaterial, MeshStandardMaterial, ShaderChunk, ShaderMaterial } from "three";
-var Materials;
+var log4, Materials;
 var init_Materials = __esm({
   "src/Materials.ts"() {
     init_CacheKey();
     init_Textures();
     init_TextureLoader();
     init_Caching();
+    init_log();
+    log4 = logger("Materials");
     Materials = class _Materials {
       /** Shared checkerboard material, created on first access. */
       static get MISSING_TEXTURE() {
@@ -1251,7 +1323,7 @@ var init_Materials = __esm({
           Object.assign(material.defaultAttributeValues, { shade: [1], uvBounds: [0, 0, 1, 1] });
           return material;
         } catch (e) {
-          console.warn(e);
+          log4.warn(e);
         }
         return this.createBasicCanvasMaterial(canvas, transparent, shade);
       }
@@ -1392,12 +1464,12 @@ var init_AssetKey = __esm({
       }
       /** Joins the type subdirectory and path without adding a namespace or file extension. */
       getFullPath() {
-        let p10 = [];
+        let p = [];
         if (this.type) {
-          p10.push(this.type);
+          p.push(this.type);
         }
-        p10.push(this.path);
-        return p10.join("/");
+        p.push(this.path);
+        return p.join("/");
       }
       toNamespacedString() {
         return this.namespace + ":" + this.getFullPath();
@@ -1443,182 +1515,6 @@ var init_AssetSource = __esm({
   }
 });
 
-// src/util/BatchedExecutor.ts
-import { JobQueue as JobQueue2 } from "jobqu";
-var BatchedExecutor;
-var init_BatchedExecutor = __esm({
-  "src/util/BatchedExecutor.ts"() {
-    BatchedExecutor = class {
-      /**
-       * @param interval - Delay between queue runs, in milliseconds.
-       * @param batch - Maximum tasks started per run and maximum tasks active at once.
-       */
-      constructor(interval = 1, batch = 30) {
-        if (!Number.isFinite(interval) || interval < 0) throw new RangeError("Batch interval must be finite and nonnegative");
-        if (!Number.isInteger(batch) || batch < 1) throw new RangeError("Batch size must be a positive integer");
-        this.interval = interval;
-        this.batch = batch;
-        this.queue = new JobQueue2(async (task) => task(), { interval, maxPerRun: batch, maxActive: batch });
-      }
-      /** Queues a task and resolves with its result, or rejects with its error. */
-      submit(task) {
-        return this.queue.add(() => task());
-      }
-      /** Rejects queued and future tasks. Tasks already running are allowed to finish. */
-      stop() {
-        this.queue.end();
-      }
-    };
-  }
-});
-
-// src/util/model.ts
-import { AxesHelper, BoxGeometry as BoxGeometry2, EdgesGeometry, LineBasicMaterial, LineSegments, Vector3 as Vector32 } from "three";
-function applyElementRotation(rotation, geometry) {
-  const origin = new Vector32(rotation.origin[0], rotation.origin[1], rotation.origin[2]);
-  geometry.translate(-origin.x, -origin.y, -origin.z);
-  switch (rotation.axis) {
-    case "x" /* X */:
-      geometry.rotateX(toRadians(rotation.angle));
-      break;
-    case "y" /* Y */:
-      geometry.rotateY(toRadians(rotation.angle));
-      break;
-    case "z" /* Z */:
-      geometry.rotateZ(toRadians(rotation.angle));
-      break;
-  }
-  if (rotation.rescale) {
-    const angle = toRadians(rotation.angle);
-    const s = 1 / Math.max(Math.abs(Math.cos(angle)), Math.abs(Math.sin(angle)));
-    geometry.scale(
-      rotation.axis === "x" /* X */ ? 1 : s,
-      rotation.axis === "y" /* Y */ ? 1 : s,
-      rotation.axis === "z" /* Z */ ? 1 : s
-    );
-  }
-  geometry.translate(origin.x, origin.y, origin.z);
-}
-function applyGenericRotation(axis, rotation, obj) {
-  switch (axis) {
-    case "x" /* X */:
-      obj.rotateOnAxis(new Vector32(1, 0, 0), toRadians(rotation));
-      break;
-    case "y" /* Y */:
-      obj.rotateOnAxis(new Vector32(0, 1, 0), toRadians(rotation));
-      break;
-    case "z" /* Z */:
-      obj.rotateOnAxis(new Vector32(0, 0, 1), toRadians(rotation));
-      break;
-  }
-}
-function addBox3WireframeToObject(box, obj, color2 = 16777215, w = 2) {
-  let size = new Vector32();
-  box.getSize(size);
-  let boxGeo = new BoxGeometry2(size.x, size.y, size.z, 1, 1, 1);
-  let wireGeo = new EdgesGeometry(boxGeo);
-  let wireMat = new LineBasicMaterial({ color: color2, linewidth: w });
-  let wireframe = new LineSegments(wireGeo, wireMat);
-  obj.add(wireframe);
-  let axes = new AxesHelper(1);
-  obj.add(axes);
-}
-function addWireframeToObject(obj, color2 = 16777215, w = 2) {
-  let boxGeo = new BoxGeometry2(16, 16, 16, 1, 1, 1);
-  let wireGeo = new EdgesGeometry(boxGeo);
-  let wireMat = new LineBasicMaterial({ color: color2, linewidth: w });
-  let wireframe = new LineSegments(wireGeo, wireMat);
-  obj.add(wireframe);
-  let axes = new AxesHelper(1);
-  obj.add(axes);
-}
-function addWireframeToMesh(geo, mesh, color2 = 16777215, w = 2) {
-  let wireGeo = new EdgesGeometry(geo);
-  let wireMat = new LineBasicMaterial({ color: color2, linewidth: w });
-  let wireframe = new LineSegments(wireGeo, wireMat);
-  mesh.add(wireframe);
-  let axes = new AxesHelper(1);
-  mesh.add(axes);
-  return () => {
-    wireGeo.dispose();
-    wireMat.dispose();
-    axes.dispose();
-  };
-}
-var init_model = __esm({
-  "src/util/model.ts"() {
-    init_Axis();
-    init_util();
-  }
-});
-
-// src/util/performance.ts
-function captureException(e, ...extra) {
-  console.error(e, extra);
-}
-function timingStart(marker) {
-  console.time(marker);
-}
-function timingEnd(marker) {
-  console.timeEnd(marker);
-}
-var init_performance = __esm({
-  "src/util/performance.ts"() {
-  }
-});
-
-// src/util/sha.ts
-import SHA1 from "crypto-js/sha1.js";
-import SHA256 from "crypto-js/sha256.js";
-import SHA512 from "crypto-js/sha512.js";
-function sha1(str) {
-  return SHA1(str).toString();
-}
-function sha256(str) {
-  return SHA256(str).toString();
-}
-function sha512(str) {
-  return SHA512(str).toString();
-}
-var init_sha = __esm({
-  "src/util/sha.ts"() {
-  }
-});
-
-// src/util/three.ts
-function isObject3D(obj) {
-  return obj.isObject3D;
-}
-function isMesh(obj) {
-  return obj.isMesh;
-}
-function isInstancedMesh(obj) {
-  return obj.isInstancedMesh;
-}
-function isPerspectiveCamera(obj) {
-  return obj.isPerspectiveCamera;
-}
-function isOrthographicCamera(obj) {
-  return obj.isOrthographicCamera;
-}
-var init_three = __esm({
-  "src/util/three.ts"() {
-  }
-});
-
-// src/util/index.ts
-var init_util2 = __esm({
-  "src/util/index.ts"() {
-    init_BatchedExecutor();
-    init_log();
-    init_model();
-    init_performance();
-    init_sha();
-    init_three();
-    init_util();
-  }
-});
-
 // src/nbt/NBTHelper.ts
 function commonJsExports(module) {
   return module.default ?? module;
@@ -1704,8 +1600,8 @@ var require_dist = __commonJS({
       __assign = Object.assign || function(t) {
         for (var s, i = 1, n = arguments.length; i < n; i++) {
           s = arguments[i];
-          for (var p10 in s) if (Object.prototype.hasOwnProperty.call(s, p10))
-            t[p10] = s[p10];
+          for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+            t[p] = s[p];
         }
         return t;
       };
@@ -1797,11 +1693,11 @@ var init_merge = __esm({
 });
 
 // src/assets/source/HostedAssetSource.ts
-var BINARY_TIMEOUT, p3, DEFAULT_OPTIONS, HostedAssetSource;
+var BINARY_TIMEOUT, log5, DEFAULT_OPTIONS, HostedAssetSource;
 var init_HostedAssetSource = __esm({
   "src/assets/source/HostedAssetSource.ts"() {
     init_AssetSource();
-    init_util2();
+    init_log();
     init_nbt();
     init_image();
     init_AssetKey();
@@ -1811,7 +1707,7 @@ var init_HostedAssetSource = __esm({
     init_parser();
     init_merge();
     BINARY_TIMEOUT = 6e4;
-    p3 = prefix("HostedAssetSource");
+    log5 = logger("HostedAssetSource");
     DEFAULT_OPTIONS = {
       retryDefaults: true
     };
@@ -1911,14 +1807,14 @@ var init_HostedAssetSource = __esm({
           return direct;
         }
         if (key.namespace !== DEFAULT_NAMESPACE) {
-          console.info(p3, "Retrying", key, "with default namespace");
+          log5.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) {
-            console.info(p3, "Retrying", key, "with default root+namespace");
+            log5.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") {
@@ -1926,7 +1822,7 @@ var init_HostedAssetSource = __esm({
             }
           }
         } else if (typeof key.root !== "undefined" && key.root !== AssetLoader.ROOT || typeof this.root !== "undefined" && this.root !== AssetLoader.ROOT) {
-          console.info(p3, "Retrying", key, "with default root");
+          log5.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") {
@@ -1936,9 +1832,8 @@ var init_HostedAssetSource = __esm({
         return void 0;
       }
       async load(key, parser) {
-        console.info(p3, "Loading", key);
         const url = `${this.assetBasePath(key)}${key.type !== void 0 ? key.type + "/" : ""}${key.path}${key.extension}`;
-        console.debug(p3, url);
+        log5.debug("Loading", url);
         const request = { url };
         try {
           parser.config(request);
@@ -2322,7 +2217,7 @@ var init_source = __esm({
 });
 
 // src/assets/AssetLoader.ts
-var p4, AssetLoader;
+var log6, AssetLoader;
 var init_AssetLoader = __esm({
   "src/assets/AssetLoader.ts"() {
     init_AssetDefaults();
@@ -2330,7 +2225,7 @@ var init_AssetLoader = __esm({
     init_log();
     init_source();
     init_Caching();
-    p4 = prefix("AssetLoader");
+    log6 = logger("AssetLoader");
     AssetLoader = class {
       static {
         /** Default asset base URL. Use {@link setVersion} to select a Minecraft version. */
@@ -2393,11 +2288,11 @@ ${key}` : key;
         if (override) {
           const existing = this.removeSource(key);
           if (existing) {
-            console.log(p4, "Removed existing AssetSource", key);
+            log6.info("Removed existing AssetSource", key);
           }
         }
         this._SOURCES.unshift({ key, source });
-        console.log(p4, "Added AssetSource", key);
+        log6.info("Added AssetSource", key);
       }
       /** Removes and returns the first source with this name. Call {@link Caching.clear} to reload assets. */
       static removeSource(key) {
@@ -2573,9 +2468,11 @@ var init_CanvasImage = __esm({
 });
 
 // src/Ticker.ts
-var Ticker;
+var log7, Ticker;
 var init_Ticker = __esm({
   "src/Ticker.ts"() {
+    init_log();
+    log7 = logger("Ticker");
     Ticker = class _Ticker {
       static {
         this.TPS = 20;
@@ -2614,7 +2511,7 @@ var init_Ticker = __esm({
             try {
               t();
             } catch (e) {
-              console.warn(e);
+              log7.warn(e);
             }
           });
           _Ticker.oneSecondTicks++;
@@ -2853,8 +2750,8 @@ var init_cubeUv = __esm({
 });
 
 // src/UVMapper.ts
-import { Float32BufferAttribute as Float32BufferAttribute2, Vector2, Vector3 as Vector33 } from "three";
-var p5, X, Y, Z, FACE_UV_AXES, UVMapper, MinecraftFaceUV;
+import { Float32BufferAttribute as Float32BufferAttribute2, Vector2, Vector3 as Vector32 } from "three";
+var log8, X, Y, Z, FACE_UV_AXES, UVMapper, MinecraftFaceUV;
 var init_UVMapper = __esm({
   "src/UVMapper.ts"() {
     init_CubeFace();
@@ -2868,17 +2765,17 @@ var init_UVMapper = __esm({
     init_ModelGenerator();
     init_log();
     init_cubeUv();
-    p5 = prefix("UVMapper");
+    log8 = logger("UVMapper");
     X = 0;
     Y = 1;
     Z = 2;
     FACE_UV_AXES = {
-      east: [new Vector33(0, 0, -1), new Vector33(0, -1, 0)],
-      west: [new Vector33(0, 0, 1), new Vector33(0, -1, 0)],
-      up: [new Vector33(1, 0, 0), new Vector33(0, 0, 1)],
-      down: [new Vector33(1, 0, 0), new Vector33(0, 0, -1)],
-      south: [new Vector33(1, 0, 0), new Vector33(0, -1, 0)],
-      north: [new Vector33(-1, 0, 0), new Vector33(0, -1, 0)]
+      east: [new Vector32(0, 0, -1), new Vector32(0, -1, 0)],
+      west: [new Vector32(0, 0, 1), new Vector32(0, -1, 0)],
+      up: [new Vector32(1, 0, 0), new Vector32(0, 0, 1)],
+      down: [new Vector32(1, 0, 0), new Vector32(0, 0, -1)],
+      south: [new Vector32(1, 0, 0), new Vector32(0, -1, 0)],
+      north: [new Vector32(-1, 0, 0), new Vector32(0, -1, 0)]
     };
     UVMapper = class {
       static makeUv(uvCoord, originalTextureSize, actualTextureSize) {
@@ -3101,7 +2998,7 @@ var init_UVMapper = __esm({
           model.elements = originalModel.elements.map((element) => ({ ...element }));
         }
         const isItemModel = !("elements" in model);
-        console.debug(p5, "Creating Atlas for", model.key);
+        log8.debug("Creating Atlas for", model.key);
         if (model.textures) {
           const promises = [];
           const uniqueTextureNames = [];
@@ -3115,7 +3012,7 @@ var init_UVMapper = __esm({
               const assetKey = AssetKey.parse("textures", textureValue, model.key);
               promises.push(ModelTextures.get(assetKey).then((asset2) => {
                 if (!asset2) {
-                  console.warn(p5, "Missing texture", assetKey);
+                  log8.warn("Missing texture", assetKey);
                   return;
                 }
                 textureMap[textureKey] = new WrappedImage(asset2);
@@ -3127,7 +3024,7 @@ var init_UVMapper = __esm({
           }
           await Promise.all(promises);
           const textureCount = uniqueTextureNames.length;
-          console.debug(p5, "Creating Atlas for", textureCount, "textures");
+          log8.debug("Creating Atlas for", textureCount, "textures");
           this.fillMissingTextureKeys(model.textures, textureMap);
           this.fillMissingTextureKeys(model.textures, metaMap);
           const sizes = {};
@@ -3158,7 +3055,7 @@ var init_UVMapper = __esm({
           this.fillMissingTextureKeys(model.textures, sizes);
           const s = Math.ceil(Math.sqrt(textureCount + 1));
           const size = Math.ceil(s * maxWidth);
-          console.debug(p5, "Atlas size:", size);
+          log8.debug("Atlas size:", size);
           const squaredSize = size * size;
           const image = new CanvasImage(size, size);
           const missing = Textures.getMissing().image;
@@ -3237,7 +3134,7 @@ var init_UVMapper = __esm({
           }
           this.fillMissingTextureKeys(model.textures, positions);
           if (isItemModel) {
-            console.debug(p5, "Generating item model for", model);
+            log8.debug("Generating item model for", model);
             model.elements = [];
             for (let layerName of ModelGenerator.ITEM_LAYERS) {
               const textureImage = textureMap[layerName];
@@ -3253,7 +3150,7 @@ var init_UVMapper = __esm({
                 ), layerName));
               }
             }
-            console.debug(p5, "Item model elements", model.elements);
+            log8.debug("Item model elements", model.elements);
           }
           if (!model.elements) {
           }
@@ -3310,7 +3207,7 @@ var init_UVMapper = __esm({
             hasTranslucency
           );
         } else {
-          console.warn(p5, "Model does not have any textures", model);
+          log8.warn("Model does not have any textures", model);
         }
         return void 0;
       }
@@ -3635,7 +3532,7 @@ var init_DisplayPosition = __esm({
 });
 
 // src/model/DisplayTransforms.ts
-import { Euler as Euler2, Matrix4 as Matrix42, Quaternion as Quaternion2, Vector3 as Vector34 } from "three";
+import { Euler as Euler2, Matrix4, Quaternion, Vector3 as Vector33 } from "three";
 var DisplayTransforms;
 var init_DisplayTransforms = __esm({
   "src/model/DisplayTransforms.ts"() {
@@ -3657,7 +3554,7 @@ var init_DisplayTransforms = __esm({
       /** Build a display pose for geometry already centered at the model's [8, 8, 8] pivot. */
       static getMatrix(display, position) {
         const transform = this.getTransform(display, position);
-        return new Matrix42().compose(transform.position, transform.quaternion, transform.scale);
+        return new Matrix4().compose(transform.position, transform.quaternion, transform.scale);
       }
       /** Position, rotation, and scale of a display pose for geometry already centered at the model's [8, 8, 8] pivot. */
       static getTransform(display, position) {
@@ -3665,10 +3562,10 @@ var init_DisplayTransforms = __esm({
         const left = position === "firstperson_lefthand" /* FIRSTPERSON_LEFTHAND */ || position === "thirdperson_lefthand" /* THIRDPERSON_LEFTHAND */;
         const sign = left ? -1 : 1;
         const [x, y, z] = transform.rotation ?? [0, 0, 0];
-        const rotation = new Quaternion2().setFromEuler(new Euler2(toRadians(x), sign * toRadians(y), sign * toRadians(z), "XYZ"));
-        const translation = new Vector34(...transform.translation ?? [0, 0, 0]).clampScalar(-80, 80);
+        const rotation = new Quaternion().setFromEuler(new Euler2(toRadians(x), sign * toRadians(y), sign * toRadians(z), "XYZ"));
+        const translation = new Vector33(...transform.translation ?? [0, 0, 0]).clampScalar(-80, 80);
         translation.x *= sign;
-        const scale = new Vector34(...transform.scale ?? [1, 1, 1]).clampScalar(-4, 4);
+        const scale = new Vector33(...transform.scale ?? [1, 1, 1]).clampScalar(-4, 4);
         return { position: translation, quaternion: rotation, scale };
       }
       /** Transforms geometry in place and reverses triangle winding when the matrix reflects it. */
@@ -3712,7 +3609,7 @@ var init_ModelMerger = __esm({
             merged.display = { ...inheritedDisplay, ...DisplayTransforms.withHandFallbacks(source.display) };
           }
         }
-        merged.hierarchy = models.map((m) => m.parent).filter((p10) => `${p10}`);
+        merged.hierarchy = models.map((m) => m.parent).filter((p) => `${p}`);
         merged.hierarchy.push(`${merged.parent}`);
         if (model.components) merged.components = model.components;
         return merged;
@@ -3791,11 +3688,11 @@ var init_BannerPatterns = __esm({
       static async getLayers(value, target, root) {
         if (value === void 0) return [];
         if (!Array.isArray(value)) throw new Error("banner_patterns must be an array");
-        const colors = value.length ? await this.getColors(root) : void 0;
+        const colors2 = value.length ? await this.getColors(root) : void 0;
         return Promise.all(value.slice(0, 16).map(async (layer) => {
           if (!layer || typeof layer !== "object" || Array.isArray(layer)) throw new Error("Each banner pattern requires a pattern and dye color");
-          if (typeof layer.color !== "string" || !Object.prototype.hasOwnProperty.call(colors, layer.color)) throw new Error(`Unsupported dye color ${layer.color}`);
-          const color2 = colors[layer.color];
+          if (typeof layer.color !== "string" || !Object.prototype.hasOwnProperty.call(colors2, layer.color)) throw new Error(`Unsupported dye color ${layer.color}`);
+          const color2 = colors2[layer.color];
           let pattern2 = layer.pattern;
           if (typeof pattern2 === "string") {
             const id = this.identifier(pattern2);
@@ -3904,49 +3801,49 @@ var init_ItemTints = __esm({
         const sources = model.tints;
         if (!sources?.length) return tints;
         const components = model.components ?? {};
-        const colors = { ...tints };
+        const colors2 = { ...tints };
         await Promise.all(sources.map(async (source, index) => {
-          if (colors[index] !== void 0) return;
+          if (colors2[index] !== void 0) return;
           switch (source.type) {
             case "constant":
             case "minecraft:constant":
-              colors[index] = this.rgb(source.value);
+              colors2[index] = this.rgb(source.value);
               break;
             case "grass":
             case "minecraft:grass":
-              colors[index] = await Colormaps.grassColor(model.key, source.temperature, source.downfall);
+              colors2[index] = await Colormaps.grassColor(model.key, source.temperature, source.downfall);
               break;
             case "dye":
             case "minecraft:dye":
-              colors[index] = this.colorOrDefault(components["minecraft:dyed_color"], source.default, true);
+              colors2[index] = this.colorOrDefault(components["minecraft:dyed_color"], source.default, true);
               break;
             case "potion":
             case "minecraft:potion": {
-              colors[index] = await this.potionColor(components["minecraft:potion_contents"], source.default, model.key?.root);
+              colors2[index] = await this.potionColor(components["minecraft:potion_contents"], source.default, model.key?.root);
               break;
             }
             case "map_color":
             case "minecraft:map_color":
-              colors[index] = this.colorOrDefault(components["minecraft:map_color"], source.default);
+              colors2[index] = this.colorOrDefault(components["minecraft:map_color"], source.default);
               break;
             case "firework":
             case "minecraft:firework": {
               const values = this.componentField(components, "firework_explosion", "colors");
               if (values !== void 0 && !Array.isArray(values)) throw new MineRenderError("Item tint firework_explosion.colors must be an array");
               if (!values?.length) {
-                colors[index] = this.rgb(source.default);
+                colors2[index] = this.rgb(source.default);
                 break;
               }
               const rgb = values.map((value) => this.componentColor(value));
               const red = Math.floor(rgb.reduce((sum, color2) => sum + (color2 >> 16 & 255), 0) / rgb.length);
               const green = Math.floor(rgb.reduce((sum, color2) => sum + (color2 >> 8 & 255), 0) / rgb.length);
               const blue = Math.floor(rgb.reduce((sum, color2) => sum + (color2 & 255), 0) / rgb.length);
-              colors[index] = red << 16 | green << 8 | blue;
+              colors2[index] = red << 16 | green << 8 | blue;
               break;
             }
             case "team":
             case "minecraft:team":
-              colors[index] = this.rgb(source.default);
+              colors2[index] = this.rgb(source.default);
               break;
             case "custom_model_data":
             case "minecraft:custom_model_data": {
@@ -3954,14 +3851,14 @@ var init_ItemTints = __esm({
               if (!Number.isSafeInteger(colorIndex) || colorIndex < 0) throw new MineRenderError("Item tint custom_model_data index must be a nonnegative integer");
               const values = this.componentField(components, "custom_model_data", "colors");
               if (values !== void 0 && !Array.isArray(values)) throw new MineRenderError("Item tint custom_model_data.colors must be an array");
-              colors[index] = this.colorOrDefault(values?.[colorIndex], source.default, true);
+              colors2[index] = this.colorOrDefault(values?.[colorIndex], source.default, true);
               break;
             }
             default:
               throw new MineRenderError(`Unsupported item tint source ${source.type}`);
           }
         }));
-        return colors;
+        return colors2;
       }
       /** Whether a potion component contains a known effect, including effects with hidden particles. */
       static async hasPotionEffects(value, root) {
@@ -4535,7 +4432,7 @@ function createPermutation() {
   return values;
 }
 function swampGrassColor(x, z) {
-  const p10 = permutation ??= createPermutation();
+  const p = permutation ??= createPermutation();
   x *= 0.0225;
   z *= 0.0225;
   const s = (x + z) * skew;
@@ -4546,7 +4443,7 @@ function swampGrassColor(x, z) {
   const corner = (gx, gz, a, b) => {
     let falloff = 0.5 - a * a - b * b;
     if (falloff < 0) return 0;
-    const gradient = gradients[p10[gx + p10[gz & 255] & 255] % 12];
+    const gradient = gradients[p[gx + p[gz & 255] & 255] % 12];
     falloff *= falloff;
     return falloff * falloff * (gradient[0] * a + gradient[1] * b);
   };
@@ -4624,14 +4521,16 @@ var init_Biomes = __esm({
 });
 
 // src/assets/BlockEntities.ts
-import { Matrix4 as Matrix43 } from "three";
-var BlockEntities;
+import { Matrix4 as Matrix42 } from "three";
+var log9, BlockEntities;
 var init_BlockEntities = __esm({
   "src/assets/BlockEntities.ts"() {
     init_AssetKey();
     init_AssetLoader();
     init_source();
     init_Caching();
+    init_log();
+    log9 = logger("BlockEntities");
     BlockEntities = class {
       /**
        * Loads the block index of a version. Versions and sources without one yield an empty index, and so does
@@ -4645,7 +4544,7 @@ var init_BlockEntities = __esm({
           try {
             return await AssetLoader.get(key, "json" /* JSON */) ?? {};
           } catch (error) {
-            console.warn("Could not load the block entity index; block entities are drawn as plain block models", error);
+            log9.warn("Could not load the block entity index; block entities are drawn as plain block models", error);
             return {};
           }
         });
@@ -4672,8 +4571,8 @@ var init_BlockEntities = __esm({
         return { parts, rotation, translation: entry.translation ?? [0, 0, 0] };
       }
       /** Placement in block space (0..16 per axis), applied on top of the model's own transform. */
-      static matrix(resolved, matrix = new Matrix43()) {
-        return matrix.makeTranslation(8, 0, 8).multiply(new Matrix43().makeRotationY(resolved.rotation * Math.PI / 180)).multiply(new Matrix43().makeTranslation(resolved.translation[0] - 8, resolved.translation[1], resolved.translation[2] - 8));
+      static matrix(resolved, matrix = new Matrix42()) {
+        return matrix.makeTranslation(8, 0, 8).multiply(new Matrix42().makeRotationY(resolved.rotation * Math.PI / 180)).multiply(new Matrix42().makeTranslation(resolved.translation[0] - 8, resolved.translation[1], resolved.translation[2] - 8));
       }
     };
   }
@@ -4917,7 +4816,7 @@ async function parseUnihex(key) {
     }
     return { indices, rows, metrics };
   } catch (error) {
-    console.warn(`Could not load Unihex file ${key.toNamespacedString()}`, error);
+    log10.warn(`Could not load Unihex file ${key.toNamespacedString()}`, error);
     return void 0;
   }
 }
@@ -4936,7 +4835,7 @@ async function loadUnihex(provider, fontKey, characters) {
       return { ...override, from, to };
     });
   } catch (error) {
-    console.warn(`Could not load Unihex file ${key.toNamespacedString()}`, error);
+    log10.warn(`Could not load Unihex file ${key.toNamespacedString()}`, error);
     return glyphs;
   }
   const file = await Caching.unihexCache.get(key.serialize(), () => parseUnihex(key));
@@ -4984,7 +4883,7 @@ async function loadUnihex(provider, fontKey, characters) {
   }
   return glyphs;
 }
-var ATLAS_SIZE, GLYPH_HEIGHT, UnihexAtlas, atlases;
+var log10, ATLAS_SIZE, GLYPH_HEIGHT, UnihexAtlas, atlases;
 var init_Unihex = __esm({
   "src/assets/_fonts/Unihex.ts"() {
     init_AssetKey();
@@ -4993,6 +4892,8 @@ var init_Unihex = __esm({
     init_Caching();
     init_AssetParsers();
     init_CanvasCompat();
+    init_log();
+    log10 = logger("Unihex");
     ATLAS_SIZE = 512;
     GLYPH_HEIGHT = 16;
     UnihexAtlas = class {
@@ -5157,8 +5058,8 @@ var init_Fonts = __esm({
 });
 
 // src/entity/EntityAnimation.ts
-function catmullRom(delta, p0, p1, p22, p32) {
-  return 0.5 * (2 * p1 + (p22 - p0) * delta + (2 * p0 - 5 * p1 + 4 * p22 - p32) * delta * delta + (3 * p1 - p0 - 3 * p22 + p32) * delta * delta * delta);
+function catmullRom(delta, p0, p1, p2, p3) {
+  return 0.5 * (2 * p1 + (p2 - p0) * delta + (2 * p0 - 5 * p1 + 4 * p2 - p3) * delta * delta + (3 * p1 - p0 - 3 * p2 + p3) * delta * delta * delta);
 }
 function sampleEntityKeyframes(keyframes, time) {
   if (keyframes.length === 0) return [0, 0, 0];
@@ -5204,7 +5105,7 @@ var init_EntityAnimation = __esm({
 });
 
 // src/entity/scene/EntityAnimationPlayer.ts
-import { Euler as Euler3, Vector3 as Vector35 } from "three";
+import { Euler as Euler3, Vector3 as Vector34 } from "three";
 function validateAnimationWeights(weights, count) {
   const values = Array.from(weights);
   if (values.length !== count || values.some((weight) => !Number.isFinite(weight) || weight < 0)) {
@@ -5280,9 +5181,9 @@ var init_EntityAnimationPlayer = __esm({
               position: object4.position.clone(),
               rotation: object4.rotation.clone(),
               scale: object4.scale.clone(),
-              basePosition: pose ? new Vector35(...pose.offset) : object4.position.clone(),
+              basePosition: pose ? new Vector34(...pose.offset) : object4.position.clone(),
               baseRotation: pose ? new Euler3(...pose.rotation, "ZYX") : object4.rotation.clone(),
-              baseScale: pose ? new Vector35(...pose.scale ?? [1, 1, 1]) : object4.scale.clone()
+              baseScale: pose ? new Vector34(...pose.scale ?? [1, 1, 1]) : object4.scale.clone()
             });
           }
         }
@@ -5418,12 +5319,33 @@ var init_InstanceReference = __esm({
   }
 });
 
+// src/util/three.ts
+function isObject3D(obj) {
+  return obj.isObject3D;
+}
+function isMesh(obj) {
+  return obj.isMesh;
+}
+function isInstancedMesh(obj) {
+  return obj.isInstancedMesh;
+}
+function isPerspectiveCamera(obj) {
+  return obj.isPerspectiveCamera;
+}
+function isOrthographicCamera(obj) {
+  return obj.isOrthographicCamera;
+}
+var init_three = __esm({
+  "src/util/three.ts"() {
+  }
+});
+
 // src/renderer/SceneObject.ts
-import { Color as Color2, Euler as Euler4, InstancedBufferAttribute, InstancedMesh, Matrix4 as Matrix44, Mesh as Mesh3, Object3D as Object3D2, Quaternion as Quaternion3, Vector3 as Vector36 } from "three";
+import { Color as Color2, Euler as Euler4, InstancedBufferAttribute, InstancedMesh, Matrix4 as Matrix43, Mesh as Mesh2, Object3D, Quaternion as Quaternion2, Vector3 as Vector35 } from "three";
 function isSceneObject(obj) {
   return obj.isSceneObject;
 }
-var p6, SceneObject;
+var SceneObject;
 var init_SceneObject = __esm({
   "src/renderer/SceneObject.ts"() {
     init_Geometries();
@@ -5435,9 +5357,7 @@ var init_SceneObject = __esm({
     init_three();
     init_Disposable();
     init_merge();
-    init_log();
-    p6 = prefix("SceneObject");
-    SceneObject = class _SceneObject extends Object3D2 {
+    SceneObject = class _SceneObject extends Object3D {
       constructor(options) {
         super();
         this.isSceneObject = true;
@@ -5448,7 +5368,6 @@ var init_SceneObject = __esm({
         this.freeInstanceIndices = [];
         this.hiddenInstanceMatrices = /* @__PURE__ */ new Map();
         this.options = (0, import_ts_deepmerge.default)({}, _SceneObject.DEFAULT_OPTIONS, options ?? {});
-        console.log("SceneObject options", this.options);
       }
       static {
         this.DEFAULT_OPTIONS = (0, import_ts_deepmerge.default)({}, {
@@ -5485,13 +5404,12 @@ var init_SceneObject = __esm({
             this.remove(existing);
           }
         }
-        console.log("add", group, group.name);
         this.add(group);
         this.notifyDirty();
         return group;
       }
       createGroup(name, x = 0, y = 0, z = 0, offsetAxis, offset = 0) {
-        const obj = new Object3D2();
+        const obj = new Object3D();
         if (name) {
           obj.name = `group:${name}`;
         }
@@ -5525,11 +5443,9 @@ var init_SceneObject = __esm({
         if (name) {
           const existing = parent.getObjectByName(mesh.name);
           if (existing) {
-            console.log("remove", existing.name, existing);
             parent.remove(existing);
           }
         }
-        console.log("add", mesh, mesh.name);
         parent.add(mesh);
       }
       createAndAddMesh(name, group, geometry, material, offsetAxis, offset = 0) {
@@ -5543,7 +5459,7 @@ var init_SceneObject = __esm({
         return mesh;
       }
       createMesh(name, geometry, material, offsetAxis, offset = 0) {
-        const mesh = new Mesh3(geometry, material);
+        const mesh = new Mesh2(geometry, material);
         if (name) {
           mesh.name = `mesh:${name}`;
         }
@@ -5642,7 +5558,7 @@ var init_SceneObject = __esm({
           mesh.instanceColor.needsUpdate = true;
         }
         if (this._scene) this._scene.stats.instanceCount++;
-        this.setMatrixAt(index, new Matrix44());
+        this.setMatrixAt(index, new Matrix43());
         return reference;
       }
       /** Returns the live reference for a raycast hit on this object's instance mesh. */
@@ -5656,7 +5572,7 @@ var init_SceneObject = __esm({
         if (!this.instanceReferences.has(index)) return;
         const mesh = this.instanceMesh;
         this.hiddenInstanceMatrices.delete(index);
-        this.setMatrixAt(index, new Matrix44().makeScale(0, 0, 0));
+        this.setMatrixAt(index, new Matrix43().makeScale(0, 0, 0));
         this.instanceReferences.delete(index);
         this.freeInstanceIndices.push(index);
         this._instanceCounter = this.instanceReferences.size;
@@ -5686,7 +5602,7 @@ var init_SceneObject = __esm({
       }
       //</editor-fold>
       //<editor-fold desc="TRANSFORMATION">
-      getMatrixAt(index, matrix = new Matrix44()) {
+      getMatrixAt(index, matrix = new Matrix43()) {
         if (!this.instanceReferences.has(index)) throw new MineRenderError("Instance is not active");
         const hidden = this.hiddenInstanceMatrices.get(index);
         if (hidden) {
@@ -5702,7 +5618,7 @@ var init_SceneObject = __esm({
         if (hidden) {
           hidden.copy(matrix);
         }
-        mesh.setMatrixAt(index, hidden ? new Matrix44().makeScale(0, 0, 0) : matrix);
+        mesh.setMatrixAt(index, hidden ? new Matrix43().makeScale(0, 0, 0) : matrix);
         mesh.instanceMatrix.needsUpdate = true;
         mesh.boundingBox = null;
         mesh.boundingSphere = null;
@@ -5730,16 +5646,16 @@ var init_SceneObject = __esm({
       }
       setPositionRotationScaleAt(index, position, rotation, scale) {
         if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
-        const oldPosition = new Vector36();
-        const oldRotation = new Quaternion3();
-        const oldScale = new Vector36();
-        const matrix = new Matrix44();
+        const oldPosition = new Vector35();
+        const oldRotation = new Quaternion2();
+        const oldScale = new Vector35();
+        const matrix = new Matrix43();
         if (!scale || !rotation || !position) {
           this.getMatrixAt(index, matrix).decompose(oldPosition, oldRotation, oldScale);
         }
         matrix.compose(
           position ? position : oldPosition,
-          rotation ? new Quaternion3().setFromEuler(rotation) : oldRotation,
+          rotation ? new Quaternion2().setFromEuler(rotation) : oldRotation,
           scale ? scale : oldScale
         );
         this.setMatrixAt(index, matrix);
@@ -5748,7 +5664,7 @@ var init_SceneObject = __esm({
         if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
         this.setPositionRotationScaleAt(index, position);
       }
-      getPositionAt(index, vector = new Vector36()) {
+      getPositionAt(index, vector = new Vector35()) {
         if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
         const matrix = this.getMatrixAt(index);
         vector.setFromMatrixPosition(matrix);
@@ -5760,15 +5676,15 @@ var init_SceneObject = __esm({
       }
       getRotationAt(index, euler = new Euler4()) {
         if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
-        const rotation = new Quaternion3();
-        this.getMatrixAt(index).decompose(new Vector36(), rotation, new Vector36());
+        const rotation = new Quaternion2();
+        this.getMatrixAt(index).decompose(new Vector35(), rotation, new Vector35());
         return euler.setFromQuaternion(rotation);
       }
       setScaleAt(index, scale) {
         if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
         this.setPositionRotationScaleAt(index, void 0, void 0, scale);
       }
-      getScaleAt(index, vector = new Vector36()) {
+      getScaleAt(index, vector = new Vector35()) {
         if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
         const matrix = this.getMatrixAt(index);
         vector.setFromMatrixScale(matrix);
@@ -5900,6 +5816,86 @@ var init_SceneObject = __esm({
   }
 });
 
+// src/util/model.ts
+import { AxesHelper, BoxGeometry as BoxGeometry4, EdgesGeometry as EdgesGeometry2, LineBasicMaterial as LineBasicMaterial2, LineSegments as LineSegments2, Vector3 as Vector36 } from "three";
+function applyElementRotation(rotation, geometry) {
+  const origin = new Vector36(rotation.origin[0], rotation.origin[1], rotation.origin[2]);
+  geometry.translate(-origin.x, -origin.y, -origin.z);
+  switch (rotation.axis) {
+    case "x" /* X */:
+      geometry.rotateX(toRadians(rotation.angle));
+      break;
+    case "y" /* Y */:
+      geometry.rotateY(toRadians(rotation.angle));
+      break;
+    case "z" /* Z */:
+      geometry.rotateZ(toRadians(rotation.angle));
+      break;
+  }
+  if (rotation.rescale) {
+    const angle = toRadians(rotation.angle);
+    const s = 1 / Math.max(Math.abs(Math.cos(angle)), Math.abs(Math.sin(angle)));
+    geometry.scale(
+      rotation.axis === "x" /* X */ ? 1 : s,
+      rotation.axis === "y" /* Y */ ? 1 : s,
+      rotation.axis === "z" /* Z */ ? 1 : s
+    );
+  }
+  geometry.translate(origin.x, origin.y, origin.z);
+}
+function applyGenericRotation(axis, rotation, obj) {
+  switch (axis) {
+    case "x" /* X */:
+      obj.rotateOnAxis(new Vector36(1, 0, 0), toRadians(rotation));
+      break;
+    case "y" /* Y */:
+      obj.rotateOnAxis(new Vector36(0, 1, 0), toRadians(rotation));
+      break;
+    case "z" /* Z */:
+      obj.rotateOnAxis(new Vector36(0, 0, 1), toRadians(rotation));
+      break;
+  }
+}
+function addBox3WireframeToObject(box, obj, color2 = 16777215, w = 2) {
+  let size = new Vector36();
+  box.getSize(size);
+  let boxGeo = new BoxGeometry4(size.x, size.y, size.z, 1, 1, 1);
+  let wireGeo = new EdgesGeometry2(boxGeo);
+  let wireMat = new LineBasicMaterial2({ color: color2, linewidth: w });
+  let wireframe = new LineSegments2(wireGeo, wireMat);
+  obj.add(wireframe);
+  let axes = new AxesHelper(1);
+  obj.add(axes);
+}
+function addWireframeToObject(obj, color2 = 16777215, w = 2) {
+  let boxGeo = new BoxGeometry4(16, 16, 16, 1, 1, 1);
+  let wireGeo = new EdgesGeometry2(boxGeo);
+  let wireMat = new LineBasicMaterial2({ color: color2, linewidth: w });
+  let wireframe = new LineSegments2(wireGeo, wireMat);
+  obj.add(wireframe);
+  let axes = new AxesHelper(1);
+  obj.add(axes);
+}
+function addWireframeToMesh(geo, mesh, color2 = 16777215, w = 2) {
+  let wireGeo = new EdgesGeometry2(geo);
+  let wireMat = new LineBasicMaterial2({ color: color2, linewidth: w });
+  let wireframe = new LineSegments2(wireGeo, wireMat);
+  mesh.add(wireframe);
+  let axes = new AxesHelper(1);
+  mesh.add(axes);
+  return () => {
+    wireGeo.dispose();
+    wireMat.dispose();
+    axes.dispose();
+  };
+}
+var init_model = __esm({
+  "src/util/model.ts"() {
+    init_Axis();
+    init_util();
+  }
+});
+
 // src/entity/scene/EntityObject.ts
 var EntityObject_exports = {};
 __export(EntityObject_exports, {
@@ -8445,7 +8441,7 @@ function createGuiTextGeometry(layout, shadow = true) {
       }
     }
   }
-  return batches.map(({ image, positions, uvs, colors, indices }) => ({ image, geometry: new BufferGeometry2().setAttribute("position", new Float32BufferAttribute4(positions, 3)).setAttribute("uv", new Float32BufferAttribute4(uvs, 2)).setAttribute("color", new Float32BufferAttribute4(colors, 3)).setIndex(indices) }));
+  return batches.map(({ image, positions, uvs, colors: colors2, indices }) => ({ image, geometry: new BufferGeometry2().setAttribute("position", new Float32BufferAttribute4(positions, 3)).setAttribute("uv", new Float32BufferAttribute4(uvs, 2)).setAttribute("color", new Float32BufferAttribute4(colors2, 3)).setIndex(indices) }));
 }
 var init_GuiText = __esm({
   "src/gui/GuiText.ts"() {
@@ -9127,11 +9123,13 @@ var init_ModelCulling = __esm({
 });
 
 // src/skin/Skins.ts
-var Skins;
+var log11, Skins;
 var init_Skins = __esm({
   "src/skin/Skins.ts"() {
     init_Requests();
     init_Caching();
+    init_log();
+    log11 = logger("Skins");
     Skins = class {
       //<editor-fold desc="Skins">
       /** Returns a skin URL for {@link MineRenderScene.addSkin}, or `undefined` if name lookup fails. */
@@ -9203,7 +9201,7 @@ var init_Skins = __esm({
           }
           return void 0;
         }).catch((err) => {
-          console.warn(err);
+          log11.warn(err);
           return void 0;
         });
       }
@@ -9218,7 +9216,7 @@ var init_Skins = __esm({
           }
           return void 0;
         }).catch((err) => {
-          console.warn(err);
+          log11.warn(err);
           return void 0;
         });
       }
@@ -9232,7 +9230,7 @@ var init_Skins = __esm({
           }
           return void 0;
         }).catch((err) => {
-          console.warn(err);
+          log11.warn(err);
           return void 0;
         });
       }
@@ -9256,7 +9254,7 @@ var init_Skins = __esm({
           }
           return void 0;
         }).catch((err) => {
-          console.warn(err);
+          log11.warn(err);
           return void 0;
         });
       }
@@ -9700,10 +9698,10 @@ var init_SpecialItems = __esm({
           case "minecraft:shield":
           case "shield": {
             const banner = special.type === "banner" || special.type === "minecraft:banner";
-            const colors = await BannerPatterns.getColors(root);
+            const colors2 = await BannerPatterns.getColors(root);
             const dye = banner ? special.color : components["minecraft:base_color"];
-            if (dye !== void 0 && (typeof dye !== "string" || !Object.prototype.hasOwnProperty.call(colors, dye))) throw new Error(`Unsupported dye color ${dye}`);
-            const color2 = dye === void 0 ? void 0 : colors[dye];
+            if (dye !== void 0 && (typeof dye !== "string" || !Object.prototype.hasOwnProperty.call(colors2, dye))) throw new Error(`Unsupported dye color ${dye}`);
+            const color2 = dye === void 0 ? void 0 : colors2[dye];
             const patterns = await BannerPatterns.getLayers(components["minecraft:banner_patterns"], banner ? "banner" : "shield", root);
             const patterned = banner || color2 !== void 0 || patterns.length > 0;
             const baseTexture = texture(banner ? "banner_base" : patterned ? "shield_base" : "shield_base_nopattern", "");
@@ -9728,7 +9726,7 @@ var init_SpecialItems = __esm({
             }
             const tints = {};
             if (patterned) {
-              const draws = [{ texture: texture(`${banner ? "banner" : "shield"}/base`, ""), color: color2 ?? colors.white }, ...patterns];
+              const draws = [{ texture: texture(`${banner ? "banner" : "shield"}/base`, ""), color: color2 ?? colors2.white }, ...patterns];
               draws.forEach((draw, index) => {
                 const name = index === 0 ? "pattern_base" : `pattern_${index - 1}`;
                 layers[name] = { key: draw.texture, texture: draw.texture, layer: overlay2, render: "no_outline", tint: name };
@@ -10059,7 +10057,7 @@ import { BoxGeometry as BoxGeometry5, BufferAttribute as BufferAttribute5, Color
 function isModelObject(obj) {
   return obj.isModelObject;
 }
-var p7, ModelObject;
+var log12, ModelObject;
 var init_ModelObject = __esm({
   "src/model/scene/ModelObject.ts"() {
     init_SceneObject();
@@ -10078,7 +10076,7 @@ var init_ModelObject = __esm({
     init_GuiLight();
     init_ItemTints();
     init_ItemGlint();
-    p7 = prefix("ModelObject");
+    log12 = logger("ModelObject");
     ModelObject = class _ModelObject extends SceneObject {
       constructor(originalModel, options) {
         super(options);
@@ -10232,7 +10230,7 @@ var init_ModelObject = __esm({
               }
               UVMapper.setAtlasUvBounds(elGeo, el.faces, this.atlas);
               if (this.options.tints) {
-                const colors = new Float32Array(elGeo.getAttribute("position").count * 3).fill(1);
+                const colors2 = new Float32Array(elGeo.getAttribute("position").count * 3).fill(1);
                 for (const [faceIndex, faceName] of CUBE_FACES.entries()) {
                   const tintIndex = el.faces[faceName]?.tintindex;
                   if (tintIndex === void 0 || tintIndex < 0) continue;
@@ -10240,10 +10238,10 @@ var init_ModelObject = __esm({
                   if (tint === void 0) continue;
                   const color2 = new Color9(tint);
                   for (let vertex = 0; vertex < 4; vertex++) {
-                    color2.toArray(colors, (faceIndex * 4 + vertex) * 3);
+                    color2.toArray(colors2, (faceIndex * 4 + vertex) * 3);
                   }
                 }
-                elGeo.setAttribute("color", new BufferAttribute5(colors, 3));
+                elGeo.setAttribute("color", new BufferAttribute5(colors2, 3));
               }
               elGeo.applyMatrix4(new Matrix48().makeTranslation((el.to[0] - el.from[0]) / 2, (el.to[1] - el.from[1]) / 2, (el.to[2] - el.from[2]) / 2));
               elGeo.applyMatrix4(new Matrix48().makeTranslation(el.from[0], el.from[1], el.from[2]));
@@ -10263,10 +10261,10 @@ var init_ModelObject = __esm({
               }
             });
           } else {
-            console.debug(p7, this.atlas.model, "has no elements");
+            log12.debug(this.atlas.model, "has no elements");
           }
         } else {
-          console.debug(p7, "Missing atlas for", this);
+          log12.debug("Missing atlas for", this);
         }
         if (this.options.mergeMeshes) {
           let combinedGeo;
@@ -11037,9 +11035,9 @@ var init_FluidModelObject = __esm({
         }
         geometry.clearGroups();
         const color2 = new Color11(this.options.tints?.[0] ?? (this.kind === "water" ? 4159204 : 16777215));
-        const colors = new Float32Array(geometry.getAttribute("position").count * 3);
-        for (let i = 0; i < colors.length; i += 3) color2.toArray(colors, i);
-        geometry.setAttribute("color", new BufferAttribute6(colors, 3));
+        const colors2 = new Float32Array(geometry.getAttribute("position").count * 3);
+        for (let i = 0; i < colors2.length; i += 3) color2.toArray(colors2, i);
+        geometry.setAttribute("color", new BufferAttribute6(colors2, 3));
         geometry.computeBoundingBox();
         geometry.computeBoundingSphere();
         if (this.options.instanceMeshes) {
@@ -11077,7 +11075,7 @@ import { Euler as Euler9, Matrix4 as Matrix410, Quaternion as Quaternion5, Vecto
 function isBlockObject(obj) {
   return obj.isBlockObject;
 }
-var BlockObject;
+var log15, BlockObject;
 var init_BlockObject = __esm({
   "src/model/block/scene/BlockObject.ts"() {
     init_SceneObject();
@@ -11095,6 +11093,8 @@ var init_BlockObject = __esm({
     init_BlockEntities();
     init_Entities();
     init_Biomes();
+    init_log();
+    log15 = logger("BlockObject");
     BlockObject = class _BlockObject extends SceneObject {
       constructor(blockState3, options) {
         super(options);
@@ -11204,7 +11204,7 @@ var init_BlockObject = __esm({
             created.push(await this.scene.addEntity(entity, { wireframe: this.options.wireframe }));
           }
         } catch (error) {
-          console.warn(`Could not draw block entity ${key.toNamespacedString()}, using its block model`, error);
+          log15.warn(`Could not draw block entity ${key.toNamespacedString()}, using its block model`, error);
           this.removeEntities(created);
           return false;
         }
@@ -11858,15 +11858,15 @@ var OBJExporter = class {
       let nbVertex = 0;
       const geometry = points.geometry;
       const vertices = geometry.getAttribute("position");
-      const colors = geometry.getAttribute("color");
+      const colors2 = geometry.getAttribute("color");
       output += "o " + points.name + "\n";
       if (vertices !== void 0) {
         for (let i = 0, l = vertices.count; i < l; i++, nbVertex++) {
           vertex.fromBufferAttribute(vertices, i);
           vertex.applyMatrix4(points.matrixWorld);
           output += "v " + vertex.x + " " + vertex.y + " " + vertex.z;
-          if (colors !== void 0) {
-            color2.fromBufferAttribute(colors, i);
+          if (colors2 !== void 0) {
+            color2.fromBufferAttribute(colors2, i);
             ColorManagement.workingToColorSpace(color2, SRGBColorSpace3);
             output += " " + color2.r + " " + color2.g + " " + color2.b;
           }
@@ -11956,7 +11956,7 @@ var PLYExporter = class {
         const vertices = geometry.getAttribute("position");
         const normals = geometry.getAttribute("normal");
         const uvs = geometry.getAttribute("uv");
-        const colors = geometry.getAttribute("color");
+        const colors2 = geometry.getAttribute("color");
         const indices = geometry.getIndex();
         if (vertices === void 0) {
           return;
@@ -11972,9 +11972,9 @@ var PLYExporter = class {
           includeUVs = true;
           uvType = getPlyType(uvs.array);
         }
-        if (colors !== void 0) {
+        if (colors2 !== void 0) {
           includeColors = true;
-          colorType = getPlyType(colors.array);
+          colorType = getPlyType(colors2.array);
         }
         for (const name of customAttributeNames) {
           const attr = geometry.getAttribute(name);
@@ -11985,16 +11985,16 @@ var PLYExporter = class {
         const geometry = mesh.geometry;
         const vertices = geometry.getAttribute("position");
         const normals = geometry.getAttribute("normal");
-        const colors = geometry.getAttribute("color");
+        const colors2 = geometry.getAttribute("color");
         vertexCount += vertices.count;
         positionType = getPlyType(vertices.array);
         if (normals !== void 0) {
           includeNormals = true;
           normalType = getPlyType(normals.array);
         }
-        if (colors !== void 0) {
+        if (colors2 !== void 0) {
           includeColors = true;
-          colorType = getPlyType(colors.array);
+          colorType = getPlyType(colors2.array);
         }
         for (const name of customAttributeNames) {
           const attr = geometry.getAttribute(name);
@@ -12084,7 +12084,7 @@ property list uchar int vertex_index
         const vertices = geometry.getAttribute("position");
         const normals = geometry.getAttribute("normal");
         const uvs = geometry.getAttribute("uv");
-        const colors = geometry.getAttribute("color");
+        const colors2 = geometry.getAttribute("color");
         const indices = geometry.getIndex();
         normalMatrixWorld.getNormalMatrix(mesh.matrixWorld);
         for (let i = 0, l = vertices.count; i < l; i++) {
@@ -12129,8 +12129,8 @@ property list uchar int vertex_index
             }
           }
           if (includeColors === true) {
-            if (colors != null) {
-              tempColor.fromBufferAttribute(colors, i);
+            if (colors2 != null) {
+              tempColor.fromBufferAttribute(colors2, i);
               ColorManagement2.workingToColorSpace(tempColor, SRGBColorSpace4);
               const r = colorIsFloat ? tempColor.r : Math.round(tempColor.r * colorScale);
               const g = colorIsFloat ? tempColor.g : Math.round(tempColor.g * colorScale);
@@ -12207,7 +12207,7 @@ property list uchar int vertex_index
         const vertices = geometry.getAttribute("position");
         const normals = geometry.getAttribute("normal");
         const uvs = geometry.getAttribute("uv");
-        const colors = geometry.getAttribute("color");
+        const colors2 = geometry.getAttribute("color");
         const indices = geometry.getIndex();
         normalMatrixWorld.getNormalMatrix(mesh.matrixWorld);
         for (let i = 0, l = vertices.count; i < l; i++) {
@@ -12231,8 +12231,8 @@ property list uchar int vertex_index
             }
           }
           if (includeColors === true) {
-            if (colors != null) {
-              tempColor.fromBufferAttribute(colors, i);
+            if (colors2 != null) {
+              tempColor.fromBufferAttribute(colors2, i);
               ColorManagement2.workingToColorSpace(tempColor, SRGBColorSpace4);
               const r = colorIsFloat ? tempColor.r : Math.round(tempColor.r * colorScale);
               const g = colorIsFloat ? tempColor.g : Math.round(tempColor.g * colorScale);
@@ -12474,11 +12474,11 @@ function createSnapshot(root, gltf, bakeColors = false) {
         if (instanceColor) tint.multiply(instanceColor);
         if (bakeColors) {
           const original = geometry.getAttribute("color");
-          const colors = new Float32BufferAttribute3(new Float32Array(geometry.getAttribute("position").count * 3), 3);
-          for (let i = 0; i < colors.count; i++) {
-            colors.setXYZ(i, (original?.getX(i) ?? 1) * tint.r, (original?.getY(i) ?? 1) * tint.g, (original?.getZ(i) ?? 1) * tint.b);
+          const colors2 = new Float32BufferAttribute3(new Float32Array(geometry.getAttribute("position").count * 3), 3);
+          for (let i = 0; i < colors2.count; i++) {
+            colors2.setXYZ(i, (original?.getX(i) ?? 1) * tint.r, (original?.getY(i) ?? 1) * tint.g, (original?.getZ(i) ?? 1) * tint.b);
           }
-          geometry.setAttribute("color", colors);
+          geometry.setAttribute("color", colors2);
         } else if (material.color) {
           material.color.copy(tint);
         }
@@ -12527,8 +12527,8 @@ function selectAlphaMode(material, geometry) {
   const texture = material.map;
   if (material.type !== "MeshBasicMaterial" || !material.transparent || !material.depthWrite || material.opacity !== 1 || material.alphaMap || !texture?.isDataTexture || texture.format !== RGBAFormat3 || texture.type !== UnsignedByteType || texture.wrapS !== ClampToEdgeWrapping2 || texture.wrapT !== ClampToEdgeWrapping2 || texture.magFilter !== NearestFilter3 || texture.minFilter !== NearestFilter3 || texture.anisotropy > 1 || texture.offset.x !== 0 || texture.offset.y !== 0 || texture.repeat.x !== 1 || texture.repeat.y !== 1 || texture.rotation !== 0 || !texture.matrixAutoUpdate && !texture.matrix.elements.every((value, i) => value === (i % 4 === 0 ? 1 : 0))) return;
   const uv = geometry.getAttribute(texture.channel === 0 ? "uv" : `uv${texture.channel}`);
-  const colors = geometry.getAttribute("color");
-  if (!uv || material.vertexColors && colors?.itemSize === 4) return;
+  const colors2 = geometry.getAttribute("color");
+  if (!uv || material.vertexColors && colors2?.itemSize === 4) return;
   const { data, width, height } = texture.image;
   if (!data || width < 1 || height < 1 || data.length < width * height * 4) return;
   const count = geometry.index?.count ?? uv.count;
@@ -12937,7 +12937,7 @@ init_util();
 import { Raycaster, Vector2 as Vector25 } from "three";
 init_log();
 init_three();
-var p8 = prefix("SceneInspector");
+var log13 = logger("SceneInspector");
 var help = "<span>Ctrl/Cmd+Click to Select<br/></span><br/>";
 var SceneInspector = class {
   constructor(renderer) {
@@ -13031,7 +13031,7 @@ var SceneInspector = class {
   }
   selectObject(targetObject, targetIntersection, instance = this.getIntersectionInstance(targetIntersection)) {
     this.selectedObject = targetObject;
-    console.log(p8, "selected", targetObject);
+    log13.debug("selected", targetObject);
     this.redraw(targetObject, targetIntersection, instance);
   }
   redraw(targetObject, targetIntersection, instance) {
@@ -13291,7 +13291,7 @@ var SceneStatsDisplay = class {
 
 // src/instance/InstanceManager.ts
 init_log();
-var p9 = prefix("InstanceManager");
+var log14 = logger("InstanceManager");
 var InstanceManager = class {
   constructor() {
     this.isInstanceManager = true;
@@ -13300,7 +13300,7 @@ var InstanceManager = class {
   /** Allocates a new placement of a cached model, or returns `undefined` if the key is unknown. */
   async get(key) {
     if (key in this.instanceCache) {
-      console.debug(p9, "key in cache", key);
+      log14.debug("key in cache", key);
       return (await this.instanceCache[key]).nextInstance();
     }
     return void 0;
@@ -13310,7 +13310,7 @@ var InstanceManager = class {
     if (key in this.instanceCache) {
       return await this.get(key);
     }
-    console.debug(p9, "key not in cache", key);
+    log14.debug("key not in cache", key);
     const pending = Promise.resolve().then(supplier).then((obj) => obj.nextInstance());
     this.instanceCache[key] = pending;
     try {
@@ -15921,6 +15921,8 @@ var MapControls = class extends OrbitControls {
 };
 
 // src/renderer/Renderer.ts
+init_log();
+var log16 = logger("Renderer");
 var Renderer = class _Renderer {
   constructor(options, surface) {
     this._width = 0;
@@ -16206,10 +16208,10 @@ var Renderer = class _Renderer {
     this._element = element;
     this._element.appendChild(this.renderer.domElement);
     if (this.viewWidth == 0) {
-      console.warn("0 element width");
+      log16.warn("0 element width");
     }
     if (this.viewHeight == 0) {
-      console.warn("0 element height");
+      log16.warn("0 element height");
     }
     this.resize(this.viewWidth, this.viewHeight);
   }
@@ -17023,8 +17025,62 @@ init_Textures();
 // src/three/index.ts
 init_BufferGeometryUtils();
 
-// src/index.ts
-init_util2();
+// src/util/BatchedExecutor.ts
+import { JobQueue as JobQueue2 } from "jobqu";
+var BatchedExecutor = class {
+  /**
+   * @param interval - Delay between queue runs, in milliseconds.
+   * @param batch - Maximum tasks started per run and maximum tasks active at once.
+   */
+  constructor(interval = 1, batch = 30) {
+    if (!Number.isFinite(interval) || interval < 0) throw new RangeError("Batch interval must be finite and nonnegative");
+    if (!Number.isInteger(batch) || batch < 1) throw new RangeError("Batch size must be a positive integer");
+    this.interval = interval;
+    this.batch = batch;
+    this.queue = new JobQueue2(async (task) => task(), { interval, maxPerRun: batch, maxActive: batch });
+  }
+  /** Queues a task and resolves with its result, or rejects with its error. */
+  submit(task) {
+    return this.queue.add(() => task());
+  }
+  /** Rejects queued and future tasks. Tasks already running are allowed to finish. */
+  stop() {
+    this.queue.end();
+  }
+};
+
+// src/util/index.ts
+init_log();
+init_model();
+
+// src/util/performance.ts
+function captureException(e, ...extra) {
+  console.error(e, extra);
+}
+function timingStart(marker) {
+  console.time(marker);
+}
+function timingEnd(marker) {
+  console.timeEnd(marker);
+}
+
+// src/util/sha.ts
+import SHA1 from "crypto-js/sha1.js";
+import SHA256 from "crypto-js/sha256.js";
+import SHA512 from "crypto-js/sha512.js";
+function sha1(str) {
+  return SHA1(str).toString();
+}
+function sha256(str) {
+  return SHA256(str).toString();
+}
+function sha512(str) {
+  return SHA512(str).toString();
+}
+
+// src/util/index.ts
+init_three();
+init_util();
 
 // src/world/AnvilParser.ts
 init_MineRenderError();
@@ -18114,6 +18170,8 @@ function hitNormal(hit) {
 }
 
 // src/world/_entities/WorldEntities.ts
+init_log();
+var log17 = logger("WorldEntities");
 var WorldEntities = class {
   constructor(scene) {
     this.scene = scene;
@@ -18182,7 +18240,7 @@ var WorldEntities = class {
           placement.owner.set(object4, { type: key.toNamespacedString(), position: placement.position });
           this.scene.add(object4);
         } catch (error) {
-          console.warn(`Could not draw saved entity ${placement.key.toNamespacedString()}, skipping it`, error);
+          log17.warn(`Could not draw saved entity ${placement.key.toNamespacedString()}, skipping it`, error);
         } finally {
           if (object4 && !placement.owner.has(object4)) object4.dispose();
         }
@@ -18259,14 +18317,14 @@ var BiomeBlend = class {
       this.tiles.set(key, tile);
     } else {
       const snapshot = new AssetKey("minecraft", "", void 0, void 0, "assets", ".json", root);
-      const colors = this.buildTile(kind, snapshot, tileX, quartY, tileZ, this._radius).then((result2) => {
-        if (!result2.complete && this.tiles.get(key)?.colors === colors) this.tiles.delete(key);
+      const colors2 = this.buildTile(kind, snapshot, tileX, quartY, tileZ, this._radius).then((result2) => {
+        if (!result2.complete && this.tiles.get(key)?.colors === colors2) this.tiles.delete(key);
         return result2;
       }, (error) => {
-        if (this.tiles.get(key)?.colors === colors) this.tiles.delete(key);
+        if (this.tiles.get(key)?.colors === colors2) this.tiles.delete(key);
         throw error;
       });
-      tile = { x: tileX, z: tileZ, colors };
+      tile = { x: tileX, z: tileZ, colors: colors2 };
       this.tiles.set(key, tile);
       if (this.tiles.size > MAX_TILES) this.tiles.delete(this.tiles.keys().next().value);
     }
@@ -18324,7 +18382,7 @@ var BiomeBlend = class {
         }
       }
     }
-    const colors = new Int32Array(256).fill(-1), width = radius * 2 + 1;
+    const colors2 = new Int32Array(256).fill(-1), width = radius * 2 + 1;
     for (let z = 0; z < 16; z++) {
       for (let x = 0; x < 16; x++) {
         if (samples[(z + radius) * size + x + radius] === -1) continue;
@@ -18332,10 +18390,10 @@ var BiomeBlend = class {
         const bottomLeft = (z + width) * stride + x, bottomRight = bottomLeft + width;
         const sum = (values) => values[bottomRight] - values[bottomLeft] - values[topRight] + values[topLeft];
         const count = sum(sums[3]);
-        if (count) colors[z * 16 + x] = Math.floor(sum(sums[0]) / count) << 16 | Math.floor(sum(sums[1]) / count) << 8 | Math.floor(sum(sums[2]) / count);
+        if (count) colors2[z * 16 + x] = Math.floor(sum(sums[0]) / count) << 16 | Math.floor(sum(sums[1]) / count) << 8 | Math.floor(sum(sums[2]) / count);
       }
     }
-    return { colors, complete, failures };
+    return { colors: colors2, complete, failures };
   }
 };
 
@@ -18394,6 +18452,8 @@ function skipsBlockFace(data, rule, block, neighbor, face) {
 }
 
 // src/world/MineRenderWorld.ts
+init_log();
+var log18 = logger("MineRenderWorld");
 var MineRenderWorld = class {
   constructor(scene, options = {}) {
     this._chunks = /* @__PURE__ */ new Map();
@@ -18483,8 +18543,14 @@ var MineRenderWorld = class {
     }
     return queued;
   }
-  async refreshBiomes() {
-    if (this.biomeRefreshing) await this.biomeRefreshing;
+  async refreshBiomes(deferCulling = false) {
+    if (this.biomeRefreshing) {
+      await this.biomeRefreshing;
+      if (!deferCulling) {
+        if (this.pendingCulling.size) await this.updateCulling([]);
+        else await this.culling;
+      }
+    }
     if (!this.pendingBiomes.size) return /* @__PURE__ */ new Map();
     return this.biomeRefreshing ??= Promise.resolve().then(async () => {
       const failures = /* @__PURE__ */ new Map();
@@ -18496,7 +18562,7 @@ var MineRenderWorld = class {
           this.pendingBiomes.delete(chunk);
           if (this._chunks.get(`${chunk.x}_${chunk.y}_${chunk.z}`) !== chunk) continue;
           try {
-            await chunk.refreshBiomes(columns);
+            await chunk.refreshBiomes(columns, deferCulling);
           } catch (error) {
             failures.set(chunk, error);
             if (this._chunks.get(`${chunk.x}_${chunk.y}_${chunk.z}`) === chunk) this.pendingBiomes.set(chunk, void 0);
@@ -18749,7 +18815,7 @@ var MineRenderWorld = class {
     } finally {
       this.markBiomesChanged(chunk.x, chunk.z, void 0, false);
       const failures = await this.refreshBiomes();
-      if (failures.size) console.warn("Failed to refresh biome colors", failures.values().next().value);
+      if (failures.size) log18.warn("Failed to refresh biome colors", failures.values().next().value);
       await this.updateCulling([...changes.values()]);
     }
   }
@@ -18758,16 +18824,36 @@ var MineRenderWorld = class {
    * Coordinates match AnvilChunk.x/z, not block positions. Missing columns are ignored.
    */
   async unloadChunkColumn(x, z) {
-    if (!Number.isInteger(x) || !Number.isInteger(z)) {
-      throw new RangeError("Chunk column coordinates must be integers");
+    return this.unloadChunkColumns([{ x, z }]);
+  }
+  /**
+   * Removes chunk columns together and refreshes surviving neighbors once.
+   * Coordinates are absolute chunk columns. Duplicate and missing columns are ignored.
+   */
+  async unloadChunkColumns(positions) {
+    const columns = /* @__PURE__ */ new Map();
+    for (const position of positions) {
+      const { x, z } = position ?? {};
+      if (!Number.isInteger(x) || !Number.isInteger(z)) {
+        throw new RangeError("Chunk column coordinates must be integers");
+      }
+      columns.set(`${x}_${z}`, { x, z });
     }
-    this.entities?.clearColumn(x, z);
+    if (!columns.size) return;
     await this.culling;
+    let sliceStart = performance.now();
     try {
-      await this.clearChunkColumn(x, z);
+      for (const { x, z } of columns.values()) {
+        this.entities?.clearColumn(x, z);
+        await this.clearChunkColumn(x, z);
+        if (performance.now() - sliceStart > 8) {
+          await yieldToEventLoop();
+          sliceStart = performance.now();
+        }
+      }
     } finally {
-      const failures = await this.refreshBiomes();
-      if (failures.size) console.warn("Failed to refresh biome colors", failures.values().next().value);
+      const failures = await this.refreshBiomes(true);
+      if (failures.size) log18.warn("Failed to refresh biome colors", failures.values().next().value);
       await this.updateCulling([]);
     }
   }
@@ -18829,7 +18915,7 @@ var MineRenderWorld = class {
     }
     this.sectionModels?.clear();
   }
-  updateCulling(positions) {
+  updateCulling(positions, defer = false) {
     const neighbor = new Vector319();
     for (const pos of positions) {
       const cx = Math.floor(pos.x / 16), cy = Math.floor(pos.y / 16), cz = Math.floor(pos.z / 16);
@@ -18851,58 +18937,72 @@ var MineRenderWorld = class {
         }
       }
     }
+    if (defer) return Promise.resolve();
     return this.culling ??= Promise.resolve().then(async () => {
       let sliceStart = performance.now();
       try {
         const culling = await loadBlockCulling();
         while (this.pendingCulling.size) {
-          const batch = [...this.pendingCulling];
+          const batch = new Map(this.pendingCulling);
           this.pendingCulling.clear();
-          for (const [chunk, indices] of batch) {
-            const neighbors = CUBE_FACE_OFFSETS.map(([x, y, z]) => this._chunks.get(`${chunk.x + x}_${chunk.y + y}_${chunk.z + z}`));
-            const neighborAt = (x, y, z) => {
-              const lx = x - chunk.x * 16, ly = y - chunk.y * 16, lz = z - chunk.z * 16;
-              const section = neighbors[lx >= 16 ? 0 : lx < 0 ? 1 : ly >= 16 ? 2 : ly < 0 ? 3 : lz >= 16 ? 4 : 5];
-              return [section, (ly & 15) * 256 + (lz & 15) * 16 + (lx & 15)];
-            };
-            const masks = chunk.updateCullMasks(indices === "all" ? void 0 : indices, (x, y, z) => {
-              const [section, i] = neighborAt(x, y, z);
-              return section?.isOccludingIndex(i) ?? false;
-            }, culling, (x, y, z) => {
-              const [section, i] = neighborAt(x, y, z);
-              return section?.visibleBlockIndex(i);
-            });
-            const fluidIndices = indices === "all" ? function* () {
-              for (let index = 0; index < 4096; index++) yield index;
-            }() : indices;
-            for (const index of fluidIndices) {
-              if (!chunk.fluidByteIndex(index) || !chunk.isBlockVisibleIndex(index)) continue;
-              const lx = index % 16, ly = Math.floor(index / 256), lz = Math.floor(index / 16) % 16;
-              const wx = chunk.x * 16 + lx, wy = chunk.y * 16 + ly, wz = chunk.z * 16 + lz;
-              const block = chunk.getBlockAt(neighbor.set(wx, wy, wz));
-              if (block.object?.fluidKind) {
-                await block.object.updateFluid((x, y, z) => {
-                  const nx = lx + x, ny = ly + y, nz = lz + z;
-                  const section = nx >= 0 && nx < 16 && ny >= 0 && ny < 16 && nz >= 0 && nz < 16 ? chunk : this._chunks.get(`${chunk.x + Math.floor(nx / 16)}_${chunk.y + Math.floor(ny / 16)}_${chunk.z + Math.floor(nz / 16)}`);
-                  const neighborIndex = (ny & 15) * 256 + (nz & 15) * 16 + (nx & 15);
-                  const byte = section?.fluidByteIndex(neighborIndex) ?? 0;
-                  return {
-                    fluid: fluidKindOf(byte),
-                    level: byte & 15,
-                    solid: section?.isOccludingIndex(neighborIndex) ?? false
-                  };
-                });
+          try {
+            for (const [chunk, indices] of batch) {
+              const neighbors = CUBE_FACE_OFFSETS.map(([x, y, z]) => this._chunks.get(`${chunk.x + x}_${chunk.y + y}_${chunk.z + z}`));
+              const neighborAt = (x, y, z) => {
+                const lx = x - chunk.x * 16, ly = y - chunk.y * 16, lz = z - chunk.z * 16;
+                const section = neighbors[lx >= 16 ? 0 : lx < 0 ? 1 : ly >= 16 ? 2 : ly < 0 ? 3 : lz >= 16 ? 4 : 5];
+                return [section, (ly & 15) * 256 + (lz & 15) * 16 + (lx & 15)];
+              };
+              const masks = chunk.updateCullMasks(indices === "all" ? void 0 : indices, (x, y, z) => {
+                const [section, i] = neighborAt(x, y, z);
+                return section?.isOccludingIndex(i) ?? false;
+              }, culling, (x, y, z) => {
+                const [section, i] = neighborAt(x, y, z);
+                return section?.visibleBlockIndex(i);
+              });
+              const fluidIndices = indices === "all" ? function* () {
+                for (let index = 0; index < 4096; index++) yield index;
+              }() : indices;
+              for (const index of fluidIndices) {
+                if (!chunk.fluidByteIndex(index) || !chunk.isBlockVisibleIndex(index)) continue;
+                const lx = index % 16, ly = Math.floor(index / 256), lz = Math.floor(index / 16) % 16;
+                const wx = chunk.x * 16 + lx, wy = chunk.y * 16 + ly, wz = chunk.z * 16 + lz;
+                const block = chunk.getBlockAt(neighbor.set(wx, wy, wz));
+                if (block.object?.fluidKind) {
+                  await block.object.updateFluid((x, y, z) => {
+                    const nx = lx + x, ny = ly + y, nz = lz + z;
+                    const section = nx >= 0 && nx < 16 && ny >= 0 && ny < 16 && nz >= 0 && nz < 16 ? chunk : this._chunks.get(`${chunk.x + Math.floor(nx / 16)}_${chunk.y + Math.floor(ny / 16)}_${chunk.z + Math.floor(nz / 16)}`);
+                    const neighborIndex = (ny & 15) * 256 + (nz & 15) * 16 + (nx & 15);
+                    const byte = section?.fluidByteIndex(neighborIndex) ?? 0;
+                    return {
+                      fluid: fluidKindOf(byte),
+                      level: byte & 15,
+                      solid: section?.isOccludingIndex(neighborIndex) ?? false
+                    };
+                  });
+                }
+              }
+              for (const [index, mask] of masks) await chunk.setCullMaskIndex(index, mask);
+              await chunk.refreshLight(indices === "all" ? void 0 : indices);
+              chunk.refreshAmbientOcclusion(this._ambientOcclusion);
+              if ((this._ambientOcclusion || this.ambientOcclusionPending) && performance.now() - sliceStart > 8) {
+                await yieldToEventLoop();
+                sliceStart = performance.now();
               }
             }
-            for (const [index, mask] of masks) await chunk.setCullMaskIndex(index, mask);
-            await chunk.refreshLight(indices === "all" ? void 0 : indices);
-            chunk.refreshAmbientOcclusion(this._ambientOcclusion);
-            if ((this._ambientOcclusion || this.ambientOcclusionPending) && performance.now() - sliceStart > 8) {
-              await yieldToEventLoop();
-              sliceStart = performance.now();
+            const builds = await Promise.allSettled([...batch.keys()].map(async (chunk) => {
+              await chunk.rebuildSectionMesh();
+              batch.delete(chunk);
+            }));
+            const failure = builds.find((result) => result.status === "rejected");
+            if (failure?.status === "rejected") throw failure.reason;
+          } catch (error) {
+            for (const [chunk, indices] of batch) {
+              const pending = this.pendingCulling.get(chunk);
+              this.pendingCulling.set(chunk, indices === "all" || pending === "all" ? "all" : /* @__PURE__ */ new Set([...indices, ...pending ?? []]));
             }
+            throw error;
           }
-          await Promise.all(batch.map(([chunk]) => chunk.rebuildSectionMesh()));
         }
       } finally {
         this.culling = void 0;
@@ -18919,7 +19019,7 @@ var MineRenderWorld = class {
         x,
         y,
         z,
-        (positions) => this.updateCulling(positions),
+        (positions, defer) => this.updateCulling(positions, defer),
         this.sectionModels,
         (x2, y2, z2) => {
           const cx = Math.floor(x2 / 16), cy = Math.floor(y2 / 16), cz = Math.floor(z2 / 16);
@@ -19192,7 +19292,7 @@ function buildSectionGeometry(input) {
       }
     }
     const positions = new Float32Array(faces * 12), normals = new Float32Array(faces * 12);
-    const uvs = new Float32Array(faces * 8), uvBounds = new Float32Array(faces * 16), colors = new Float32Array(faces * 12);
+    const uvs = new Float32Array(faces * 8), uvBounds = new Float32Array(faces * 16), colors2 = new Float32Array(faces * 12);
     const shade = new Float32Array(faces * 4).fill(1);
     const outputIndices = new Uint32Array(faces * 6);
     const blockIndices = new Uint16Array(faces);
@@ -19231,9 +19331,9 @@ function buildSectionGeometry(input) {
           uvBounds[vertex * 4 + 2] = mapU(template.uvBounds[source * 4 + 2]);
           uvBounds[vertex * 4 + 3] = mapV(template.uvBounds[source * 4 + 3]);
           const factor = brightness * (ambientMask ? cornerBrightness2[corner] : 1);
-          colors[vertex * 3] = (tint === void 0 ? template.colors[source * 3] : biomeTints[tint]) * factor;
-          colors[vertex * 3 + 1] = (tint === void 0 ? template.colors[source * 3 + 1] : biomeTints[tint + 1]) * factor;
-          colors[vertex * 3 + 2] = (tint === void 0 ? template.colors[source * 3 + 2] : biomeTints[tint + 2]) * factor;
+          colors2[vertex * 3] = (tint === void 0 ? template.colors[source * 3] : biomeTints[tint]) * factor;
+          colors2[vertex * 3 + 1] = (tint === void 0 ? template.colors[source * 3 + 1] : biomeTints[tint + 1]) * factor;
+          colors2[vertex * 3 + 2] = (tint === void 0 ? template.colors[source * 3 + 2] : biomeTints[tint + 2]) * factor;
         }
         for (let corner = 0; corner < 6; corner++) outputIndices[indexOffset++] = start + template.indices[quad * 6 + corner];
       }
@@ -19268,15 +19368,15 @@ function buildSectionGeometry(input) {
             mapU((rect[0] + rect[2]) / atlas.width),
             mapV(1 - rect[1] / atlas.height)
           ], vertex * 4);
-          colors[vertex * 3] = tint[0] * brightness;
-          colors[vertex * 3 + 1] = tint[1] * brightness;
-          colors[vertex * 3 + 2] = tint[2] * brightness;
+          colors2[vertex * 3] = tint[0] * brightness;
+          colors2[vertex * 3 + 1] = tint[1] * brightness;
+          colors2[vertex * 3 + 2] = tint[2] * brightness;
         }
         outputIndices.set([start, start + 1, start + 2, start, start + 2, start + 3], indexOffset);
         indexOffset += 6;
       }
     }
-    return { layer: page.layer, width: page.width, height: page.height, placements: page.placements, positions, normals, uvs, uvBounds, colors, shade, indices: outputIndices, blockIndices };
+    return { layer: page.layer, width: page.width, height: page.height, placements: page.placements, positions, normals, uvs, uvBounds, colors: colors2, shade, indices: outputIndices, blockIndices };
   });
 }
 function sectionGeometryTransferables(pages) {
@@ -19654,11 +19754,14 @@ var Chunk = class _Chunk {
     this.biomes = copy;
     return this.refreshBiomes();
   }
-  /** Rebuilds biome-tinted blocks while preserving hidden blocks and unrelated render objects. */
-  refreshBiomes(columns) {
-    return this.changeBlocks(() => this.refreshBiomeBlocks(columns), true);
+  /**
+   * Rebuilds biome-tinted blocks while preserving hidden blocks and unrelated render objects.
+   * The owning world can defer neighbor culling until all affected chunks are refreshed.
+   */
+  refreshBiomes(columns, deferCulling = false) {
+    return this.changeBlocks(() => this.refreshBiomeBlocks(columns, deferCulling), true);
   }
-  async refreshBiomeBlocks(columns) {
+  async refreshBiomeBlocks(columns, deferCulling = false) {
     const blend = columns && this.biomeBlend?.();
     const ownColumn = columns?.some((column) => column.x === this.x && column.z === this.z);
     const affected = /* @__PURE__ */ new Map();
@@ -19715,7 +19818,7 @@ var Chunk = class _Chunk {
         this.renderedBlocks.get(index)?.object?.setVisible(false);
       }
       const positions = blocks.map(({ index }) => new Vector320(...this.positionAt(index)));
-      if (this.onBlocksChanged) await this.onBlocksChanged(positions);
+      if (this.onBlocksChanged) await this.onBlocksChanged(positions, deferCulling);
       else await this.rebuildSectionMesh();
     }
   }
@@ -20369,19 +20472,12 @@ var WorldStreamer = class {
     this.loading?.controller.abort();
     return this.disposal ??= Promise.resolve().then(async () => {
       await this.running?.catch(() => void 0);
-      let failure;
-      let failed = false;
-      for (const position of this.owned.values()) {
-        try {
-          await this.unload(position);
-        } catch (error) {
-          failed = true;
-          failure ??= error;
-        }
+      try {
+        await this.unloadMany([...this.owned.values()]);
+      } finally {
+        this.missing.clear();
+        this.failed.clear();
       }
-      this.missing.clear();
-      this.failed.clear();
-      if (failed) throw failure;
     }).catch((error) => {
       this.disposal = void 0;
       throw error;
@@ -20396,9 +20492,9 @@ var WorldStreamer = class {
         for (const [key, position2] of this.failed) {
           if (!this.within(position2, this.unloadRadius)) this.failed.delete(key);
         }
-        const obsolete = [...this.owned.values()].find((position2) => !this.loaded.has(this.key(position2)) || !this.within(position2, this.unloadRadius));
-        if (obsolete) {
-          await this.unload(obsolete);
+        const obsolete = [...this.owned.values()].filter((position2) => !this.loaded.has(this.key(position2)) || !this.within(position2, this.unloadRadius));
+        if (obsolete.length) {
+          await this.unloadMany(obsolete);
           continue;
         }
         const position = this.desired.find((position2) => this.needsLoad(position2));
@@ -20428,7 +20524,7 @@ var WorldStreamer = class {
           this.loaded.set(this.key(position), position);
         } catch (error) {
           try {
-            await this.unload(position);
+            await this.unloadMany([position]);
           } catch (cleanupError) {
             const failure = error instanceof Error ? error : new Error(String(error));
             try {
@@ -20449,10 +20545,18 @@ var WorldStreamer = class {
     const key = this.key(position);
     return !this.loaded.has(key) && !this.missing.has(key) && !this.failed.has(key);
   }
-  async unload(position) {
-    await this.world.unloadChunkColumn(position.x, position.z);
-    this.owned.delete(this.key(position));
-    this.loaded.delete(this.key(position));
+  async unloadMany(positions) {
+    if (!positions.length) return;
+    try {
+      await this.world.unloadChunkColumns(positions.map(({ x, z }) => ({ x, z })));
+    } catch (error) {
+      for (const position of positions) this.loaded.delete(this.key(position));
+      throw error;
+    }
+    for (const position of positions) {
+      this.owned.delete(this.key(position));
+      this.loaded.delete(this.key(position));
+    }
   }
   validateChunk(chunk, position) {
     if (chunk.x !== position.x || chunk.z !== position.z) {
@@ -20695,6 +20799,7 @@ export {
   ItemGlint,
   ItemTints,
   LitematicaParser,
+  Logging,
   MapControls,
   Materials,
   Meshes,
@@ -20809,6 +20914,7 @@ export {
   isTripleArray,
   isVector3,
   layoutGuiText,
+  logger,
   md5,
   mergeBufferAttributes,
   mergeBufferGeometries,