minerender 2.1.0-alpha.76 → 2.1.0-alpha.78

package/dist/browser/index.js

@@ -814,8 +814,8 @@ var init_Textures = __esm({
           for (let y = 0; y < size; y++) {
             for (let x = 0; x < size; x++) {
               const offset = (y * size + x) * 4;
-              const color = (x + y) % 2 === 0 ? 255 : 0;
-              data[offset] = data[offset + 2] = color;
+              const color2 = (x + y) % 2 === 0 ? 255 : 0;
+              data[offset] = data[offset + 2] = color2;
               data[offset + 3] = 255;
             }
           }
@@ -1400,17 +1400,17 @@ var init_AssetKey = __esm({
 var DisplayPosition, DISPLAY_POSITIONS;
 var init_DisplayPosition = __esm({
   "src/model/DisplayPosition.ts"() {
-    DisplayPosition = /* @__PURE__ */ ((DisplayPosition2) => {
-      DisplayPosition2["THIRDPERSON_RIGHTHAND"] = "thirdperson_righthand";
-      DisplayPosition2["THIRDPERSON_LEFTHAND"] = "thirdperson_lefthand";
-      DisplayPosition2["FIRSTPERSON_RIGHTHAND"] = "firstperson_righthand";
-      DisplayPosition2["FIRSTPERSON_LEFTHAND"] = "firstperson_lefthand";
-      DisplayPosition2["GUI"] = "gui";
-      DisplayPosition2["HEAD"] = "head";
-      DisplayPosition2["GROUND"] = "ground";
-      DisplayPosition2["FIXED"] = "fixed";
-      DisplayPosition2["ON_SHELF"] = "on_shelf";
-      return DisplayPosition2;
+    DisplayPosition = /* @__PURE__ */ ((DisplayPosition3) => {
+      DisplayPosition3["THIRDPERSON_RIGHTHAND"] = "thirdperson_righthand";
+      DisplayPosition3["THIRDPERSON_LEFTHAND"] = "thirdperson_lefthand";
+      DisplayPosition3["FIRSTPERSON_RIGHTHAND"] = "firstperson_righthand";
+      DisplayPosition3["FIRSTPERSON_LEFTHAND"] = "firstperson_lefthand";
+      DisplayPosition3["GUI"] = "gui";
+      DisplayPosition3["HEAD"] = "head";
+      DisplayPosition3["GROUND"] = "ground";
+      DisplayPosition3["FIXED"] = "fixed";
+      DisplayPosition3["ON_SHELF"] = "on_shelf";
+      return DisplayPosition3;
     })(DisplayPosition || {});
     DISPLAY_POSITIONS = Object.values(DisplayPosition);
   }
@@ -1628,11 +1628,11 @@ var init_Models = __esm({
           return this.PERSISTENT_CACHE.getOrLoad(AssetLoader.persistentKey(keyStr), (k1) => {
             return AssetLoader.get(key, "model" /* MODEL */);
           });
-        }).then((asset) => {
-          if (asset) {
-            asset.key = key;
+        }).then((asset2) => {
+          if (asset2) {
+            asset2.key = key;
           }
-          return asset;
+          return asset2;
         });
       }
       /**
@@ -1722,11 +1722,11 @@ var init_BlockStates = __esm({
           return this.PERSISTENT_CACHE.getOrLoad(AssetLoader.persistentKey(keyStr), (k1) => {
             return AssetLoader.get(key, "blockstate" /* BLOCKSTATE */);
           });
-        }).then((asset) => {
-          if (asset) {
-            asset.key = key;
+        }).then((asset2) => {
+          if (asset2) {
+            asset2.key = key;
           }
-          return asset;
+          return asset2;
         });
       }
       static getAll(keys) {
@@ -1875,29 +1875,29 @@ function applyGenericRotation(axis, rotation, obj) {
       break;
   }
 }
-function addBox3WireframeToObject(box, obj, color = 16777215, w = 2) {
+function addBox3WireframeToObject(box, obj, color2 = 16777215, w = 2) {
   let size = new import_three8.Vector3();
   box.getSize(size);
   let boxGeo = new import_three8.BoxGeometry(size.x, size.y, size.z, 1, 1, 1);
   let wireGeo = new import_three8.EdgesGeometry(boxGeo);
-  let wireMat = new import_three8.LineBasicMaterial({ color, linewidth: w });
+  let wireMat = new import_three8.LineBasicMaterial({ color: color2, linewidth: w });
   let wireframe = new import_three8.LineSegments(wireGeo, wireMat);
   obj.add(wireframe);
   let axes = new import_three8.AxesHelper(1);
   obj.add(axes);
 }
-function addWireframeToObject(obj, color = 16777215, w = 2) {
+function addWireframeToObject(obj, color2 = 16777215, w = 2) {
   let boxGeo = new import_three8.BoxGeometry(16, 16, 16, 1, 1, 1);
   let wireGeo = new import_three8.EdgesGeometry(boxGeo);
-  let wireMat = new import_three8.LineBasicMaterial({ color, linewidth: w });
+  let wireMat = new import_three8.LineBasicMaterial({ color: color2, linewidth: w });
   let wireframe = new import_three8.LineSegments(wireGeo, wireMat);
   obj.add(wireframe);
   let axes = new import_three8.AxesHelper(1);
   obj.add(axes);
 }
-function addWireframeToMesh(geo, mesh, color = 16777215, w = 2) {
+function addWireframeToMesh(geo, mesh, color2 = 16777215, w = 2) {
   let wireGeo = new import_three8.EdgesGeometry(geo);
-  let wireMat = new import_three8.LineBasicMaterial({ color, linewidth: w });
+  let wireMat = new import_three8.LineBasicMaterial({ color: color2, linewidth: w });
   let wireframe = new import_three8.LineSegments(wireGeo, wireMat);
   mesh.add(wireframe);
   let axes = new import_three8.AxesHelper(1);
@@ -2328,27 +2328,27 @@ var init_PackFormats = __esm({
     init_Requests();
     PackFormats = class {
       /** Resolves pack formats from Mojang's client metadata hosted on assets.mcasset.cloud. */
-      static async get(version, type) {
-        let pending = this.versions.get(version);
+      static async get(version2, type) {
+        let pending = this.versions.get(version2);
         if (!pending || pending.expires <= Date.now()) {
           pending = {
-            formats: this.load(version),
-            expires: ["latest", "release", "snapshot"].includes(version) ? Date.now() + 3e5 : Infinity
+            formats: this.load(version2),
+            expires: ["latest", "release", "snapshot"].includes(version2) ? Date.now() + 3e5 : Infinity
           };
-          this.versions.set(version, pending);
+          this.versions.set(version2, pending);
         }
         try {
           return (await pending.formats)[type];
         } catch (cause) {
-          if (this.versions.get(version) === pending) this.versions.delete(version);
+          if (this.versions.get(version2) === pending) this.versions.delete(version2);
           const option = type === "assets" ? "resourcePackFormat" : "dataPackFormat";
           const reason = cause instanceof Error ? cause.message : String(cause);
-          throw new Error(`Could not resolve the pack format for Minecraft ${version}. Set ArchiveAssetSource ${option} explicitly. ${reason}`);
+          throw new Error(`Could not resolve the pack format for Minecraft ${version2}. Set ArchiveAssetSource ${option} explicitly. ${reason}`);
         }
       }
-      static async load(version) {
+      static async load(version2) {
         const response = await Requests.genericRequest({
-          url: `https://assets.mcasset.cloud/${encodeURIComponent(version)}/game-version.json`,
+          url: `https://assets.mcasset.cloud/${encodeURIComponent(version2)}/game-version.json`,
           responseType: "json"
         });
         const data = response.data;
@@ -2437,7 +2437,7 @@ var init_ArchiveAssetSource = __esm({
       }
       async load(key, parser) {
         const path = `${this.assetBasePath(key)}${key.type !== void 0 ? key.type + "/" : ""}${key.path}${key.extension}`;
-        const version = AssetLoader.version;
+        const version2 = AssetLoader.version;
         let selectedPath = path;
         let url;
         try {
@@ -2445,7 +2445,7 @@ var init_ArchiveAssetSource = __esm({
           if (key.rootType === "assets" || key.rootType === "data") {
             const metadata = await this.getMetadata(key);
             if (metadata.hasOverlays) {
-              const format2 = (key.rootType === "assets" ? this.options.resourcePackFormat : this.options.dataPackFormat) ?? await PackFormats.get(version, key.rootType);
+              const format2 = (key.rootType === "assets" ? this.options.resourcePackFormat : this.options.dataPackFormat) ?? await PackFormats.get(version2, key.rootType);
               directories = metadata.overlayDirectories(format2);
             }
           }
@@ -2532,8 +2532,8 @@ var init_AssetLoader = __esm({
         return this.ROOT.substring(this.ROOT.lastIndexOf("/") + 1);
       }
       /** Selects an mcasset.cloud version, updates the vanilla source, and clears in-memory caches. */
-      static setVersion(version) {
-        this.ROOT = `https://assets.mcasset.cloud/${version}`;
+      static setVersion(version2) {
+        this.ROOT = `https://assets.mcasset.cloud/${version2}`;
         const source = new HostedAssetSource(this.ROOT, { retryDefaults: false });
         const index = this._SOURCES.findIndex((s) => s.key === "mcassets");
         if (index !== -1) {
@@ -2598,8 +2598,8 @@ ${key}` : key;
         const sources = [...this._SOURCES];
         const results = [];
         for (const { source } of sources) {
-          const asset = await source.get(key, parser);
-          if (asset != void 0) results.push(asset);
+          const asset2 = await source.get(key, parser);
+          if (asset2 != void 0) results.push(asset2);
           if (await source.blocks(key)) break;
         }
         return results;
@@ -2669,9 +2669,9 @@ var init_ModelTextures = __esm({
         const pending = this.preload(key);
         const cached2 = Caching.textureAssetCache.getIfPresent(keyStr);
         try {
-          const asset = await pending;
-          if (asset) {
-            return await ImageLoader.infoToCanvasData(asset);
+          const asset2 = await pending;
+          if (asset2) {
+            return await ImageLoader.infoToCanvasData(asset2);
           }
           return void 0;
         } catch (err) {
@@ -2685,10 +2685,10 @@ var init_ModelTextures = __esm({
       static async preload(key) {
         const keyStr = key.serialize();
         return Caching.textureAssetCache.get(keyStr, (k) => {
-          return AssetLoader.get(key, "image" /* IMAGE */).then((asset) => {
-            if (asset)
-              asset.key = key;
-            return asset;
+          return AssetLoader.get(key, "image" /* IMAGE */).then((asset2) => {
+            if (asset2)
+              asset2.key = key;
+            return asset2;
           });
         });
       }
@@ -2701,10 +2701,10 @@ var init_ModelTextures = __esm({
         const keyStr = key.serialize();
         return Caching.textureMetaCache.get(keyStr, (k) => {
           return this.PERSISTENT_META_CACHE.getOrLoad(AssetLoader.persistentKey(keyStr), (k1) => {
-            return AssetLoader.get(key, "meta" /* META */).then((asset) => {
-              if (asset)
-                asset.key = key;
-              return asset;
+            return AssetLoader.get(key, "meta" /* META */).then((asset2) => {
+              if (asset2)
+                asset2.key = key;
+              return asset2;
             });
           });
         });
@@ -3258,12 +3258,12 @@ var init_UVMapper = __esm({
             } else {
               uniqueTextureNames.push(textureKey);
               const assetKey = AssetKey.parse("textures", textureValue, model.key);
-              promises.push(ModelTextures.get(assetKey).then((asset) => {
-                if (!asset) {
+              promises.push(ModelTextures.get(assetKey).then((asset2) => {
+                if (!asset2) {
                   console.warn(p5, "Missing texture", assetKey);
                   return;
                 }
-                textureMap[textureKey] = new WrappedImage(asset);
+                textureMap[textureKey] = new WrappedImage(asset2);
               }));
               promises.push(ModelTextures.getMeta(assetKey).then((meta) => {
                 metaMap[textureKey] = meta;
@@ -3607,10 +3607,10 @@ var init_Entities = __esm({
         const collect = async (path) => {
           const prefix2 = path ? `${path}/` : "";
           const key = new AssetKey(DEFAULT_NAMESPACE, `${prefix2}_list`, void 0, void 0, "entity-models", ".json");
-          const list = await Caching.listAssetCache.get(key.serialize(), () => AssetLoader.get(key, "list" /* LIST */));
-          if (!list) return [];
-          const files = list.files.filter((file) => file.endsWith(".json") && file !== "_list.json").map((file) => `${prefix2}${file.slice(0, -5)}`);
-          const children = await Promise.all(list.directories.map((directory) => collect(`${prefix2}${directory}`)));
+          const list2 = await Caching.listAssetCache.get(key.serialize(), () => AssetLoader.get(key, "list" /* LIST */));
+          if (!list2) return [];
+          const files = list2.files.filter((file) => file.endsWith(".json") && file !== "_list.json").map((file) => `${prefix2}${file.slice(0, -5)}`);
+          const children = await Promise.all(list2.directories.map((directory) => collect(`${prefix2}${directory}`)));
           return [...files, ...children.flat()];
         };
         return collect("");
@@ -3694,8 +3694,8 @@ var init_Entities = __esm({
             if (await ModelTextures.get(texture2)) return texture2;
           }
           const listKey = new AssetKey(modelKey.namespace, "_list", `${name}_variant`, void 0, "data", ".json", root);
-          const list = await AssetLoader.get(listKey, "list" /* LIST */);
-          const files = list?.files.filter((file2) => file2.endsWith(".json") && file2 !== "_list.json");
+          const list2 = await AssetLoader.get(listKey, "list" /* LIST */);
+          const files = list2?.files.filter((file2) => file2.endsWith(".json") && file2 !== "_list.json");
           const file = files?.find((file2) => file2 === "temperate.json") ?? files?.[0];
           if (!file) return void 0;
           const variantKey = new AssetKey(modelKey.namespace, file.slice(0, -5), `${name}_variant`, void 0, "data", ".json", root);
@@ -3800,27 +3800,27 @@ var init_EntityAnimationPlayer = __esm({
         for (const layer of layers) {
           const objects = [];
           if (poses) {
-            layer.traverse((object2) => {
-              if (poses.has(object2)) objects.push(object2);
+            layer.traverse((object3) => {
+              if (poses.has(object3)) objects.push(object3);
             });
           } else {
             for (const bone of Object.keys(animation.bones)) {
-              const object2 = layer.getObjectByName(`group:${bone}`);
-              if (object2) objects.push(object2);
+              const object3 = layer.getObjectByName(`group:${bone}`);
+              if (object3) objects.push(object3);
             }
           }
-          for (const object2 of objects) {
-            const bone = object2.name.slice("group:".length);
-            const pose = poses?.get(object2);
+          for (const object3 of objects) {
+            const bone = object3.name.slice("group:".length);
+            const pose = poses?.get(object3);
             this.parts.push({
               bone,
-              object: object2,
-              position: object2.position.clone(),
-              rotation: object2.rotation.clone(),
-              scale: object2.scale.clone(),
-              basePosition: pose ? new import_three11.Vector3(...pose.offset) : object2.position.clone(),
-              baseRotation: pose ? new import_three11.Euler(...pose.rotation, "ZYX") : object2.rotation.clone(),
-              baseScale: pose ? new import_three11.Vector3(...pose.scale ?? [1, 1, 1]) : object2.scale.clone()
+              object: object3,
+              position: object3.position.clone(),
+              rotation: object3.rotation.clone(),
+              scale: object3.scale.clone(),
+              basePosition: pose ? new import_three11.Vector3(...pose.offset) : object3.position.clone(),
+              baseRotation: pose ? new import_three11.Euler(...pose.rotation, "ZYX") : object3.rotation.clone(),
+              baseScale: pose ? new import_three11.Vector3(...pose.scale ?? [1, 1, 1]) : object3.scale.clone()
             });
           }
         }
@@ -4178,10 +4178,10 @@ var init_SceneObject = __esm({
           return new import_three12.InstancedBufferAttribute(array, attribute.itemSize, attribute.normalized, attribute.meshPerAttribute).setUsage(attribute.usage);
         };
         const matrix = grow(mesh.instanceMatrix, 0);
-        const color = mesh.instanceColor ? grow(mesh.instanceColor, 1) : null;
+        const color2 = mesh.instanceColor ? grow(mesh.instanceColor, 1) : null;
         mesh.dispose();
         mesh.instanceMatrix = matrix;
-        mesh.instanceColor = color;
+        mesh.instanceColor = color2;
       }
       *activeInstanceIndices() {
         if (this.instanceMesh) {
@@ -4354,15 +4354,15 @@ var init_SceneObject = __esm({
         }
       }
       //</editor-fold>
-      toggleObjectVisibility(object2, visible) {
-        if (object2) {
+      toggleObjectVisibility(object3, visible) {
+        if (object3) {
           if (typeof visible !== "undefined") {
-            object2.visible = visible;
+            object3.visible = visible;
           } else {
-            object2.visible = !object2.visible;
+            object3.visible = !object3.visible;
           }
           this.notifyDirty();
-          return object2.visible;
+          return object3.visible;
         }
         this.notifyDirty();
         return false;
@@ -4662,8 +4662,8 @@ var init_EntityObject = __esm({
               this.scrollMaterials.push({ material: mat, offset: mat.map.offset, speed: scroll });
             }
           }
-          this.getLayerGroup(name)?.traverse((object2) => {
-            if (isMesh(object2)) object2.material = mat;
+          this.getLayerGroup(name)?.traverse((object3) => {
+            if (isMesh(object3)) object3.material = mat;
           });
         }));
         if (!this.children.length) {
@@ -4993,8 +4993,8 @@ function toTrianglesDrawMode(geometry, drawMode) {
     return geometry;
   }
 }
-function computeMorphedAttributes(object2) {
-  if (object2.geometry.isBufferGeometry !== true) {
+function computeMorphedAttributes(object3) {
+  if (object3.geometry.isBufferGeometry !== true) {
     console.error("THREE.BufferGeometryUtils: Geometry is not of type BufferGeometry.");
     return null;
   }
@@ -5007,11 +5007,11 @@ function computeMorphedAttributes(object2) {
   const _morphA = new import_three22.Vector3();
   const _morphB = new import_three22.Vector3();
   const _morphC = new import_three22.Vector3();
-  function _calculateMorphedAttributeData(object3, material2, attribute, morphAttribute, morphTargetsRelative2, a2, b2, c2, modifiedAttributeArray) {
+  function _calculateMorphedAttributeData(object4, material2, attribute, morphAttribute, morphTargetsRelative2, a2, b2, c2, modifiedAttributeArray) {
     _vA.fromBufferAttribute(attribute, a2);
     _vB.fromBufferAttribute(attribute, b2);
     _vC.fromBufferAttribute(attribute, c2);
-    const morphInfluences = object3.morphTargetInfluences;
+    const morphInfluences = object4.morphTargetInfluences;
     if (material2.morphTargets && morphAttribute && morphInfluences) {
       _morphA.set(0, 0, 0);
       _morphB.set(0, 0, 0);
@@ -5037,10 +5037,10 @@ function computeMorphedAttributes(object2) {
       _vB.add(_morphB);
       _vC.add(_morphC);
     }
-    if (object3.isSkinnedMesh) {
-      object3.boneTransform(a2, _vA);
-      object3.boneTransform(b2, _vB);
-      object3.boneTransform(c2, _vC);
+    if (object4.isSkinnedMesh) {
+      object4.boneTransform(a2, _vA);
+      object4.boneTransform(b2, _vB);
+      object4.boneTransform(c2, _vC);
     }
     modifiedAttributeArray[a2 * 3 + 0] = _vA.x;
     modifiedAttributeArray[a2 * 3 + 1] = _vA.y;
@@ -5052,8 +5052,8 @@ function computeMorphedAttributes(object2) {
     modifiedAttributeArray[c2 * 3 + 1] = _vC.y;
     modifiedAttributeArray[c2 * 3 + 2] = _vC.z;
   }
-  const geometry = object2.geometry;
-  const material = object2.material;
+  const geometry = object3.geometry;
+  const material = object3.material;
   let a, b, c;
   const index = geometry.index;
   const positionAttribute = geometry.attributes.position;
@@ -5080,7 +5080,7 @@ function computeMorphedAttributes(object2) {
           b = index.getX(j + 1);
           c = index.getX(j + 2);
           _calculateMorphedAttributeData(
-            object2,
+            object3,
             groupMaterial,
             positionAttribute,
             morphPosition,
@@ -5091,7 +5091,7 @@ function computeMorphedAttributes(object2) {
             modifiedPosition
           );
           _calculateMorphedAttributeData(
-            object2,
+            object3,
             groupMaterial,
             normalAttribute,
             morphNormal,
@@ -5111,7 +5111,7 @@ function computeMorphedAttributes(object2) {
         b = index.getX(i + 1);
         c = index.getX(i + 2);
         _calculateMorphedAttributeData(
-          object2,
+          object3,
           material,
           positionAttribute,
           morphPosition,
@@ -5122,7 +5122,7 @@ function computeMorphedAttributes(object2) {
           modifiedPosition
         );
         _calculateMorphedAttributeData(
-          object2,
+          object3,
           material,
           normalAttribute,
           morphNormal,
@@ -5146,7 +5146,7 @@ function computeMorphedAttributes(object2) {
           b = j + 1;
           c = j + 2;
           _calculateMorphedAttributeData(
-            object2,
+            object3,
             groupMaterial,
             positionAttribute,
             morphPosition,
@@ -5157,7 +5157,7 @@ function computeMorphedAttributes(object2) {
             modifiedPosition
           );
           _calculateMorphedAttributeData(
-            object2,
+            object3,
             groupMaterial,
             normalAttribute,
             morphNormal,
@@ -5177,7 +5177,7 @@ function computeMorphedAttributes(object2) {
         b = i + 1;
         c = i + 2;
         _calculateMorphedAttributeData(
-          object2,
+          object3,
           material,
           positionAttribute,
           morphPosition,
@@ -5188,7 +5188,7 @@ function computeMorphedAttributes(object2) {
           modifiedPosition
         );
         _calculateMorphedAttributeData(
-          object2,
+          object3,
           material,
           normalAttribute,
           morphNormal,
@@ -5446,9 +5446,9 @@ var init_ItemTints = __esm({
         }));
         return colors;
       }
-      static rgb(color) {
-        if (!Array.isArray(color)) return color & 16777215;
-        const [red, green, blue] = color.map((channel) => Math.floor(Math.fround(Math.fround(channel) * 255)));
+      static rgb(color2) {
+        if (!Array.isArray(color2)) return color2 & 16777215;
+        const [red, green, blue] = color2.map((channel) => Math.floor(Math.fround(Math.fround(channel) * 255)));
         return red << 16 | green << 8 | blue;
       }
     };
@@ -5501,13 +5501,13 @@ var init_ModelObject = __esm({
           transform.multiply(new import_three25.Matrix4().makeTranslation(-8, -8, -8));
           try {
             for (const part of parts) {
-              const object2 = new EntityObject(part.model, { flip: false, wireframe: this.options.wireframe });
-              object2.matrix.copy(transform).multiply(part.transform);
-              object2.matrixWorldNeedsUpdate = true;
-              object2.matrixAutoUpdate = false;
-              this.add(object2);
-              await object2.init();
-              object2.iterateAllMeshes((mesh) => {
+              const object3 = new EntityObject(part.model, { flip: false, wireframe: this.options.wireframe });
+              object3.matrix.copy(transform).multiply(part.transform);
+              object3.matrixWorldNeedsUpdate = true;
+              object3.matrixAutoUpdate = false;
+              this.add(object3);
+              await object3.init();
+              object3.iterateAllMeshes((mesh) => {
                 const source = mesh.material;
                 let material = this.specialMaterials.get(source);
                 if (!material) {
@@ -5518,7 +5518,7 @@ var init_ModelObject = __esm({
                 mesh.material = material;
               });
               for (const [name, rotation] of Object.entries(part.rotations)) {
-                object2.getGroupByName(name)?.rotation.set(...rotation, "ZYX");
+                object3.getGroupByName(name)?.rotation.set(...rotation, "ZYX");
               }
             }
           } catch (error) {
@@ -5571,9 +5571,9 @@ var init_ModelObject = __esm({
                   if (tintIndex === void 0 || tintIndex < 0) continue;
                   const tint = this.options.tints[tintIndex];
                   if (tint === void 0) continue;
-                  const color = new import_three25.Color(tint);
+                  const color2 = new import_three25.Color(tint);
                   for (let vertex = 0; vertex < 4; vertex++) {
-                    color.toArray(colors, (faceIndex * 4 + vertex) * 3);
+                    color2.toArray(colors, (faceIndex * 4 + vertex) * 3);
                   }
                 }
                 elGeo.setAttribute("color", new import_three25.BufferAttribute(colors, 3));
@@ -5890,9 +5890,9 @@ var init_FluidModelObject = __esm({
           }
         }
         geometry.clearGroups();
-        const color = new import_three31.Color(this.options.tints?.[0] ?? (this.kind === "water" ? 4159204 : 16777215));
+        const color2 = new import_three31.Color(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) color.toArray(colors, i);
+        for (let i = 0; i < colors.length; i += 3) color2.toArray(colors, i);
         geometry.setAttribute("color", new import_three31.BufferAttribute(colors, 3));
         geometry.computeBoundingBox();
         geometry.computeBoundingSphere();
@@ -5970,6 +5970,7 @@ __export(index_browser_exports, {
   Env: () => Env,
   FluidModelObject: () => FluidModelObject,
   Fonts: () => Fonts,
+  GUI_CONTAINER_LAYOUTS: () => GUI_CONTAINER_LAYOUTS,
   Geometries: () => Geometries,
   GuiHelper: () => GuiHelper,
   GuiLight: () => GuiLight,
@@ -6003,6 +6004,7 @@ __export(index_browser_exports, {
   RequestError: () => RequestError,
   Requests: () => Requests,
   SKIN_PARTS: () => SKIN_PARTS,
+  SceneDocumentLoader: () => SceneDocumentLoader,
   SceneExporter: () => SceneExporter,
   SceneInspector: () => SceneInspector,
   SceneObject: () => SceneObject,
@@ -6078,6 +6080,7 @@ __export(index_browser_exports, {
   mergeBufferAttributes: () => mergeBufferAttributes,
   mergeBufferGeometries: () => mergeBufferGeometries,
   mergeVertices: () => mergeVertices,
+  parseSceneDocument: () => parseSceneDocument,
   prefix: () => prefix,
   probeImageSize: () => probeImageSize,
   registerBrowserEnv: () => registerBrowserEnv,
@@ -6206,11 +6209,11 @@ var BrowserEnv = class {
   imageSize(data) {
     return probeImageSize(data);
   }
-  openCache(name, version) {
+  openCache(name, version2) {
     return new BrowserCache(import_localforage.default.createInstance({
       // IndexedDB schema upgrades retain records; each cache generation needs its own database.
-      name: name + version,
-      version
+      name: name + version2,
+      version: version2
     }));
   }
 };
@@ -6370,8 +6373,8 @@ var Fonts = class {
     const stack = await AssetLoader.getAll(key, "json" /* JSON */);
     if (stack.length === 0) throw new Error(`Could not load font ${key.toNamespacedString()}`);
     const glyphs = /* @__PURE__ */ new Map();
-    for (const asset of stack) {
-      for (const provider of asset.providers) {
+    for (const asset2 of stack) {
+      for (const provider of asset2.providers) {
         if (provider.filter?.uniform || provider.filter?.jp) continue;
         let provided;
         switch (provider.type) {
@@ -6510,13 +6513,13 @@ var OBJExporter = class {
    * @param {Object3D} object - The 3D object to export.
    * @return {string} The exported OBJ.
    */
-  parse(object2) {
+  parse(object3) {
     let output = "";
     let indexVertex = 0;
     let indexVertexUvs = 0;
     let indexNormals = 0;
     const vertex = new import_three16.Vector3();
-    const color = new import_three16.Color();
+    const color2 = new import_three16.Color();
     const normal = new import_three16.Vector3();
     const uv = new import_three16.Vector2();
     const face = [];
@@ -6615,9 +6618,9 @@ var OBJExporter = class {
           vertex.applyMatrix4(points.matrixWorld);
           output += "v " + vertex.x + " " + vertex.y + " " + vertex.z;
           if (colors !== void 0) {
-            color.fromBufferAttribute(colors, i);
-            import_three16.ColorManagement.workingToColorSpace(color, import_three16.SRGBColorSpace);
-            output += " " + color.r + " " + color.g + " " + color.b;
+            color2.fromBufferAttribute(colors, i);
+            import_three16.ColorManagement.workingToColorSpace(color2, import_three16.SRGBColorSpace);
+            output += " " + color2.r + " " + color2.g + " " + color2.b;
           }
           output += "\n";
         }
@@ -6629,7 +6632,7 @@ var OBJExporter = class {
       }
       indexVertex += nbVertex;
     }
-    object2.traverse(function(child) {
+    object3.traverse(function(child) {
       if (child.isMesh === true) {
         parseMesh(child);
       }
@@ -6657,9 +6660,9 @@ var PLYExporter = class {
    * @param {PLYExporter~Options} options - The export options.
    * @return {?(string|ArrayBuffer)} The exported PLY.
    */
-  parse(object2, onDone, options = {}) {
+  parse(object3, onDone, options = {}) {
     function traverseMeshes(cb) {
-      object2.traverse(function(child) {
+      object3.traverse(function(child) {
         if (child.isMesh === true || child.isPoints) {
           const mesh = child;
           const geometry = mesh.geometry;
@@ -6692,7 +6695,7 @@ var PLYExporter = class {
     for (const name of customAttributeNames) customTypes[name] = "float";
     let vertexCount = 0;
     let faceCount = 0;
-    object2.traverse(function(child) {
+    object3.traverse(function(child) {
       if (child.isMesh === true) {
         const mesh = child;
         const geometry = mesh.geometry;
@@ -7286,8 +7289,8 @@ function equalArray(array1, array2) {
     return element === array2[index];
   });
 }
-function stringToArrayBuffer(text) {
-  return new TextEncoder().encode(text).buffer;
+function stringToArrayBuffer(text2) {
+  return new TextEncoder().encode(text2).buffer;
 }
 function isIdentityMatrix(matrix) {
   return equalArray(matrix.elements, [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
@@ -7480,12 +7483,12 @@ var GLTFWriter = class {
    * @param {THREE.Object3D|THREE.Material|THREE.BufferGeometry|THREE.AnimationClip} object
    * @param {Object} objectDef
    */
-  serializeUserData(object2, objectDef) {
-    if (Object.keys(object2.userData).length === 0) return;
+  serializeUserData(object3, objectDef) {
+    if (Object.keys(object3.userData).length === 0) return;
     const options = this.options;
     const extensionsUsed = this.extensionsUsed;
     try {
-      const json = JSON.parse(JSON.stringify(object2.userData));
+      const json = JSON.parse(JSON.stringify(object3.userData));
       if (options.includeCustomExtensions && json.gltfExtensions) {
         if (objectDef.extensions === void 0) objectDef.extensions = {};
         for (const extensionName in json.gltfExtensions) {
@@ -7496,7 +7499,7 @@ var GLTFWriter = class {
       }
       if (Object.keys(json).length > 0) objectDef.extras = json;
     } catch (error) {
-      console.warn("THREE.GLTFExporter: userData of '" + object2.name + "' won't be serialized because of JSON.stringify error - " + error.message);
+      console.warn("THREE.GLTFExporter: userData of '" + object3.name + "' won't be serialized because of JSON.stringify error - " + error.message);
     }
   }
   /**
@@ -8005,9 +8008,9 @@ var GLTFWriter = class {
     if (material.isMeshStandardMaterial !== true && material.isMeshBasicMaterial !== true) {
       console.warn("GLTFExporter: Use MeshStandardMaterial or MeshBasicMaterial for best results.");
     }
-    const color = material.color.toArray().concat([material.opacity]);
-    if (!equalArray(color, [1, 1, 1, 1])) {
-      materialDef.pbrMetallicRoughness.baseColorFactor = color;
+    const color2 = material.color.toArray().concat([material.opacity]);
+    if (!equalArray(color2, [1, 1, 1, 1])) {
+      materialDef.pbrMetallicRoughness.baseColorFactor = color2;
     }
     if (material.isMeshStandardMaterial) {
       materialDef.pbrMetallicRoughness.metallicFactor = material.metalness;
@@ -8422,13 +8425,13 @@ var GLTFWriter = class {
    * @param {THREE.Object3D} object
    * @return {?number}
    */
-  processSkin(object2) {
+  processSkin(object3) {
     const json = this.json;
     const nodeMap = this.nodeMap;
-    const node = json.nodes[nodeMap.get(object2)];
-    const skeleton = object2.skeleton;
+    const node = json.nodes[nodeMap.get(object3)];
+    const skeleton = object3.skeleton;
     if (skeleton === void 0) return null;
-    const rootJoint = object2.skeleton.bones[0];
+    const rootJoint = object3.skeleton.bones[0];
     if (rootJoint === void 0) return null;
     const joints = [];
     const inverseBindMatrices = new Float32Array(skeleton.bones.length * 16);
@@ -8436,7 +8439,7 @@ var GLTFWriter = class {
     for (let i = 0; i < skeleton.bones.length; ++i) {
       joints.push(nodeMap.get(skeleton.bones[i]));
       temporaryBoneInverse.copy(skeleton.boneInverses[i]);
-      temporaryBoneInverse.multiply(object2.bindMatrix).toArray(inverseBindMatrices, i * 16);
+      temporaryBoneInverse.multiply(object3.bindMatrix).toArray(inverseBindMatrices, i * 16);
     }
     if (json.skins === void 0) json.skins = [];
     json.skins.push({
@@ -8452,19 +8455,19 @@ var GLTFWriter = class {
    * @param {THREE.Object3D} object Object3D to processNodeAsync
    * @return {Promise<number>} Index of the node in the nodes list
    */
-  async processNodeAsync(object2) {
+  async processNodeAsync(object3) {
     const json = this.json;
     const options = this.options;
     const nodeMap = this.nodeMap;
     if (!json.nodes) json.nodes = [];
-    if (object2.pivot !== null) {
-      return await this._processNodeWithPivotAsync(object2);
+    if (object3.pivot !== null) {
+      return await this._processNodeWithPivotAsync(object3);
     }
     const nodeDef = {};
     if (options.trs) {
-      const rotation = object2.quaternion.toArray();
-      const position = object2.position.toArray();
-      const scale = object2.scale.toArray();
+      const rotation = object3.quaternion.toArray();
+      const position = object3.position.toArray();
+      const scale = object3.scale.toArray();
       if (!equalArray(rotation, [0, 0, 0, 1])) {
         nodeDef.rotation = rotation;
       }
@@ -8475,28 +8478,28 @@ var GLTFWriter = class {
         nodeDef.scale = scale;
       }
     } else {
-      if (object2.matrixAutoUpdate) {
-        object2.updateMatrix();
+      if (object3.matrixAutoUpdate) {
+        object3.updateMatrix();
       }
-      if (isIdentityMatrix(object2.matrix) === false) {
-        nodeDef.matrix = object2.matrix.elements;
+      if (isIdentityMatrix(object3.matrix) === false) {
+        nodeDef.matrix = object3.matrix.elements;
       }
     }
-    if (object2.name !== "") nodeDef.name = String(object2.name);
-    this.serializeUserData(object2, nodeDef);
-    if (object2.isMesh || object2.isLine || object2.isPoints) {
-      const meshIndex = await this.processMeshAsync(object2);
+    if (object3.name !== "") nodeDef.name = String(object3.name);
+    this.serializeUserData(object3, nodeDef);
+    if (object3.isMesh || object3.isLine || object3.isPoints) {
+      const meshIndex = await this.processMeshAsync(object3);
       if (meshIndex !== null) nodeDef.mesh = meshIndex;
-    } else if (object2.isCamera) {
-      nodeDef.camera = this.processCamera(object2);
+    } else if (object3.isCamera) {
+      nodeDef.camera = this.processCamera(object3);
     }
-    if (object2.isSkinnedMesh) this.skins.push(object2);
+    if (object3.isSkinnedMesh) this.skins.push(object3);
     const nodeIndex = json.nodes.push(nodeDef) - 1;
-    nodeMap.set(object2, nodeIndex);
-    if (object2.children.length > 0) {
+    nodeMap.set(object3, nodeIndex);
+    if (object3.children.length > 0) {
       const children = [];
-      for (let i = 0, l = object2.children.length; i < l; i++) {
-        const child = object2.children[i];
+      for (let i = 0, l = object3.children.length; i < l; i++) {
+        const child = object3.children[i];
         if (child.visible || options.onlyVisible === false) {
           const childNodeIndex = await this.processNodeAsync(child);
           if (childNodeIndex !== null) children.push(childNodeIndex);
@@ -8505,7 +8508,7 @@ var GLTFWriter = class {
       if (children.length > 0) nodeDef.children = children;
     }
     await this._invokeAllAsync(function(ext) {
-      ext.writeNode && ext.writeNode(object2, nodeDef);
+      ext.writeNode && ext.writeNode(object3, nodeDef);
     });
     return nodeIndex;
   }
@@ -8514,19 +8517,19 @@ var GLTFWriter = class {
    * @param {THREE.Object3D} object Object3D with pivot
    * @return {Promise<number>} Index of the container node
    */
-  async _processNodeWithPivotAsync(object2) {
+  async _processNodeWithPivotAsync(object3) {
     const json = this.json;
     const options = this.options;
     const nodeMap = this.nodeMap;
-    const pivot = object2.pivot;
+    const pivot = object3.pivot;
     const containerDef = {};
-    const rotation = object2.quaternion.toArray();
+    const rotation = object3.quaternion.toArray();
     const position = [
-      object2.position.x + pivot.x,
-      object2.position.y + pivot.y,
-      object2.position.z + pivot.z
+      object3.position.x + pivot.x,
+      object3.position.y + pivot.y,
+      object3.position.z + pivot.z
     ];
-    const scale = object2.scale.toArray();
+    const scale = object3.scale.toArray();
     if (!equalArray(rotation, [0, 0, 0, 1])) {
       containerDef.rotation = rotation;
     }
@@ -8537,28 +8540,28 @@ var GLTFWriter = class {
       containerDef.scale = scale;
     }
     containerDef.extras = { pivot: pivot.toArray() };
-    if (object2.name !== "") containerDef.name = String(object2.name);
-    this.serializeUserData(object2, containerDef);
+    if (object3.name !== "") containerDef.name = String(object3.name);
+    this.serializeUserData(object3, containerDef);
     const containerIndex = json.nodes.push(containerDef) - 1;
-    nodeMap.set(object2, containerIndex);
+    nodeMap.set(object3, containerIndex);
     const childDef = {};
     const childPosition = [-pivot.x, -pivot.y, -pivot.z];
     if (!equalArray(childPosition, [0, 0, 0])) {
       childDef.translation = childPosition;
     }
-    if (object2.isMesh || object2.isLine || object2.isPoints) {
-      const meshIndex = await this.processMeshAsync(object2);
+    if (object3.isMesh || object3.isLine || object3.isPoints) {
+      const meshIndex = await this.processMeshAsync(object3);
       if (meshIndex !== null) childDef.mesh = meshIndex;
-    } else if (object2.isCamera) {
-      childDef.camera = this.processCamera(object2);
+    } else if (object3.isCamera) {
+      childDef.camera = this.processCamera(object3);
     }
-    if (object2.isSkinnedMesh) this.skins.push(object2);
+    if (object3.isSkinnedMesh) this.skins.push(object3);
     const childIndex = json.nodes.push(childDef) - 1;
     const containerChildren = [childIndex];
-    if (object2.children.length > 0) {
+    if (object3.children.length > 0) {
       const grandchildren = [];
-      for (let i = 0, l = object2.children.length; i < l; i++) {
-        const child = object2.children[i];
+      for (let i = 0, l = object3.children.length; i < l; i++) {
+        const child = object3.children[i];
         if (child.visible || options.onlyVisible === false) {
           const childNodeIndex = await this.processNodeAsync(child);
           if (childNodeIndex !== null) grandchildren.push(childNodeIndex);
@@ -8568,7 +8571,7 @@ var GLTFWriter = class {
     }
     containerDef.children = containerChildren;
     await this._invokeAllAsync(function(ext) {
-      ext.writeNode && ext.writeNode(object2, containerDef);
+      ext.writeNode && ext.writeNode(object3, containerDef);
     });
     return containerIndex;
   }
@@ -9011,10 +9014,10 @@ var GLTFMeshGpuInstancing = class {
     this.writer = writer;
     this.name = "EXT_mesh_gpu_instancing";
   }
-  writeNode(object2, nodeDef) {
-    if (!object2.isInstancedMesh) return;
+  writeNode(object3, nodeDef) {
+    if (!object3.isInstancedMesh) return;
     const writer = this.writer;
-    const mesh = object2;
+    const mesh = object3;
     const translationAttr = new Float32Array(mesh.count * 3);
     const rotationAttr = new Float32Array(mesh.count * 4);
     const scaleAttr = new Float32Array(mesh.count * 3);
@@ -9204,8 +9207,8 @@ var SceneExporter = class {
     }
   }
 };
-function localMatrix(object2) {
-  return object2.matrixAutoUpdate ? new import_three19.Matrix4().compose(object2.position, object2.quaternion, object2.scale) : object2.matrix.clone();
+function localMatrix(object3) {
+  return object3.matrixAutoUpdate ? new import_three19.Matrix4().compose(object3.position, object3.quaternion, object3.scale) : object3.matrix.clone();
 }
 function createSnapshot(root, gltf, bakeColors = false) {
   const scene = new import_three19.Scene();
@@ -9309,24 +9312,24 @@ function createSnapshot(root, gltf, bakeColors = false) {
       scene.add(copy);
     }
   };
-  const visit = (object2, parentWorld) => {
-    if (!object2.visible) return;
-    const world = parentWorld.clone().multiply(localMatrix(object2));
-    const mesh = object2;
+  const visit = (object3, parentWorld) => {
+    if (!object3.visible) return;
+    const world = parentWorld.clone().multiply(localMatrix(object3));
+    const mesh = object3;
     if (mesh.isMesh) {
       const instanced = mesh;
       if (instanced.isInstancedMesh) {
         for (let i = 0; i < instanced.count; i++) {
           const matrix = new import_three19.Matrix4();
           instanced.getMatrixAt(i, matrix);
-          const color = instanced.instanceColor ? new import_three19.Color().fromBufferAttribute(instanced.instanceColor, i) : void 0;
-          addMesh(mesh, world.clone().multiply(matrix), color);
+          const color2 = instanced.instanceColor ? new import_three19.Color().fromBufferAttribute(instanced.instanceColor, i) : void 0;
+          addMesh(mesh, world.clone().multiply(matrix), color2);
         }
       } else {
         addMesh(mesh, world);
       }
     }
-    for (const child of object2.children) visit(child, world);
+    for (const child of object3.children) visit(child, world);
   };
   try {
     const ancestors = [];
@@ -9399,16 +9402,17 @@ function copyDataTexture(source) {
 
 // src/gui/GuiHelper.ts
 init_AssetKey();
+init_ModelTextures();
 
 // src/gui/GuiText.ts
 var import_three20 = require("three");
-async function layoutGuiText(text, options = {}) {
+async function layoutGuiText(text2, options = {}) {
   const maxWidth = options.maxWidth ?? Infinity, lineHeight = options.lineHeight ?? 9;
   if (!(maxWidth > 0) || !Number.isFinite(lineHeight) || lineHeight <= 0) {
     throw new Error("Text wrap width and line height must be positive");
   }
   const font = await Fonts.get(options.font);
-  const runs = typeof text === "string" ? [{ text }] : text;
+  const runs = typeof text2 === "string" ? [{ text: text2 }] : text2;
   const glyphs = [], lineWidths = [];
   let line = [], width = 0;
   let trailingNewline = false;
@@ -9462,7 +9466,7 @@ function createGuiTextGeometry(layout, shadow = true) {
         batch = { image: glyph?.image, positions: [], uvs: [], colors: [], indices: [] };
         batches.push(batch);
       }
-      const color = new import_three20.Color(isShadow ? (style.color & 16579836) >> 2 : style.color);
+      const color2 = new import_three20.Color(isShadow ? (style.color & 16579836) >> 2 : style.color);
       const offset = isShadow ? 1 : 0;
       const top = glyph ? 7 - glyph.ascent : 0;
       const height = glyph ? glyph.height * glyph.scale : 8;
@@ -9490,7 +9494,7 @@ function createGuiTextGeometry(layout, shadow = true) {
         const v0 = glyph ? 1 - glyph.y / glyph.image.height : 1;
         const v1 = glyph ? 1 - (glyph.y + glyph.height) / glyph.image.height : 0;
         batch.uvs.push(u0, v0, u1, v0, u0, v1, u1, v1);
-        for (let i = 0; i < 4; i++) batch.colors.push(color.r, color.g, color.b);
+        for (let i = 0; i < 4; i++) batch.colors.push(color2.r, color2.g, color2.b);
         batch.indices.push(base, base + 2, base + 1, base + 2, base + 3, base + 1);
       };
       for (const boldOffset of style.bold ? [0, 1] : [0]) {
@@ -9508,7 +9512,128 @@ function createGuiTextGeometry(layout, shadow = true) {
 }
 
 // src/gui/GuiHelper.ts
+var GUI_CONTAINER_LAYOUTS = {
+  generic_54: {
+    texture: "minecraft:gui/container/generic_54",
+    crop: [0, 0, 176, 222],
+    slotOrigin: [8, 18],
+    slotOffset: [18, 18],
+    rowSize: 9,
+    slotCount: 54
+  },
+  crafting_table: {
+    texture: "minecraft:gui/container/crafting_table",
+    crop: [0, 0, 176, 166],
+    slotOrigin: [30, 17],
+    slotOffset: [18, 18],
+    rowSize: 3,
+    slotCount: 9,
+    resultPosition: [124, 35]
+  }
+};
 var GuiHelper = class {
+  /**
+   * Creates a 182×5 boss bar using the active resource pack. Finite progress is clamped to 0–1.
+   * The fill crops the source image; explicit crops do not apply `.mcmeta` sprite scaling.
+   */
+  static async bossBar(options = {}) {
+    const { color: color2 = "pink", progress = 1, position = [0, 0] } = options;
+    this.validatePosition(position);
+    if (!["pink", "blue", "red", "green", "yellow", "purple", "white"].includes(color2)) {
+      throw new Error(`Unsupported boss bar color: ${color2}`);
+    }
+    if (!Number.isFinite(progress)) throw new Error("Boss bar progress must be finite");
+    const value = Math.max(0, Math.min(1, progress));
+    const width = value > 0 ? Math.floor(value * 181) + 1 : 0;
+    const texture = `minecraft:gui/sprites/boss_bar/${color2}`;
+    const layers = [{
+      name: "boss-bar-background",
+      texture: `${texture}_background`,
+      position: [...position],
+      size: [182, 5]
+    }];
+    if (width > 0) {
+      layers.push({
+        ...await this.cropTexture(`${texture}_progress`, [0, 0, width, 5], [182, 5], position),
+        name: "boss-bar-progress"
+      });
+    }
+    return layers;
+  }
+  /**
+   * Creates a 192×192 book page with optional arrows and supplied text. Buttons are hidden by default.
+   * Callers choose the page content and button states; this helper does not paginate or handle clicks.
+   */
+  static async book(options = {}) {
+    const {
+      position = [0, 0],
+      previous = "hidden",
+      next = "hidden",
+      text: text2,
+      color: color2 = 0,
+      shadow = false,
+      maxWidth = 114,
+      lineHeight = 9,
+      ...style
+    } = options;
+    this.validatePosition(position);
+    for (const state of [previous, next]) {
+      if (!["hidden", "normal", "hover"].includes(state)) throw new Error(`Unsupported book button state: ${state}`);
+    }
+    const layers = [{
+      ...await this.cropTexture("minecraft:gui/book", [0, 0, 192, 192], [256, 256], position),
+      name: "book-background"
+    }];
+    for (const [name, direction, state, x] of [
+      ["previous", "backward", previous, 43],
+      ["next", "forward", next, 116]
+    ]) {
+      if (state === "hidden") continue;
+      layers.push({
+        name: `book-${name}`,
+        texture: `minecraft:gui/sprites/widget/page_${direction}${state === "hover" ? "_highlighted" : ""}`,
+        position: [position[0] + x, position[1] + 157],
+        size: [23, 13]
+      });
+    }
+    if (text2 !== void 0) {
+      layers.push({
+        name: "book-text",
+        text: text2,
+        position: [position[0] + 36, position[1] + 30],
+        color: color2,
+        shadow,
+        maxWidth,
+        lineHeight,
+        ...style
+      });
+    }
+    return layers;
+  }
+  /** Creates a container background. Use {@link GUI_CONTAINER_LAYOUTS} with {@link inventorySlot} to place its items. */
+  static async container(type, position = [0, 0]) {
+    this.validatePosition(position);
+    if (type !== "generic_54" && type !== "crafting_table") throw new Error(`Unsupported GUI container: ${type}`);
+    const layout = GUI_CONTAINER_LAYOUTS[type];
+    return [{ ...await this.cropTexture(layout.texture, layout.crop, [256, 256], position), name: "background" }];
+  }
+  static validatePosition(position) {
+    if (!Array.isArray(position) || position.length !== 2 || !position.every(Number.isFinite)) {
+      throw new Error("GUI position must contain two finite coordinates");
+    }
+  }
+  static async cropTexture(texture, crop, referenceSize, position) {
+    const image = await ModelTextures.preload(AssetKey.parse("textures", texture));
+    if (!image) throw new Error(`Could not load GUI texture ${texture}`);
+    const [x, y, width, height] = crop;
+    const scaleX = image.width / referenceSize[0], scaleY = image.height / referenceSize[1];
+    return {
+      texture,
+      crop: [x * scaleX, y * scaleY, width * scaleX, height * scaleY],
+      position: [...position],
+      size: [width, height]
+    };
+  }
   /** Sizes a tooltip around supplied text; the first entry is its title. */
   static async tooltip(lines, options = {}) {
     if (!lines.length) return [];
@@ -9524,8 +9649,8 @@ var GuiHelper = class {
       size: [width + 24, height + 24]
     }));
     let y = position[1];
-    lines.forEach((text, index) => {
-      layers.push({ ...textOptions, name: `tooltip-line-${index}`, text, position: [position[0], y] });
+    lines.forEach((text2, index) => {
+      layers.push({ ...textOptions, name: `tooltip-line-${index}`, text: text2, position: [position[0], y] });
       y += layouts[index].height + (index === 0 ? titleGap : 0);
     });
     return layers;
@@ -9543,8 +9668,9 @@ var GuiHelper = class {
   }
   /** Creates crafting-table layers for ingredients and the result; stack counts are not drawn. */
   static recipe(recipe, options = {}) {
+    const layout = GUI_CONTAINER_LAYOUTS.crafting_table;
     const layers = [
-      { name: "background", texture: "minecraft:gui/container/crafting_table", crop: [0, 0, 176, 166] }
+      { name: "background", texture: layout.texture, crop: [...layout.crop] }
     ];
     const itemKey = (ingredient) => {
       const item = typeof ingredient === "string" && !ingredient.startsWith("#") ? ingredient : typeof ingredient === "object" && "item" in ingredient ? ingredient.item : options.resolveIngredient?.(ingredient);
@@ -9559,7 +9685,7 @@ var GuiHelper = class {
       layers.push({
         name: `ingredient-${slot}`,
         item: itemKey(ingredient),
-        position: this.inventorySlot(slot, [30, 17], [18, 18], 3)
+        position: this.inventorySlot(slot, layout.slotOrigin, layout.slotOffset, layout.rowSize)
       });
     };
     switch (recipe.type) {
@@ -9594,7 +9720,7 @@ var GuiHelper = class {
     layers.push({
       name: "result",
       item: itemKey("id" in recipe.result ? recipe.result.id : recipe.result.item),
-      position: [124, 35]
+      position: [...layout.resultPosition]
     });
     return layers;
   }
@@ -9981,29 +10107,29 @@ var SceneInspector = class {
     this.objectControlsContainer.innerHTML = "";
     this.addControls(targetObject, targetIntersection, instance);
   }
-  addControls(object2, intersection, instance) {
+  addControls(object3, intersection, instance) {
     const container = document.createElement("div");
     container.append(this.separator("Select Parent/Child"));
-    if (object2.parent) {
-      container.append(this.buttonControl("Select Parent " + object2.parent.constructor.name + " " + object2.parent.name, "P", () => {
-        this.selectObject(object2.parent, intersection, instance);
+    if (object3.parent) {
+      container.append(this.buttonControl("Select Parent " + object3.parent.constructor.name + " " + object3.parent.name, "P", () => {
+        this.selectObject(object3.parent, intersection, instance);
       }));
     }
-    if (object2.children.length > 0) {
+    if (object3.children.length > 0) {
       let i = 1;
-      for (let child of object2.children) {
+      for (let child of object3.children) {
         container.append(this.buttonControl("Select Child " + child.constructor.name + " " + child.name, "C" + i++, () => {
           this.selectObject(child, intersection, instance);
         }));
       }
     }
     container.append(this.separator());
-    const selectedInstance = instance && (object2 === instance.instanceable || object2 === intersection?.object) ? instance : void 0;
+    const selectedInstance = instance && (object3 === instance.instanceable || object3 === intersection?.object) ? instance : void 0;
     if (!selectedInstance) {
-      container.append(this.toggleControl("Visibility", "V", object2.visible, (v) => object2.visible = v));
+      container.append(this.toggleControl("Visibility", "V", object3.visible, (v) => object3.visible = v));
     }
     container.append(this.separator("Mesh"));
-    this.addObjectControls(object2, intersection, container, selectedInstance);
+    this.addObjectControls(object3, intersection, container, selectedInstance);
     container.append(this.separator());
     this.objectControlsContainer.append(container);
   }
@@ -10419,29 +10545,29 @@ var BlockTints = class {
       }
     }
     if (!indices.size) return tints;
-    let color;
+    let color2;
     switch (rule.source) {
       case "constant":
-        color = rule.color;
+        color2 = rule.color;
         break;
       case "grass":
-        color = await Colormaps.grassColor(key);
+        color2 = await Colormaps.grassColor(key);
         break;
       case "redstone": {
         const power = Number(state.power ?? 0) / 15;
         const red = power * 0.6 + (power > 0 ? 0.4 : 0.3);
         const green = Math.max(0, power * power * 0.7 - 0.5);
         const blue = Math.max(0, power * power * 0.6 - 0.7);
-        color = Math.floor(red * 255) << 16 | Math.floor(green * 255) << 8 | Math.floor(blue * 255);
+        color2 = Math.floor(red * 255) << 16 | Math.floor(green * 255) << 8 | Math.floor(blue * 255);
         break;
       }
       case "stem": {
         const age = Number(state.age ?? 0);
-        color = age * 32 << 16 | 255 - age * 8 << 8 | age * 4;
+        color2 = age * 32 << 16 | 255 - age * 8 << 8 | age * 4;
         break;
       }
     }
-    return { ...Object.fromEntries([...indices].map((index) => [index, color])), ...tints };
+    return { ...Object.fromEntries([...indices].map((index) => [index, color2])), ...tints };
   }
 };
 
@@ -10578,8 +10704,8 @@ var _BlockObject = class _BlockObject extends SceneObject {
       return false;
     }
     return this._models.some((model) => {
-      const object2 = isInstanceReference(model) ? model.instanceable : model;
-      return object2.isOpaqueFullCube && this.getModelCullMask(model, 63) === 63;
+      const object3 = isInstanceReference(model) ? model.instanceable : model;
+      return object3.isOpaqueFullCube && this.getModelCullMask(model, 63) === 63;
     });
   }
   getModelMatrix(model) {
@@ -10588,8 +10714,8 @@ var _BlockObject = class _BlockObject extends SceneObject {
     return model.matrix.clone();
   }
   getModelCullMask(model, worldMask) {
-    const object2 = isInstanceReference(model) ? model.instanceable : model;
-    if (object2.options.displayPosition) return 0;
+    const object3 = isInstanceReference(model) ? model.instanceable : model;
+    if (object3.options.displayPosition) return 0;
     const position = new import_three32.Vector3();
     const rotation = new import_three32.Quaternion();
     const scale = new import_three32.Vector3();
@@ -10606,14 +10732,14 @@ var _BlockObject = class _BlockObject extends SceneObject {
           replacements.push(model);
           continue;
         }
-        const object2 = isInstanceReference(model) ? model.instanceable : model;
+        const object3 = isInstanceReference(model) ? model.instanceable : model;
         const cullMask = this.getModelCullMask(model, worldMask);
-        if (cullMask === (object2.options.cullMask ?? 0)) {
+        if (cullMask === (object3.options.cullMask ?? 0)) {
           replacements.push(model);
           continue;
         }
         const matrix = this.getModelMatrix(model);
-        const replacement = await this.scene.addModel(object2.originalModel, { ...object2.options, cullMask });
+        const replacement = await this.scene.addModel(object3.originalModel, { ...object3.options, cullMask });
         replacements.push(replacement);
         if (isInstanceReference(replacement)) {
           replacement.setMatrix(matrix);
@@ -10621,8 +10747,8 @@ var _BlockObject = class _BlockObject extends SceneObject {
           replacement.matrix.copy(matrix);
           replacement.matrixWorldNeedsUpdate = true;
           matrix.decompose(replacement.position, replacement.quaternion, replacement.scale);
-          replacement.matrixAutoUpdate = object2.matrixAutoUpdate;
-          replacement.visible = object2.visible;
+          replacement.matrixAutoUpdate = object3.matrixAutoUpdate;
+          replacement.visible = object3.visible;
         }
       }
     } catch (error) {
@@ -13770,60 +13896,60 @@ var _MineRenderScene = class _MineRenderScene extends import_three34.Scene {
     this.options = (0, import_ts_deepmerge8.default)({}, _MineRenderScene.DEFAULT_OPTIONS, options ?? {});
   }
   add(...objects) {
-    for (const object2 of objects) {
+    for (const object3 of objects) {
       this.dirty = true;
       try {
-        super.add(object2);
+        super.add(object3);
       } finally {
-        if (object2?.isObject3D && object2 !== this) {
-          this.updateObjectRegistration(object2, object2.parent === this);
+        if (object3?.isObject3D && object3 !== this) {
+          this.updateObjectRegistration(object3, object3.parent === this);
         }
       }
     }
     return this;
   }
   remove(...objects) {
-    for (const object2 of objects) {
-      if (!this.children.includes(object2)) continue;
+    for (const object3 of objects) {
+      if (!this.children.includes(object3)) continue;
       this.dirty = true;
-      this.updateObjectRegistration(object2, false);
+      this.updateObjectRegistration(object3, false);
       try {
-        super.remove(object2);
+        super.remove(object3);
       } finally {
-        this.updateObjectRegistration(object2, object2.parent === this);
+        this.updateObjectRegistration(object3, object3.parent === this);
       }
     }
     return this;
   }
-  updateObjectRegistration(object2, attached) {
-    if (this.observedObjects.has(object2) === attached) return;
-    const observable = object2;
+  updateObjectRegistration(object3, attached) {
+    if (this.observedObjects.has(object3) === attached) return;
+    const observable = object3;
     if (attached) {
-      this.observedObjects.add(object2);
+      this.observedObjects.add(object3);
       observable.addEventListener("change", this.onObjectChange);
     } else {
-      this.observedObjects.delete(object2);
+      this.observedObjects.delete(object3);
       observable.removeEventListener("change", this.onObjectChange);
     }
     const change = attached ? 1 : -1;
     this.stats.objectCount += change;
-    if (isSceneObject(object2)) {
+    if (isSceneObject(object3)) {
       this.stats.sceneObjectCount += change;
     }
   }
   /** Initializes each object before attaching it to the scene. */
-  async initAndAdd(...object2) {
+  async initAndAdd(...object3) {
     this.dirty = true;
-    for (let obj of object2) {
+    for (let obj of object3) {
       await obj.init();
     }
-    return this.add(...object2);
+    return this.add(...object3);
   }
-  async addSceneObject(asset, objectSupplier, _options, parent = this) {
+  async addSceneObject(asset2, objectSupplier, _options, parent = this) {
     this.dirty = true;
     const obj = await objectSupplier();
-    if (obj?.options?.instanceMeshes && asset.key && asset.key?.assetType === "models") {
-      let key = asset.key.serialize();
+    if (obj?.options?.instanceMeshes && asset2.key && asset2.key?.assetType === "models") {
+      let key = asset2.key.serialize();
       if (isModelObject(obj)) {
         const { displayPosition, uvLockRotation, tints, cullMask } = obj.options;
         if (displayPosition) key += `|display:${displayPosition}`;
@@ -13923,11 +14049,11 @@ var _changeEvent = { type: "change" };
 var _startEvent = { type: "start" };
 var _endEvent = { type: "end" };
 var OrbitControls = class extends import_three35.EventDispatcher {
-  constructor(object2, domElement) {
+  constructor(object3, domElement) {
     super();
     if (domElement === void 0) console.warn('THREE.OrbitControls: The second parameter "domElement" is now mandatory.');
     if (domElement === document) console.error('THREE.OrbitControls: "document" should not be used as the target "domElement". Please use "renderer.domElement" instead.');
-    this.object = object2;
+    this.object = object3;
     this.domElement = domElement;
     this.domElement.style.touchAction = "none";
     this.enabled = true;
@@ -13984,7 +14110,7 @@ var OrbitControls = class extends import_three35.EventDispatcher {
     };
     this.update = function() {
       const offset = new import_three35.Vector3();
-      const quat = new import_three35.Quaternion().setFromUnitVectors(object2.up, new import_three35.Vector3(0, 1, 0));
+      const quat = new import_three35.Quaternion().setFromUnitVectors(object3.up, new import_three35.Vector3(0, 1, 0));
       const quatInverse = quat.clone().invert();
       const lastPosition = new import_three35.Vector3();
       const lastQuaternion = new import_three35.Quaternion();
@@ -14549,8 +14675,8 @@ var OrbitControls = class extends import_three35.EventDispatcher {
   }
 };
 var MapControls = class extends OrbitControls {
-  constructor(object2, domElement) {
-    super(object2, domElement);
+  constructor(object3, domElement) {
+    super(object3, domElement);
     this.screenSpacePanning = false;
     this.mouseButtons.LEFT = import_three35.MOUSE.PAN;
     this.mouseButtons.RIGHT = import_three35.MOUSE.ROTATE;
@@ -14978,6 +15104,232 @@ init_SceneObject();
 // src/index.ts
 init_request();
 
+// src/scene/SceneDocument.ts
+init_DisplayPosition();
+function fail(path, message) {
+  throw new Error(`${path}: ${message}`);
+}
+function object2(value, path) {
+  if (!value || typeof value !== "object" || Array.isArray(value) || ![Object.prototype, null].includes(Object.getPrototypeOf(value))) fail(path, "expected a JSON object");
+  for (const key of Object.keys(value)) {
+    if (["__proto__", "prototype", "constructor"].includes(key)) fail(`${path}.${key}`, "unsupported property");
+  }
+  return value;
+}
+function fields(value, path, allowed, required = []) {
+  const input = object2(value, path);
+  for (const key of required) if (input[key] === void 0) fail(`${path}.${key}`, "required");
+  for (const [key, entry] of Object.entries(input)) {
+    if (!Object.prototype.hasOwnProperty.call(allowed, key)) fail(`${path}.${key}`, "unsupported property");
+    if (entry !== void 0) allowed[key](entry, `${path}.${key}`);
+  }
+  return input;
+}
+var text = (value, path) => {
+  if (typeof value !== "string" || !value.trim()) fail(path, "expected a nonempty string");
+};
+var literalText = (value, path) => {
+  if (typeof value !== "string") fail(path, "expected a string");
+};
+var boolean = (value, path) => {
+  if (typeof value !== "boolean") fail(path, "expected a boolean");
+};
+var number = (value, path) => {
+  if (typeof value !== "number" || !Number.isFinite(value)) fail(path, "expected a finite number");
+};
+var positive = (value, path) => {
+  number(value, path);
+  if (value <= 0) fail(path, "expected a positive number");
+};
+var nonnegative = (value, path) => {
+  number(value, path);
+  if (value < 0) fail(path, "expected a nonnegative number");
+};
+var color = (value, path) => {
+  number(value, path);
+  if (!Number.isInteger(value) || value < 0 || value > 16777215) {
+    fail(path, "expected an RGB integer from 0 to 16777215");
+  }
+};
+var asset = (value, path) => {
+  text(value, path);
+  if (!/^(?:[a-z0-9_.-]+:)?[a-z0-9_./-]+$/.test(value) || value.split(/[:/]/).some((part) => !part || part === "." || part === "..")) {
+    fail(path, "expected a resource ID such as minecraft:stone");
+  }
+};
+var version = (value, path) => {
+  text(value, path);
+  if (!/^[a-zA-Z0-9._-]+$/.test(value)) fail(path, "expected a Minecraft version without slashes");
+};
+var tuple = (size, item = number) => (value, path) => {
+  if (!Array.isArray(value) || value.length !== size) fail(path, `expected ${size} numbers`);
+  for (let index = 0; index < size; index++) item(value[index], `${path}[${index}]`);
+};
+var list = (item) => (value, path) => {
+  if (!Array.isArray(value)) fail(path, "expected an array");
+  for (let index = 0; index < value.length; index++) item(value[index], `${path}[${index}]`);
+};
+var dictionary = (item, numericKeys = false) => (value, path) => {
+  for (const [key, entry] of Object.entries(object2(value, path))) {
+    if (numericKeys && !/^\d+$/.test(key)) fail(`${path}.${key}`, "expected a nonnegative tint index");
+    item(entry, `${path}.${key}`);
+  }
+};
+var enumeration = (values) => (value, path) => {
+  if (!values.includes(value)) fail(path, `expected one of: ${values.join(", ")}`);
+};
+var textStyle = { color, bold: boolean, italic: boolean };
+function guiLayer(value, path) {
+  const layer = object2(value, path);
+  if (["texture", "item", "text"].filter((key) => layer[key] !== void 0).length !== 1) {
+    fail(path, "expected exactly one of texture, item, or text");
+  }
+  const layout = { name: text, position: tuple(2), size: tuple(2, positive) };
+  if (layer.texture !== void 0) {
+    fields(value, path, { ...layout, texture: asset, crop: (value2, path2) => {
+      tuple(4)(value2, path2);
+      const [x, y, width, height] = value2;
+      nonnegative(x, `${path2}[0]`);
+      nonnegative(y, `${path2}[1]`);
+      positive(width, `${path2}[2]`);
+      positive(height, `${path2}[3]`);
+    } });
+  } else if (layer.item !== void 0) {
+    fields(value, path, { ...layout, item: asset, tints: dictionary(color, true) });
+  } else {
+    fields(value, path, {
+      ...layout,
+      ...textStyle,
+      font: asset,
+      shadow: boolean,
+      maxWidth: positive,
+      lineHeight: positive,
+      text: (value2, path2) => {
+        if (typeof value2 === "string") return;
+        list((run, path3) => {
+          fields(run, path3, { text: literalText, ...textStyle }, ["text"]);
+        })(value2, path2);
+      }
+    });
+  }
+}
+function validateObject(value, path) {
+  const input = object2(value, path);
+  const common = { id: text, name: text, type: text, position: tuple(3), rotation: tuple(3), scale: tuple(3), visible: boolean };
+  const required = ["id", "type"];
+  const renderOptions = { wireframe: boolean };
+  switch (input.type) {
+    case "skin":
+      fields(value, path, {
+        ...common,
+        skin: text,
+        cape: (value2, path2) => {
+          fields(value2, path2, { texture: text, layout: enumeration(["minecraft", "optifine", "labymod"]) }, ["texture"]);
+        },
+        hiddenParts: list(enumeration(SKIN_PARTS)),
+        pose: (value2, path2) => {
+          fields(value2, path2, {
+            head: tuple(3),
+            body: tuple(3),
+            rightArm: tuple(3),
+            leftArm: tuple(3),
+            rightLeg: tuple(3),
+            leftLeg: tuple(3),
+            cape: tuple(3)
+          });
+        },
+        options: (value2, path2) => {
+          fields(value2, path2, { slim: boolean, legacy: boolean });
+        }
+      }, required);
+      break;
+    case "block":
+      fields(value, path, {
+        ...common,
+        asset,
+        state: dictionary(text),
+        options: (value2, path2) => {
+          fields(value2, path2, { ...renderOptions, tints: dictionary(color, true) });
+        }
+      }, [...required, "asset"]);
+      break;
+    case "item":
+    case "model":
+      fields(value, path, {
+        ...common,
+        asset,
+        options: (value2, path2) => {
+          fields(value2, path2, { ...renderOptions, displayPosition: enumeration(DISPLAY_POSITIONS), tints: dictionary(color, true) });
+        }
+      }, [...required, "asset"]);
+      break;
+    case "entity":
+      fields(value, path, {
+        ...common,
+        asset,
+        texture: asset,
+        layers: list(text),
+        when: list(text),
+        textures: dictionary(asset),
+        options: (value2, path2) => {
+          fields(value2, path2, {
+            ...renderOptions,
+            flip: boolean,
+            tints: dictionary((value3, path3) => {
+              typeof value3 === "string" ? text(value3, path3) : color(value3, path3);
+            })
+          });
+        },
+        animation: (value2, path2) => {
+          fields(value2, path2, { name: text, loop: boolean, speed: nonnegative, time: nonnegative, paused: boolean }, ["name"]);
+        }
+      }, [...required, "asset"]);
+      if (Array.isArray(input.layers) && !input.layers.length) fail(`${path}.layers`, "expected at least one layer");
+      break;
+    case "gui":
+      fields(value, path, { ...common, layers: list(guiLayer) }, [...required, "layers"]);
+      break;
+    default:
+      fail(`${path}.type`, "expected skin, block, item, entity, model, or gui");
+  }
+}
+function parseSceneDocument(value) {
+  if (typeof value === "string") {
+    try {
+      value = JSON.parse(value);
+    } catch {
+      fail("scene", "invalid JSON");
+    }
+  }
+  const input = fields(value, "scene", {
+    format: enumeration(["minerender-scene"]),
+    version: (value2, path) => {
+      if (value2 !== 1) fail(path, "only scene document version 1 is supported");
+    },
+    minecraftVersion: version,
+    camera: (value2, path) => {
+      fields(value2, path, { position: tuple(3), target: tuple(3) }, ["position", "target"]);
+    },
+    objects: list(validateObject)
+  }, ["format", "version", "objects"]);
+  const ids = /* @__PURE__ */ new Set();
+  for (const [index, entry] of input.objects.entries()) {
+    if (ids.has(entry.id)) fail(`scene.objects[${index}].id`, `duplicate object ID "${entry.id}"`);
+    ids.add(entry.id);
+  }
+  return JSON.parse(JSON.stringify(input));
+}
+
+// src/scene/SceneDocumentLoader.ts
+var import_three38 = require("three");
+init_AssetKey();
+init_AssetLoader();
+init_BlockStates();
+init_Entities();
+init_Models();
+init_DisplayPosition();
+init_SceneObject();
+
 // src/skin/Skins.ts
 init_Requests();
 var Skins = class {
@@ -15148,6 +15500,195 @@ var Skins = class {
   //</editor-fold>
 };
 
+// src/scene/SceneDocumentLoader.ts
+var DocumentObjectScene = class extends MineRenderScene {
+  async addSceneObject(_asset, supplier, _options, parent = this) {
+    const object3 = await supplier();
+    return this.initialize(object3, parent);
+  }
+  async initialize(object3, parent = this) {
+    object3.scene = this;
+    try {
+      await object3.init();
+      parent.add(object3);
+      return object3;
+    } catch (error) {
+      object3.dispose();
+      object3.removeFromParent();
+      throw error;
+    }
+  }
+  dispose() {
+    for (const child of [...this.children]) {
+      if (child.parent !== this) continue;
+      if (isSceneObject(child)) child.dispose();
+      child.removeFromParent();
+    }
+  }
+};
+async function skinTexture(value, cape = false) {
+  if (!/^[a-zA-Z0-9_-]{1,36}$/.test(value)) return value;
+  const texture = await (cape ? Skins.capeFromUuidOrUsername(value) : Skins.fromUuidOrUsername(value));
+  if (!texture) throw new Error(`Could not find ${cape ? "cape" : "skin"} for "${value}"`);
+  return texture;
+}
+var SceneDocumentLoader = class {
+  static parse(value) {
+    return parseSceneDocument(value);
+  }
+  /**
+   * Loads objects concurrently and attaches them in document order after every load succeeds.
+   * A failure waits for all loads, disposes staged objects, and reports the first error in document order.
+   */
+  static async load(scene, value, parent = scene) {
+    const definition = this.parse(value);
+    if (definition.minecraftVersion !== void 0 && definition.minecraftVersion !== AssetLoader.version) {
+      throw new Error(`Scene requires Minecraft ${definition.minecraftVersion}; call AssetLoader.setVersion("${definition.minecraftVersion}") before loading it`);
+    }
+    const root = new import_three38.Group();
+    root.name = "MineRender scene document";
+    const objects = [];
+    let disposed = false;
+    const loaded = {
+      root,
+      objects,
+      definition,
+      advanceAnimations: (delta) => {
+        if (!disposed) for (const object3 of objects) object3.advanceAnimation(delta);
+      },
+      dispose: () => {
+        if (disposed) return;
+        disposed = true;
+        root.removeFromParent();
+        for (const object3 of objects) object3.dispose();
+        root.clear();
+        scene.dirty = true;
+      }
+    };
+    try {
+      const results = await Promise.allSettled(definition.objects.map((object3) => this.loadValidatedObject(scene, object3)));
+      for (const result of results) if (result.status === "fulfilled") objects.push(result.value);
+      const failure = results.find((result) => result.status === "rejected");
+      if (failure) throw failure.reason;
+      for (const object3 of objects) root.add(object3.root);
+      parent.add(root);
+      scene.dirty = true;
+      return loaded;
+    } catch (error) {
+      loaded.dispose();
+      throw error;
+    }
+  }
+  /** Loads an independently editable object. Its root owns the document's position, rotation, and scale. */
+  static async loadObject(scene, value, parent = scene) {
+    const definition = this.parse({ format: "minerender-scene", version: 1, objects: [value] }).objects[0];
+    return this.loadValidatedObject(scene, definition, parent);
+  }
+  static async loadValidatedObject(scene, definition, parent) {
+    const root = new import_three38.Group();
+    root.name = definition.name ?? definition.id;
+    root.userData.sceneObjectId = definition.id;
+    root.position.fromArray(definition.position ?? [0, 0, 0]);
+    root.rotation.set(...definition.rotation ?? [0, 0, 0]);
+    root.scale.fromArray(definition.scale ?? [1, 1, 1]);
+    root.visible = definition.visible ?? true;
+    const content = new DocumentObjectScene();
+    root.add(content);
+    let object3;
+    try {
+      switch (definition.type) {
+        case "skin": {
+          const skin = new SkinObject({ ...definition.options, instanceMeshes: false });
+          object3 = skin;
+          const texture = definition.skin ? await skinTexture(definition.skin) : `${AssetLoader.ROOT}/assets/minecraft/textures/entity/player/${definition.options?.slim ? "slim/alex" : "wide/steve"}.png`;
+          await skin.setSkinTexture(texture);
+          await content.initialize(skin);
+          if (definition.cape) await skin.setCapeTexture(await skinTexture(definition.cape.texture, true), definition.cape.layout);
+          for (const [part, rotation] of Object.entries(definition.pose ?? {})) {
+            skin.getGroupByName(part)?.rotation.set(...rotation, "XYZ");
+          }
+          for (const part of definition.hiddenParts ?? []) {
+            const mesh = skin.getMeshByName(part);
+            if (mesh) mesh.visible = false;
+          }
+          break;
+        }
+        case "block": {
+          const state = await BlockStates.get(AssetKey.parse("blockstates", definition.asset));
+          if (!state) throw new Error(`Could not load block ${definition.asset}`);
+          object3 = await content.addBlock(state, { ...definition.options, initialState: definition.state, instanceMeshes: false });
+          break;
+        }
+        case "item":
+        case "model": {
+          let key = AssetKey.parse("models", definition.asset);
+          if (definition.type === "item" && key.type !== "item") {
+            key = new AssetKey(key.namespace, key.getFullPath(), "models", "item");
+          }
+          const model = await Models.getMerged(key);
+          if (!model) throw new Error(`Could not load ${definition.type} ${definition.asset}`);
+          object3 = await content.addModel(model, {
+            ...definition.type === "item" ? { displayPosition: "gui" /* GUI */ } : {},
+            ...definition.options,
+            instanceMeshes: false
+          });
+          break;
+        }
+        case "entity": {
+          const key = AssetKey.parse("entity-models", definition.asset);
+          const model = await Entities.getEntity(key, definition.texture ? AssetKey.parse("textures", definition.texture) : void 0, {
+            layers: definition.layers,
+            when: definition.when,
+            textures: definition.textures && Object.fromEntries(Object.entries(definition.textures).map(([name, texture]) => [name, AssetKey.parse("textures", texture)]))
+          });
+          if (!model) throw new Error(`Could not load entity ${definition.asset}`);
+          const entity = await content.addEntity(model, { ...definition.options, instanceMeshes: false });
+          object3 = entity;
+          if (definition.animation) {
+            const animations = await Entities.getAnimations(key);
+            const clip = animations?.[definition.animation.name];
+            if (!clip) throw new Error(`Entity ${definition.asset} has no animation "${definition.animation.name}"`);
+            entity.playAnimation(clip, definition.animation);
+          }
+          break;
+        }
+        case "gui":
+          object3 = await content.initialize(new GuiObject(definition.layers));
+          break;
+      }
+      let disposed = false;
+      const loaded = {
+        root,
+        object: object3,
+        definition,
+        advanceAnimation: (delta) => {
+          if (!disposed && definition.type === "entity" && !definition.animation?.paused) object3.advanceAnimation(delta);
+        },
+        dispose: () => {
+          if (disposed) return;
+          disposed = true;
+          root.removeFromParent();
+          object3.dispose();
+          object3.removeFromParent();
+          content.dispose();
+          root.clear();
+          scene.dirty = true;
+        }
+      };
+      parent?.add(root);
+      scene.dirty = true;
+      return loaded;
+    } catch (error) {
+      object3?.dispose();
+      object3?.removeFromParent();
+      content.dispose();
+      root.removeFromParent();
+      root.clear();
+      throw new Error(`Scene object "${definition.name ?? definition.id}": ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+};
+
 // src/texture/index.ts
 init_Colormaps();
 init_TextureAtlas();
@@ -15429,12 +15970,12 @@ var AnvilParser = class {
 };
 
 // src/world/Chunk.ts
-var import_three41 = require("three");
+var import_three42 = require("three");
 init_BlockStates();
 init_AssetKey();
 
 // src/world/MineRenderWorld.ts
-var import_three39 = require("three");
+var import_three40 = require("three");
 init_Model();
 init_BatchedExecutor();
 init_AssetKey();
@@ -15442,7 +15983,7 @@ init_BlockStates();
 init_CubeFace();
 
 // src/world/SectionModels.ts
-var import_three38 = require("three");
+var import_three39 = require("three");
 init_AssetKey();
 init_Models();
 init_CubeFace();
@@ -15501,20 +16042,20 @@ var SectionModels = class {
       if (!models) this.models.set(model, models = /* @__PURE__ */ new Map());
       const key = JSON.stringify([rotation.x, rotation.y, rotation.z, variant.uvlock, tints]);
       const template = await cached(models, key, async () => {
-        const object2 = new SectionModel(model, {
+        const object3 = new SectionModel(model, {
           instanceMeshes: false,
           mergeMeshes: false,
           tints,
           uvLockRotation: variant.uvlock && (rotation.x !== 0 || rotation.y !== 0) ? [rotation.x, rotation.y, rotation.z] : void 0
         });
-        await object2.init();
-        const geometry = object2.children[0].geometry;
-        geometry.applyMatrix4(new import_three38.Matrix4().makeRotationFromEuler(rotation));
-        object2.clear();
+        await object3.init();
+        const geometry = object3.children[0].geometry;
+        geometry.applyMatrix4(new import_three39.Matrix4().makeRotationFromEuler(rotation));
+        object3.clear();
         const cullFaces = CUBE_FACES.map((face) => {
           const local = CUBE_FACES.findIndex((name) => name === atlas.model.elements[0].faces[face]?.cullface);
           if (local < 0) return 0;
-          const normal = new import_three38.Vector3(...CUBE_FACE_OFFSETS[local]).applyEuler(rotation);
+          const normal = new import_three39.Vector3(...CUBE_FACE_OFFSETS[local]).applyEuler(rotation);
           const world = CUBE_FACE_OFFSETS.findIndex(([x, y, z]) => Math.abs(normal.x - x) < 1e-6 && Math.abs(normal.y - y) < 1e-6 && Math.abs(normal.z - z) < 1e-6);
           return 1 << world;
         });
@@ -15545,20 +16086,20 @@ var MineRenderWorld = class {
   }
   getBlockAt(posOrX, y, z) {
     if (typeof posOrX == "number") {
-      return this.getBlockAt(new import_three39.Vector3(posOrX, y, z));
+      return this.getBlockAt(new import_three40.Vector3(posOrX, y, z));
     }
     if (isTripleArray(posOrX)) {
-      return this.getBlockAt(new import_three39.Vector3(posOrX[0], posOrX[1], posOrX[2]));
+      return this.getBlockAt(new import_three40.Vector3(posOrX[0], posOrX[1], posOrX[2]));
     }
     this.validatePosBounds(posOrX);
     return this.getChunkAt(posOrX)?.getBlockAt(posOrX);
   }
   async setBlockAt(posOrX, yOrBlock, z, block) {
     if (typeof posOrX == "number") {
-      return this.setBlockAt(new import_three39.Vector3(posOrX, yOrBlock, z), block);
+      return this.setBlockAt(new import_three40.Vector3(posOrX, yOrBlock, z), block);
     }
     if (isTripleArray(posOrX)) {
-      return this.setBlockAt(new import_three39.Vector3(posOrX[0], posOrX[1], posOrX[2]), yOrBlock);
+      return this.setBlockAt(new import_three40.Vector3(posOrX[0], posOrX[1], posOrX[2]), yOrBlock);
     }
     return this.placeBlock(posOrX, yOrBlock);
   }
@@ -15569,10 +16110,10 @@ var MineRenderWorld = class {
   }
   async setBlockVisibleAt(posOrX, yOrVisible, z, visible) {
     if (typeof posOrX === "number") {
-      return this.setBlockVisibleAt(new import_three39.Vector3(posOrX, yOrVisible, z), visible);
+      return this.setBlockVisibleAt(new import_three40.Vector3(posOrX, yOrVisible, z), visible);
     }
     if (isTripleArray(posOrX)) {
-      return this.setBlockVisibleAt(new import_three39.Vector3(...posOrX), yOrVisible);
+      return this.setBlockVisibleAt(new import_three40.Vector3(...posOrX), yOrVisible);
     }
     this.validatePosBounds(posOrX);
     await this.getChunkAt(posOrX)?.setBlockVisibleAt(posOrX, yOrVisible);
@@ -15596,7 +16137,7 @@ var MineRenderWorld = class {
     const collect = async (positions2) => {
       for (const pos of positions2) changes.set(pos.toArray().join(","), pos);
     };
-    const place = (block) => this.placeBlock(new import_three39.Vector3(...block.position), block, collect);
+    const place = (block) => this.placeBlock(new import_three40.Vector3(...block.position), block, collect);
     const keys = /* @__PURE__ */ new Map();
     for (const block of multiblock.blocks) {
       if (Chunk.isAir(block)) continue;
@@ -15694,13 +16235,13 @@ var MineRenderWorld = class {
     for (const pos of positions) {
       this.pendingCulling.set(pos.toArray().join(","), pos.clone());
       for (const offset of CUBE_FACE_OFFSETS) {
-        const neighbor = pos.clone().add(new import_three39.Vector3(...offset));
+        const neighbor = pos.clone().add(new import_three40.Vector3(...offset));
         this.pendingCulling.set(neighbor.toArray().join(","), neighbor);
       }
       for (let y = -1; y <= 1; y++) {
         for (let z = -1; z <= 1; z++) {
           for (let x = -1; x <= 1; x++) {
-            const neighbor = pos.clone().add(new import_three39.Vector3(x, y, z));
+            const neighbor = pos.clone().add(new import_three40.Vector3(x, y, z));
             if (this.getBlockAt(neighbor)?.object?.fluidKind) {
               this.pendingCulling.set(neighbor.toArray().join(","), neighbor);
             }
@@ -15724,19 +16265,19 @@ var MineRenderWorld = class {
             }
             if (block.object?.fluidKind) {
               await block.object.updateFluid((x, y, z) => {
-                const neighbor = pos.clone().add(new import_three39.Vector3(x, y, z));
+                const neighbor = pos.clone().add(new import_three40.Vector3(x, y, z));
                 const section = this.getChunkAt(neighbor);
-                const object2 = section?.isBlockVisibleAt(neighbor) ? section.getBlockAt(neighbor)?.object : void 0;
+                const object3 = section?.isBlockVisibleAt(neighbor) ? section.getBlockAt(neighbor)?.object : void 0;
                 return {
-                  fluid: object2?.fluidKind,
-                  level: object2?.fluidLevel,
+                  fluid: object3?.fluidKind,
+                  level: object3?.fluidLevel,
                   solid: section?.isOccludingAt(neighbor) ?? false
                 };
               });
             }
             let mask = 0;
             for (const [face, offset] of CUBE_FACE_OFFSETS.entries()) {
-              const neighbor = pos.clone().add(new import_three39.Vector3(...offset));
+              const neighbor = pos.clone().add(new import_three40.Vector3(...offset));
               if (this.getChunkAt(neighbor)?.isOccludingAt(neighbor)) {
                 mask |= 1 << face;
               }
@@ -15772,7 +16313,7 @@ var MineRenderWorld = class {
   }
   /** Converts block coordinates to scene units by multiplying each component by 16. */
   static worldToScenePosition(pos) {
-    return new import_three39.Vector3(
+    return new import_three40.Vector3(
       pos.x * 16,
       pos.y * 16,
       pos.z * 16
@@ -15780,7 +16321,7 @@ var MineRenderWorld = class {
   }
   /** Converts scene units to block coordinates without rounding to an integer block. */
   static sceneToWorldPosition(pos) {
-    return new import_three39.Vector3(
+    return new import_three40.Vector3(
       pos.x / 16,
       pos.y / 16,
       pos.z / 16
@@ -15803,10 +16344,10 @@ var MineRenderWorld = class {
 init_Model();
 
 // src/world/SectionMesh.ts
-var import_three40 = require("three");
+var import_three41 = require("three");
 init_CanvasCompat();
 init_Materials();
-var SectionMesh = class _SectionMesh extends import_three40.Group {
+var SectionMesh = class _SectionMesh extends import_three41.Group {
   constructor() {
     super(...arguments);
     this.ownedMeshes = [];
@@ -15859,7 +16400,7 @@ var SectionMesh = class _SectionMesh extends import_three40.Group {
         const normal = template.geometry.getAttribute("normal");
         const uv = template.geometry.getAttribute("uv");
         const bounds = template.geometry.getAttribute("uvBounds");
-        const color = template.geometry.getAttribute("color");
+        const color2 = template.geometry.getAttribute("color");
         const sourceIndices = template.geometry.getIndex();
         const placement = locations.get(template.atlas).placement;
         const mapU = (u) => (placement.x + u * template.atlas.image.width) / page.width;
@@ -15881,24 +16422,24 @@ var SectionMesh = class _SectionMesh extends import_three40.Group {
               mapU(bounds?.getZ(vertex) ?? 1),
               mapV(bounds?.getW(vertex) ?? 1)
             );
-            colors.push(color?.getX(vertex) ?? 1, color?.getY(vertex) ?? 1, color?.getZ(vertex) ?? 1);
+            colors.push(color2?.getX(vertex) ?? 1, color2?.getY(vertex) ?? 1, color2?.getZ(vertex) ?? 1);
           }
           for (let corner = 0; corner < 6; corner++) indices.push(start + sourceIndices.getX(face * 6 + corner) - face * 4);
         }
       }
-      const geometry = new import_three40.BufferGeometry();
-      geometry.setAttribute("position", new import_three40.Float32BufferAttribute(positions, 3));
-      geometry.setAttribute("normal", new import_three40.Float32BufferAttribute(normals, 3));
-      geometry.setAttribute("uv", new import_three40.Float32BufferAttribute(uvs, 2));
-      geometry.setAttribute("uvBounds", new import_three40.Float32BufferAttribute(uvBounds, 4));
-      geometry.setAttribute("color", new import_three40.Float32BufferAttribute(colors, 3));
+      const geometry = new import_three41.BufferGeometry();
+      geometry.setAttribute("position", new import_three41.Float32BufferAttribute(positions, 3));
+      geometry.setAttribute("normal", new import_three41.Float32BufferAttribute(normals, 3));
+      geometry.setAttribute("uv", new import_three41.Float32BufferAttribute(uvs, 2));
+      geometry.setAttribute("uvBounds", new import_three41.Float32BufferAttribute(uvBounds, 4));
+      geometry.setAttribute("color", new import_three41.Float32BufferAttribute(colors, 3));
       geometry.setIndex(indices);
       geometry.computeBoundingBox();
       geometry.computeBoundingSphere();
       const material = Materials.createShadedCanvasMaterial(canvas, false, false, true);
       material.vertexColors = true;
       const texture = material.uniforms?.map?.value ?? material.map;
-      const mesh = new import_three40.Mesh(geometry, material);
+      const mesh = new import_three41.Mesh(geometry, material);
       section.add(mesh);
       section.ownedMeshes.push({ mesh, texture });
     }
@@ -15934,10 +16475,10 @@ var Chunk = class _Chunk {
   }
   getBlockAt(posOrX, y, z) {
     if (typeof posOrX == "number") {
-      return this.getBlockAt(new import_three41.Vector3(posOrX, y, z));
+      return this.getBlockAt(new import_three42.Vector3(posOrX, y, z));
     }
     if (isTripleArray(posOrX)) {
-      return this.getBlockAt(new import_three41.Vector3(posOrX[0], posOrX[1], posOrX[2]));
+      return this.getBlockAt(new import_three42.Vector3(posOrX[0], posOrX[1], posOrX[2]));
     }
     const pos = this.worldPosToChunkPos(posOrX);
     const index = _Chunk.chunkPosToBlockIndex(pos);
@@ -15945,10 +16486,10 @@ var Chunk = class _Chunk {
   }
   async setBlockAt(posOrX, yOrBlock, z, block) {
     if (typeof posOrX == "number") {
-      return this.setBlockAt(new import_three41.Vector3(posOrX, yOrBlock, z), block);
+      return this.setBlockAt(new import_three42.Vector3(posOrX, yOrBlock, z), block);
     }
     if (isTripleArray(posOrX)) {
-      return this.setBlockAt(new import_three41.Vector3(posOrX[0], posOrX[1], posOrX[2]), yOrBlock);
+      return this.setBlockAt(new import_three42.Vector3(posOrX[0], posOrX[1], posOrX[2]), yOrBlock);
     }
     const worldPos = posOrX;
     const pos = this.worldPosToChunkPos(worldPos);
@@ -15969,7 +16510,7 @@ var Chunk = class _Chunk {
     this.renderedBlocks.get(index)?.object?.removeFromScene();
     if (this.sectionBlocks.delete(index)) this.meshDirty = true;
     this.renderedBlocks.delete(index);
-    let object2;
+    let object3;
     try {
       if (!readBlock) return void 0;
       const stored = readBlock();
@@ -15984,22 +16525,22 @@ var Chunk = class _Chunk {
         this.sectionBlocks.set(index, { index, template, cullMask: 0 });
         this.meshDirty = true;
       } else {
-        object2 = await this.scene.addBlock(blockState, {
+        object3 = await this.scene.addBlock(blockState, {
           mergeMeshes: true,
           instanceMeshes: true,
           maxInstanceCount: 2e3,
           initialState: stored.properties
         });
-        object2.setPosition(MineRenderWorld.worldToScenePosition(worldPos));
+        object3.setPosition(MineRenderWorld.worldToScenePosition(worldPos));
       }
       const info = { get block() {
         return readBlock();
-      }, object: object2 };
+      }, object: object3 };
       this.renderedBlocks.set(index, info);
       return info;
     } catch (error) {
       this.data.set(index, void 0);
-      object2?.removeFromScene();
+      object3?.removeFromScene();
       throw error;
     } finally {
       await onBlocksChanged?.([worldPos]);
@@ -16062,7 +16603,7 @@ var Chunk = class _Chunk {
   /** Removes stored blocks and their render objects, then notifies the owning world of changed positions. */
   async clear(onBlocksChanged = this.onBlocksChanged) {
     const positions = [...this.renderedBlocks.keys()].map((index) => this.chunkPosToWorldPos(
-      new import_three41.Vector3(index % 16, Math.floor(index / 256), Math.floor(index / 16) % 16)
+      new import_three42.Vector3(index % 16, Math.floor(index / 256), Math.floor(index / 16) % 16)
     ));
     for (const info of this.renderedBlocks.values()) info.object?.removeFromScene();
     this.sectionBlocks.clear();
@@ -16088,14 +16629,14 @@ var Chunk = class _Chunk {
     return pos.y * 16 * 16 + pos.z * 16 + pos.x;
   }
   worldPosToChunkPos(pos) {
-    return new import_three41.Vector3(
+    return new import_three42.Vector3(
       pos.x - this.x * 16,
       pos.y - this.y * 16,
       pos.z - this.z * 16
     );
   }
   chunkPosToWorldPos(pos) {
-    return new import_three41.Vector3(
+    return new import_three42.Vector3(
       this.x * 16 + pos.x,
       this.y * 16 + pos.y,
       this.z * 16 + pos.z