minerender 2.1.0-alpha.140 → 2.1.0-alpha.142

package/dist/bundle.js

@@ -4852,7 +4852,7 @@ var MineRender = (() => {
     }
     throw new Error(`THREE.TextureUtils: Unknown texture type ${type}.`);
   }
-  var REVISION, MOUSE, TOUCH, CullFaceNone, CullFaceBack, CullFaceFront, PCFShadowMap, PCFSoftShadowMap, VSMShadowMap, FrontSide, BackSide, DoubleSide, NoBlending, NormalBlending, AdditiveBlending, SubtractiveBlending, MultiplyBlending, CustomBlending, AddEquation, SubtractEquation, ReverseSubtractEquation, MinEquation, MaxEquation, ZeroFactor, OneFactor, SrcColorFactor, OneMinusSrcColorFactor, SrcAlphaFactor, OneMinusSrcAlphaFactor, DstAlphaFactor, OneMinusDstAlphaFactor, DstColorFactor, OneMinusDstColorFactor, SrcAlphaSaturateFactor, ConstantColorFactor, OneMinusConstantColorFactor, ConstantAlphaFactor, OneMinusConstantAlphaFactor, NeverDepth, AlwaysDepth, LessDepth, LessEqualDepth, EqualDepth, GreaterEqualDepth, GreaterDepth, NotEqualDepth, MultiplyOperation, MixOperation, AddOperation, NoToneMapping, LinearToneMapping, ReinhardToneMapping, CineonToneMapping, ACESFilmicToneMapping, CustomToneMapping, AgXToneMapping, NeutralToneMapping, UVMapping, CubeReflectionMapping, CubeRefractionMapping, EquirectangularReflectionMapping, EquirectangularRefractionMapping, CubeUVReflectionMapping, RepeatWrapping, ClampToEdgeWrapping, MirroredRepeatWrapping, NearestFilter, NearestMipmapNearestFilter, NearestMipmapLinearFilter, LinearFilter, LinearMipmapNearestFilter, LinearMipmapLinearFilter, UnsignedByteType, ByteType, ShortType, UnsignedShortType, IntType, UnsignedIntType, FloatType, HalfFloatType, UnsignedShort4444Type, UnsignedShort5551Type, UnsignedInt248Type, UnsignedInt5999Type, UnsignedInt101111Type, AlphaFormat, RGBFormat, RGBAFormat, DepthFormat, DepthStencilFormat, RedFormat, RedIntegerFormat, RGFormat, RGIntegerFormat, RGBAIntegerFormat, RGB_S3TC_DXT1_Format, RGBA_S3TC_DXT1_Format, RGBA_S3TC_DXT3_Format, RGBA_S3TC_DXT5_Format, RGB_PVRTC_4BPPV1_Format, RGB_PVRTC_2BPPV1_Format, RGBA_PVRTC_4BPPV1_Format, RGBA_PVRTC_2BPPV1_Format, RGB_ETC1_Format, RGB_ETC2_Format, RGBA_ETC2_EAC_Format, R11_EAC_Format, SIGNED_R11_EAC_Format, RG11_EAC_Format, SIGNED_RG11_EAC_Format, RGBA_ASTC_4x4_Format, RGBA_ASTC_5x4_Format, RGBA_ASTC_5x5_Format, RGBA_ASTC_6x5_Format, RGBA_ASTC_6x6_Format, RGBA_ASTC_8x5_Format, RGBA_ASTC_8x6_Format, RGBA_ASTC_8x8_Format, RGBA_ASTC_10x5_Format, RGBA_ASTC_10x6_Format, RGBA_ASTC_10x8_Format, RGBA_ASTC_10x10_Format, RGBA_ASTC_12x10_Format, RGBA_ASTC_12x12_Format, RGBA_BPTC_Format, RGB_BPTC_SIGNED_Format, RGB_BPTC_UNSIGNED_Format, RED_RGTC1_Format, SIGNED_RED_RGTC1_Format, RED_GREEN_RGTC2_Format, SIGNED_RED_GREEN_RGTC2_Format, InterpolateDiscrete, InterpolateLinear, InterpolateSmooth, InterpolateBezier, ZeroCurvatureEnding, ZeroSlopeEnding, WrapAroundEnding, TrianglesDrawMode, TriangleStripDrawMode, TriangleFanDrawMode, BasicDepthPacking, TangentSpaceNormalMap, ObjectSpaceNormalMap, NoColorSpace, SRGBColorSpace, LinearSRGBColorSpace, LinearTransfer, SRGBTransfer, KeepStencilOp, AlwaysStencilFunc, NeverCompare, LessCompare, EqualCompare, LessEqualCompare, GreaterCompare, NotEqualCompare, GreaterEqualCompare, AlwaysCompare, StaticDrawUsage, GLSL3, WebGLCoordinateSystem, WebGPUCoordinateSystem, _cache, _setConsoleFunction, ReversedDepthFuncs, EventDispatcher, _lut, _seed, DEG2RAD, RAD2DEG, MathUtils, _Vector2, Vector2, Quaternion, _Vector3, Vector3, _vector$c, _quaternion$5, _Matrix3, Matrix3, _m3, LINEAR_REC709_TO_XYZ, XYZ_TO_LINEAR_REC709, ColorManagement, _canvas, ImageUtils, _sourceId, TextureSource, _textureId, _tempVec3, Texture, _Vector4, Vector4, RenderTarget, WebGLRenderTarget, DataArrayTexture, Data3DTexture, _Matrix4, Matrix4, _v1$7, _m1$2, _zero, _one, _x, _y, _z, _matrix$2, _quaternion$4, Euler, Layers, _object3DId, _v1$6, _q1, _m1$1, _target, _position$4, _scale$3, _quaternion$3, _xAxis, _yAxis, _zAxis, _addedEvent, _removedEvent, _childaddedEvent, _childremovedEvent, Object3D, Group, _moveEvent, WebXRController, _colorKeywords, _hslA, _hslB, Color, _color, Scene, _v0$2, _v1$5, _v2$4, _v3$2, _vab, _vac, _vbc, _vap, _vbp, _vcp, _v40, _v41, _v42, Triangle, Box3, _points, _vector$b, _box$4, _v0$1, _v1$4, _v2$3, _f0, _f1, _f2, _center, _extents, _triangleNormal, _testAxis, _vector$a, _vector2$1, _id$2, BufferAttribute, Uint16BufferAttribute, Uint32BufferAttribute, Float32BufferAttribute, _box$3, _v1$3, _v2$2, Sphere, _id$1, _m1, _obj, _offset, _box$2, _boxMorphTargets, _vector$9, BufferGeometry, InterleavedBuffer, _vector$8, InterleavedBufferAttribute, _vector1, _vector2, _normalMatrix, Plane, _materialId, Material, _vector$7, _segCenter, _segDir, _diff, Ray, MeshBasicMaterial, _inverseMatrix$3, _ray$3, _sphere$6, _sphereHitAt, _vA, _vB, _vC, _tempA, _morphA, _intersectionPoint, _intersectionPointWorld, Mesh, DataTexture, InstancedBufferAttribute, _instanceLocalMatrix, _instanceWorldMatrix, _instanceIntersects, _box3, _identity, _mesh$1, _sphere$4, InstancedMesh, _sphere$3, _defaultSpriteCenter, _vector$6, Frustum, LineBasicMaterial, _vStart, _vEnd, _inverseMatrix$1, _ray$1, _sphere$1, _intersectPointOnRay, _intersectPointOnSegment, Line, _start, _end, LineSegments, CompressedTexture, CubeTexture, CanvasTexture, DepthTexture, CubeDepthTexture, ExternalTexture, BoxGeometry, _v0, _v1$1, _normal, _triangle, EdgesGeometry, PlaneGeometry, UniformsUtils, default_vertex, default_fragment, ShaderMaterial, RawShaderMaterial, MeshStandardMaterial, MeshDepthMaterial, MeshDistanceMaterial, Interpolant, CubicInterpolant, LinearInterpolant, DiscreteInterpolant, BezierInterpolant, KeyframeTrack, BooleanKeyframeTrack, ColorKeyframeTrack, NumberKeyframeTrack, QuaternionLinearInterpolant, QuaternionKeyframeTrack, StringKeyframeTrack, VectorKeyframeTrack, LoadingManager, DefaultLoadingManager, Loader, _position$2, _quaternion$2, _scale$2, Camera, _v3$1, _minTarget, _maxTarget, PerspectiveCamera, OrthographicCamera, fov, aspect, CubeCamera, ArrayCamera, _RESERVED_CHARS_RE, _reservedRe, _wordChar, _wordCharOrDot, _directoryRe, _nodeRe, _objectRe, _propertyRe, _trackRe, _supportedObjectNames, Composite, PropertyBinding, _controlInterpolantsResultBuffer, Uniform, _matrix, Raycaster, Spherical, _Matrix2, Matrix2, _vector$4, Box2, GridHelper, AxesHelper, Controls;
+  var REVISION, MOUSE, TOUCH, CullFaceNone, CullFaceBack, CullFaceFront, PCFShadowMap, PCFSoftShadowMap, VSMShadowMap, FrontSide, BackSide, DoubleSide, NoBlending, NormalBlending, AdditiveBlending, SubtractiveBlending, MultiplyBlending, CustomBlending, AddEquation, SubtractEquation, ReverseSubtractEquation, MinEquation, MaxEquation, ZeroFactor, OneFactor, SrcColorFactor, OneMinusSrcColorFactor, SrcAlphaFactor, OneMinusSrcAlphaFactor, DstAlphaFactor, OneMinusDstAlphaFactor, DstColorFactor, OneMinusDstColorFactor, SrcAlphaSaturateFactor, ConstantColorFactor, OneMinusConstantColorFactor, ConstantAlphaFactor, OneMinusConstantAlphaFactor, NeverDepth, AlwaysDepth, LessDepth, LessEqualDepth, EqualDepth, GreaterEqualDepth, GreaterDepth, NotEqualDepth, MultiplyOperation, MixOperation, AddOperation, NoToneMapping, LinearToneMapping, ReinhardToneMapping, CineonToneMapping, ACESFilmicToneMapping, CustomToneMapping, AgXToneMapping, NeutralToneMapping, UVMapping, CubeReflectionMapping, CubeRefractionMapping, EquirectangularReflectionMapping, EquirectangularRefractionMapping, CubeUVReflectionMapping, RepeatWrapping, ClampToEdgeWrapping, MirroredRepeatWrapping, NearestFilter, NearestMipmapNearestFilter, NearestMipmapLinearFilter, LinearFilter, LinearMipmapNearestFilter, LinearMipmapLinearFilter, UnsignedByteType, ByteType, ShortType, UnsignedShortType, IntType, UnsignedIntType, FloatType, HalfFloatType, UnsignedShort4444Type, UnsignedShort5551Type, UnsignedInt248Type, UnsignedInt5999Type, UnsignedInt101111Type, AlphaFormat, RGBFormat, RGBAFormat, DepthFormat, DepthStencilFormat, RedFormat, RedIntegerFormat, RGFormat, RGIntegerFormat, RGBAIntegerFormat, RGB_S3TC_DXT1_Format, RGBA_S3TC_DXT1_Format, RGBA_S3TC_DXT3_Format, RGBA_S3TC_DXT5_Format, RGB_PVRTC_4BPPV1_Format, RGB_PVRTC_2BPPV1_Format, RGBA_PVRTC_4BPPV1_Format, RGBA_PVRTC_2BPPV1_Format, RGB_ETC1_Format, RGB_ETC2_Format, RGBA_ETC2_EAC_Format, R11_EAC_Format, SIGNED_R11_EAC_Format, RG11_EAC_Format, SIGNED_RG11_EAC_Format, RGBA_ASTC_4x4_Format, RGBA_ASTC_5x4_Format, RGBA_ASTC_5x5_Format, RGBA_ASTC_6x5_Format, RGBA_ASTC_6x6_Format, RGBA_ASTC_8x5_Format, RGBA_ASTC_8x6_Format, RGBA_ASTC_8x8_Format, RGBA_ASTC_10x5_Format, RGBA_ASTC_10x6_Format, RGBA_ASTC_10x8_Format, RGBA_ASTC_10x10_Format, RGBA_ASTC_12x10_Format, RGBA_ASTC_12x12_Format, RGBA_BPTC_Format, RGB_BPTC_SIGNED_Format, RGB_BPTC_UNSIGNED_Format, RED_RGTC1_Format, SIGNED_RED_RGTC1_Format, RED_GREEN_RGTC2_Format, SIGNED_RED_GREEN_RGTC2_Format, InterpolateDiscrete, InterpolateLinear, InterpolateSmooth, InterpolateBezier, ZeroCurvatureEnding, ZeroSlopeEnding, WrapAroundEnding, TrianglesDrawMode, TriangleStripDrawMode, TriangleFanDrawMode, BasicDepthPacking, TangentSpaceNormalMap, ObjectSpaceNormalMap, NoColorSpace, SRGBColorSpace, LinearSRGBColorSpace, LinearTransfer, SRGBTransfer, KeepStencilOp, AlwaysStencilFunc, NeverCompare, LessCompare, EqualCompare, LessEqualCompare, GreaterCompare, NotEqualCompare, GreaterEqualCompare, AlwaysCompare, StaticDrawUsage, DynamicDrawUsage, GLSL3, WebGLCoordinateSystem, WebGPUCoordinateSystem, _cache, _setConsoleFunction, ReversedDepthFuncs, EventDispatcher, _lut, _seed, DEG2RAD, RAD2DEG, MathUtils, _Vector2, Vector2, Quaternion, _Vector3, Vector3, _vector$c, _quaternion$5, _Matrix3, Matrix3, _m3, LINEAR_REC709_TO_XYZ, XYZ_TO_LINEAR_REC709, ColorManagement, _canvas, ImageUtils, _sourceId, TextureSource, _textureId, _tempVec3, Texture, _Vector4, Vector4, RenderTarget, WebGLRenderTarget, DataArrayTexture, Data3DTexture, _Matrix4, Matrix4, _v1$7, _m1$2, _zero, _one, _x, _y, _z, _matrix$2, _quaternion$4, Euler, Layers, _object3DId, _v1$6, _q1, _m1$1, _target, _position$4, _scale$3, _quaternion$3, _xAxis, _yAxis, _zAxis, _addedEvent, _removedEvent, _childaddedEvent, _childremovedEvent, Object3D, Group, _moveEvent, WebXRController, _colorKeywords, _hslA, _hslB, Color, _color, Scene, _v0$2, _v1$5, _v2$4, _v3$2, _vab, _vac, _vbc, _vap, _vbp, _vcp, _v40, _v41, _v42, Triangle, Box3, _points, _vector$b, _box$4, _v0$1, _v1$4, _v2$3, _f0, _f1, _f2, _center, _extents, _triangleNormal, _testAxis, _vector$a, _vector2$1, _id$2, BufferAttribute, Uint16BufferAttribute, Uint32BufferAttribute, Float32BufferAttribute, _box$3, _v1$3, _v2$2, Sphere, _id$1, _m1, _obj, _offset, _box$2, _boxMorphTargets, _vector$9, BufferGeometry, InterleavedBuffer, _vector$8, InterleavedBufferAttribute, _vector1, _vector2, _normalMatrix, Plane, _materialId, Material, _vector$7, _segCenter, _segDir, _diff, Ray, MeshBasicMaterial, _inverseMatrix$3, _ray$3, _sphere$6, _sphereHitAt, _vA, _vB, _vC, _tempA, _morphA, _intersectionPoint, _intersectionPointWorld, Mesh, DataTexture, InstancedBufferAttribute, _instanceLocalMatrix, _instanceWorldMatrix, _instanceIntersects, _box3, _identity, _mesh$1, _sphere$4, InstancedMesh, _sphere$3, _defaultSpriteCenter, _vector$6, Frustum, LineBasicMaterial, _vStart, _vEnd, _inverseMatrix$1, _ray$1, _sphere$1, _intersectPointOnRay, _intersectPointOnSegment, Line, _start, _end, LineSegments, CompressedTexture, CubeTexture, CanvasTexture, DepthTexture, CubeDepthTexture, ExternalTexture, BoxGeometry, _v0, _v1$1, _normal, _triangle, EdgesGeometry, PlaneGeometry, UniformsUtils, default_vertex, default_fragment, ShaderMaterial, RawShaderMaterial, MeshStandardMaterial, MeshDepthMaterial, MeshDistanceMaterial, Interpolant, CubicInterpolant, LinearInterpolant, DiscreteInterpolant, BezierInterpolant, KeyframeTrack, BooleanKeyframeTrack, ColorKeyframeTrack, NumberKeyframeTrack, QuaternionLinearInterpolant, QuaternionKeyframeTrack, StringKeyframeTrack, VectorKeyframeTrack, LoadingManager, DefaultLoadingManager, Loader, _position$2, _quaternion$2, _scale$2, Camera, _v3$1, _minTarget, _maxTarget, PerspectiveCamera, OrthographicCamera, fov, aspect, CubeCamera, ArrayCamera, _RESERVED_CHARS_RE, _reservedRe, _wordChar, _wordCharOrDot, _directoryRe, _nodeRe, _objectRe, _propertyRe, _trackRe, _supportedObjectNames, Composite, PropertyBinding, _controlInterpolantsResultBuffer, Uniform, _matrix, Raycaster, Spherical, _Matrix2, Matrix2, _vector$4, Box2, GridHelper, AxesHelper, Controls;
   var init_three_core = __esm({
     "../../node_modules/three/build/three.core.js"() {
       init_dirname();
@@ -5018,6 +5018,7 @@ var MineRender = (() => {
       GreaterEqualCompare = 518;
       AlwaysCompare = 519;
       StaticDrawUsage = 35044;
+      DynamicDrawUsage = 35048;
       GLSL3 = "300 es";
       WebGLCoordinateSystem = 2e3;
       WebGPUCoordinateSystem = 2001;
@@ -35699,6 +35700,7 @@ void main() {
             this.entityTextureCache,
             this.entityAnimationCache,
             this.blockEntityIndexCache,
+            this.entityDatasetVersionCache,
             this.fontCache,
             this.unihexCache,
             this.bannerPatternCache,
@@ -35754,6 +35756,7 @@ void main() {
       _Caching.entityTextureCache = _Caching.createAssetCache();
       _Caching.entityAnimationCache = _Caching.createAssetCache();
       _Caching.blockEntityIndexCache = _Caching.createAssetCache();
+      _Caching.entityDatasetVersionCache = _Caching.createAssetCache();
       _Caching.unihexCache = _Caching.createAssetCache();
       _Caching.fontCache = _Caching.createAssetCache();
       _Caching.bannerPatternCache = _Caching.createAssetCache();
@@ -82360,26 +82363,45 @@ ${key}` : key;
     }
   });
 
+  // src/assets/_versions/DatasetVersions.ts
+  var parseRelease, compare2, nearestRelease;
+  var init_DatasetVersions = __esm({
+    "src/assets/_versions/DatasetVersions.ts"() {
+      init_dirname();
+      init_buffer2();
+      init_process2();
+      parseRelease = (value) => /^\d+\.\d+(?:\.\d+)?$/.test(value) ? value.split(".").map(Number) : void 0;
+      compare2 = (left, right) => {
+        for (let i4 = 0; i4 < 3; i4++) {
+          const difference = (left[i4] ?? 0) - (right[i4] ?? 0);
+          if (difference) return difference;
+        }
+        return 0;
+      };
+      nearestRelease = (requestedVersion, published) => {
+        const requested = parseRelease(requestedVersion);
+        if (!requested) return void 0;
+        const versions2 = published.map((name2) => ({ name: name2, number: parseRelease(name2) })).filter((entry) => !!entry.number).sort((left, right) => compare2(left.number, right.number));
+        const sameLine = versions2.filter((entry) => entry.number[0] === requested[0] && entry.number[1] === requested[1]);
+        const selected = sameLine.sort((left, right) => Math.abs((left.number[2] ?? 0) - (requested[2] ?? 0)) - Math.abs((right.number[2] ?? 0) - (requested[2] ?? 0)) || compare2(left.number, right.number))[0] ?? versions2.filter((entry) => compare2(entry.number, requested) <= 0).pop() ?? versions2[0];
+        return selected?.name;
+      };
+    }
+  });
+
   // src/assets/MineRenderData.ts
-  var object2, release2, compare2, MineRenderData;
+  var object2, MineRenderData;
   var init_MineRenderData = __esm({
     "src/assets/MineRenderData.ts"() {
       init_dirname();
       init_buffer2();
       init_process2();
+      init_DatasetVersions();
       init_AssetKey();
       init_AssetLoader();
       init_AssetParsers();
       init_Caching();
       object2 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
-      release2 = (value) => /^\d+\.\d+(?:\.\d+)?$/.test(value) ? value.split(".").map(Number) : void 0;
-      compare2 = (left, right) => {
-        for (let i4 = 0; i4 < 3; i4++) {
-          const difference = (left[i4] ?? 0) - (right[i4] ?? 0);
-          if (difference) return difference;
-        }
-        return 0;
-      };
       MineRenderData = class {
         /** Loads one registry. Missing files and invalid data reject the request. */
         static async get(dataset, root) {
@@ -82409,9 +82431,9 @@ ${key}` : key;
           const scope = AssetLoader.persistentScope;
           return this.cached(`resolve:${requestRoot === void 0 ? "sources" : "explicit"}:${root}`, scope, defaultRoot, async () => {
             const requestedVersion = root.slice(root.lastIndexOf("/") + 1);
-            let manifest = await this.manifest(root, requestRoot !== void 0 && release2(requestedVersion) ? requestedVersion : void 0, requestRoot);
+            let manifest = await this.manifest(root, requestRoot !== void 0 && parseRelease(requestedVersion) ? requestedVersion : void 0, requestRoot);
             if (manifest) return { requestedVersion, version: manifest.minecraftVersion, root, manifest };
-            const requested = release2(requestedVersion);
+            const requested = parseRelease(requestedVersion);
             if (!requested) {
               throw new Error(`No MineRender data is published for ${requestedVersion}; automatic fallback requires a release`);
             }
@@ -82423,14 +82445,12 @@ ${key}` : key;
               }
               return value.versions;
             });
-            const versions2 = index.map((entry) => ({ name: entry.name, number: release2(entry.name) })).filter((entry) => !!entry.number).sort((left, right) => compare2(left.number, right.number));
-            const sameLine = versions2.filter((entry) => entry.number[0] === requested[0] && entry.number[1] === requested[1]);
-            const selected = sameLine.sort((left, right) => Math.abs((left.number[2] ?? 0) - (requested[2] ?? 0)) - Math.abs((right.number[2] ?? 0) - (requested[2] ?? 0)) || compare2(left.number, right.number))[0] ?? versions2.filter((entry) => compare2(entry.number, requested) <= 0).pop() ?? versions2[0];
+            const selected = nearestRelease(requestedVersion, index.map((entry) => entry.name));
             if (!selected) throw new Error(`No compatible MineRender data is published for ${requestedVersion}`);
-            const resolvedRoot = `${base}/${selected.name}`;
-            manifest = await this.manifest(resolvedRoot, selected.name, resolvedRoot);
-            if (!manifest) throw new Error(`Missing MineRender manifest for published version ${selected.name}`);
-            return { requestedVersion, version: selected.name, root: resolvedRoot, manifest };
+            const resolvedRoot = `${base}/${selected}`;
+            manifest = await this.manifest(resolvedRoot, selected, resolvedRoot);
+            if (!manifest) throw new Error(`Missing MineRender manifest for published version ${selected}`);
+            return { requestedVersion, version: selected, root: resolvedRoot, manifest };
           });
         }
         static async manifest(root, expectedVersion, requestRoot) {
@@ -83592,119 +83612,6 @@ ${key}` : key, async () => {
     }
   });
 
-  // src/assets/BlockEntities.ts
-  var log12, BlockEntities;
-  var init_BlockEntities = __esm({
-    "src/assets/BlockEntities.ts"() {
-      init_dirname();
-      init_buffer2();
-      init_process2();
-      init_three_module();
-      init_AssetKey();
-      init_AssetLoader();
-      init_source();
-      init_Caching();
-      init_log();
-      log12 = logger("BlockEntities");
-      BlockEntities = class {
-        /**
-         * Loads the block index of a version. Versions and sources without one yield an empty index, and so does
-         * a failed load: the index is optional, and blocks must not retry or fail with it one by one. The empty
-         * result is cached like any other; `Caching.clear()` or `AssetLoader.setVersion()` forces a new attempt.
-         */
-        static async getIndex(root) {
-          const key = new AssetKey("entity-models", "blocks", void 0, void 0, void 0, ".json", root);
-          key.rootType = void 0;
-          const index = await Caching.blockEntityIndexCache.get(key.serialize(), async () => {
-            try {
-              return await AssetLoader.get(key, "json" /* JSON */) ?? {};
-            } catch (error2) {
-              log12.warn("Could not load the block entity index; block entities are drawn as plain block models", error2);
-              return {};
-            }
-          });
-          return index ?? {};
-        }
-        /** The index entry of a block ID such as `minecraft:chest`. */
-        static entry(index, block) {
-          const entry = Object.prototype.hasOwnProperty.call(index, block) ? index[block] : void 0;
-          return Array.isArray(entry?.parts) ? entry : void 0;
-        }
-        /** Selects the parts and placement for a block ID such as `minecraft:chest`; undefined when nothing is drawn. */
-        static resolve(index, block, state = {}) {
-          const entry = this.entry(index, block);
-          if (!entry) return void 0;
-          const value = (property) => String(state[property]).toLowerCase();
-          const parts = entry.parts.filter((part) => Object.entries(part.when ?? {}).every(([property, values]) => String(values).split("|").includes(value(property))));
-          if (!parts.length) return void 0;
-          let rotation = 0;
-          if (entry.rotation) {
-            const selected = value(entry.rotation.property);
-            rotation = "degrees" in entry.rotation ? entry.rotation.degrees[selected] : Number(selected) * entry.rotation.step;
-            if (!Number.isFinite(rotation)) rotation = 0;
-          }
-          return { parts, rotation, translation: entry.translation ?? [0, 0, 0] };
-        }
-        /** Placement in block space (0..16 per axis), applied on top of the model's own transform. */
-        static matrix(resolved, matrix = new Matrix4()) {
-          return matrix.makeTranslation(8, 0, 8).multiply(new Matrix4().makeRotationY(resolved.rotation * Math.PI / 180)).multiply(new Matrix4().makeTranslation(resolved.translation[0] - 8, resolved.translation[1], resolved.translation[2] - 8));
-        }
-      };
-    }
-  });
-
-  // src/assets/DecoratedPots.ts
-  var POTTERY_SHERDS, DecoratedPots;
-  var init_DecoratedPots = __esm({
-    "src/assets/DecoratedPots.ts"() {
-      init_dirname();
-      init_buffer2();
-      init_process2();
-      init_AssetKey();
-      POTTERY_SHERDS = Object.freeze([
-        "angler",
-        "archer",
-        "arms_up",
-        "blade",
-        "brewer",
-        "burn",
-        "danger",
-        "explorer",
-        "flow",
-        "friend",
-        "guster",
-        "heart",
-        "heartbreak",
-        "howl",
-        "miner",
-        "mourner",
-        "plenty",
-        "prize",
-        "scrape",
-        "sheaf",
-        "shelter",
-        "skull",
-        "snort"
-      ].map((pattern2) => `minecraft:${pattern2}_pottery_sherd`));
-      DecoratedPots = class {
-        /** Reads up to four item IDs in back, left, right, front order; missing and unmapped items use plain sides. */
-        static getSideTextures(value, root) {
-          const items = value === void 0 ? [] : value;
-          if (!Array.isArray(items) || items.length > 4) throw new Error("pot_decorations must be an array of at most four item IDs");
-          const textures = items.map((item) => {
-            if (!isResourceLocation(item)) throw new Error("Pot decorations must be item identifiers");
-            const id = item.includes(":") ? item : `minecraft:${item}`;
-            return POTTERY_SHERDS.includes(id) ? id.slice("minecraft:".length).replace(/_sherd$/, "_pattern") : "decorated_pot_side";
-          });
-          return Object.fromEntries(["back", "left", "right", "front"].map((side, index) => [
-            side,
-            new AssetKey("minecraft", `decorated_pot/${textures[index] ?? "decorated_pot_side"}`, "textures", "entity", "assets", ".png", root)
-          ]));
-        }
-      };
-    }
-  });
-
   // src/assets/Entities.ts
   var Entities;
   var init_Entities = __esm({
@@ -83713,6 +83620,7 @@ ${key}` : key, async () => {
       init_buffer2();
       init_process2();
       init_AssetKey();
+      init_DatasetVersions();
       init_AssetLoader();
       init_source();
       init_Caching();
@@ -83720,11 +83628,36 @@ ${key}` : key, async () => {
       init_MineRenderError();
       init_ModelTextures();
       Entities = class {
+        /**
+         * Resolves `root` (default: the active version). Uses the exact dataset when published or when the
+         * version is not a release; otherwise selects the nearest published release, like {@link MineRenderData.resolve}.
+         * Textures keep the requested root.
+         */
+        static async getDatasetRoot(root) {
+          const requestRoot = (root ?? AssetLoader.ROOT).replace(/\/+$/, "");
+          const requestedVersion = requestRoot.slice(requestRoot.lastIndexOf("/") + 1);
+          const base = requestRoot.slice(0, requestRoot.lastIndexOf("/"));
+          const selected = await Caching.entityDatasetVersionCache.get(root ?? `sources:${AssetLoader.ROOT}`, async () => {
+            const key = new AssetKey("entity-models", "version", void 0, void 0, void 0, ".json", root);
+            key.rootType = void 0;
+            if (!parseRelease(requestedVersion) || await AssetLoader.get(key, "json" /* JSON */) !== void 0) return requestedVersion;
+            const indexKey = new AssetKey("entity-models", "versions", void 0, void 0, void 0, ".json", base);
+            indexKey.rootType = void 0;
+            const index = await AssetLoader.get(indexKey, "json" /* JSON */);
+            if (index === void 0) return requestedVersion;
+            if (!index || typeof index !== "object" || Array.isArray(index) || !Array.isArray(index.versions) || !index.versions.every((entry) => entry && typeof entry === "object" && !Array.isArray(entry) && typeof entry.name === "string")) {
+              throw new MineRenderError(`Invalid entity model version index at ${base}/entity-models/versions.json`);
+            }
+            return nearestRelease(requestedVersion, index.versions.map((entry) => entry.name)) ?? requestedVersion;
+          });
+          return selected === requestedVersion ? root : `${base}/${selected}`;
+        }
         /** Lists model paths in the `minecraft` namespace, including subdirectories and excluding `.json`. */
         static async getEntityList() {
+          const root = await this.getDatasetRoot();
           const collect = async (path) => {
             const prefix2 = path ? `${path}/` : "";
-            const key = new AssetKey(DEFAULT_NAMESPACE, `${prefix2}_list`, void 0, void 0, "entity-models", ".json");
+            const key = new AssetKey(DEFAULT_NAMESPACE, `${prefix2}_list`, void 0, void 0, "entity-models", ".json", root);
             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)}`);
@@ -83735,7 +83668,7 @@ ${key}` : key, async () => {
         }
         static async getModelFile(modelKey) {
           const path = isAssetKey(modelKey) ? modelKey.getFullPath() : modelKey.path;
-          const key = new AssetKey(modelKey.namespace, path, void 0, void 0, "entity-models", ".json", isAssetKey(modelKey) ? modelKey.root : void 0);
+          const key = new AssetKey(modelKey.namespace, path, void 0, void 0, "entity-models", ".json", await this.getDatasetRoot(isAssetKey(modelKey) ? modelKey.root : void 0));
           return Caching.entityModelCache.get(key.serialize(), () => AssetLoader.get(key, "json" /* JSON */));
         }
         /** Returns selectable geometry-layer names, or an empty list when the model is missing. */
@@ -83796,7 +83729,7 @@ ${key}` : key, async () => {
          */
         static async getAnimations(modelKey) {
           const path = isAssetKey(modelKey) ? modelKey.getFullPath() : modelKey.path;
-          const key = new AssetKey(modelKey.namespace, path, void 0, void 0, "entity-models/animations", ".json", isAssetKey(modelKey) ? modelKey.root : void 0);
+          const key = new AssetKey(modelKey.namespace, path, void 0, void 0, "entity-models/animations", ".json", await this.getDatasetRoot(isAssetKey(modelKey) ? modelKey.root : void 0));
           const file = await Caching.entityAnimationCache.get(key.serialize(), () => AssetLoader.get(key, "json" /* JSON */));
           return file?.animations;
         }
@@ -83838,6 +83771,121 @@ ${key}` : key, async () => {
     }
   });
 
+  // src/assets/BlockEntities.ts
+  var log12, BlockEntities;
+  var init_BlockEntities = __esm({
+    "src/assets/BlockEntities.ts"() {
+      init_dirname();
+      init_buffer2();
+      init_process2();
+      init_three_module();
+      init_AssetKey();
+      init_Entities();
+      init_AssetLoader();
+      init_source();
+      init_Caching();
+      init_log();
+      log12 = logger("BlockEntities");
+      BlockEntities = class {
+        /**
+         * Loads the block index of a version. Versions and sources without one yield an empty index, and so does
+         * a failed load: the index is optional, and blocks must not retry or fail with it one by one. The empty
+         * result is cached like any other; `Caching.clear()` or `AssetLoader.setVersion()` forces a new attempt.
+         */
+        static async getIndex(root) {
+          const key = new AssetKey("entity-models", "blocks", void 0, void 0, void 0, ".json", root);
+          key.rootType = void 0;
+          const index = await Caching.blockEntityIndexCache.get(key.serialize(), async () => {
+            try {
+              key.root = await Entities.getDatasetRoot(root);
+              return await AssetLoader.get(key, "json" /* JSON */) ?? {};
+            } catch (error2) {
+              log12.warn("Could not load the block entity index; block entities are drawn as plain block models", error2);
+              return {};
+            }
+          });
+          return index ?? {};
+        }
+        /** The index entry of a block ID such as `minecraft:chest`. */
+        static entry(index, block) {
+          const entry = Object.prototype.hasOwnProperty.call(index, block) ? index[block] : void 0;
+          return Array.isArray(entry?.parts) ? entry : void 0;
+        }
+        /** Selects the parts and placement for a block ID such as `minecraft:chest`; undefined when nothing is drawn. */
+        static resolve(index, block, state = {}) {
+          const entry = this.entry(index, block);
+          if (!entry) return void 0;
+          const value = (property) => String(state[property]).toLowerCase();
+          const parts = entry.parts.filter((part) => Object.entries(part.when ?? {}).every(([property, values]) => String(values).split("|").includes(value(property))));
+          if (!parts.length) return void 0;
+          let rotation = 0;
+          if (entry.rotation) {
+            const selected = value(entry.rotation.property);
+            rotation = "degrees" in entry.rotation ? entry.rotation.degrees[selected] : Number(selected) * entry.rotation.step;
+            if (!Number.isFinite(rotation)) rotation = 0;
+          }
+          return { parts, rotation, translation: entry.translation ?? [0, 0, 0] };
+        }
+        /** Placement in block space (0..16 per axis), applied on top of the model's own transform. */
+        static matrix(resolved, matrix = new Matrix4()) {
+          return matrix.makeTranslation(8, 0, 8).multiply(new Matrix4().makeRotationY(resolved.rotation * Math.PI / 180)).multiply(new Matrix4().makeTranslation(resolved.translation[0] - 8, resolved.translation[1], resolved.translation[2] - 8));
+        }
+      };
+    }
+  });
+
+  // src/assets/DecoratedPots.ts
+  var POTTERY_SHERDS, DecoratedPots;
+  var init_DecoratedPots = __esm({
+    "src/assets/DecoratedPots.ts"() {
+      init_dirname();
+      init_buffer2();
+      init_process2();
+      init_AssetKey();
+      POTTERY_SHERDS = Object.freeze([
+        "angler",
+        "archer",
+        "arms_up",
+        "blade",
+        "brewer",
+        "burn",
+        "danger",
+        "explorer",
+        "flow",
+        "friend",
+        "guster",
+        "heart",
+        "heartbreak",
+        "howl",
+        "miner",
+        "mourner",
+        "plenty",
+        "prize",
+        "scrape",
+        "sheaf",
+        "shelter",
+        "skull",
+        "snort"
+      ].map((pattern2) => `minecraft:${pattern2}_pottery_sherd`));
+      DecoratedPots = class {
+        /** Reads up to four item IDs in back, left, right, front order; missing and unmapped items use plain sides. */
+        static getSideTextures(value, root) {
+          const items = value === void 0 ? [] : value;
+          if (!Array.isArray(items) || items.length > 4) throw new Error("pot_decorations must be an array of at most four item IDs");
+          const textures = items.map((item) => {
+            if (!isResourceLocation(item)) throw new Error("Pot decorations must be item identifiers");
+            const id = item.includes(":") ? item : `minecraft:${item}`;
+            return POTTERY_SHERDS.includes(id) ? id.slice("minecraft:".length).replace(/_sherd$/, "_pattern") : "decorated_pot_side";
+          });
+          return Object.fromEntries(["back", "left", "right", "front"].map((side, index) => [
+            side,
+            new AssetKey("minecraft", `decorated_pot/${textures[index] ?? "decorated_pot_side"}`, "textures", "entity", "assets", ".png", root)
+          ]));
+        }
+      };
+    }
+  });
+
   // src/assets/_fonts/Unihex.ts
   var Unihex_exports = {};
   __export(Unihex_exports, {
@@ -103140,7 +103188,7 @@ gl_FragDepth=readDepth(vUv);
       read.waiters++;
       return new Promise((resolve, reject) => {
         let finished = false;
-        const release3 = () => {
+        const release2 = () => {
           if (finished) return false;
           finished = true;
           signal?.removeEventListener("abort", abort2);
@@ -103148,7 +103196,7 @@ gl_FragDepth=readDepth(vUv);
           return true;
         };
         const abort2 = () => {
-          if (!release3()) return;
+          if (!release2()) return;
           if (!read.waiters && !read.settled) {
             if (this.pending.get(key) === read) this.pending.delete(key);
             read.controller.abort(signal.reason);
@@ -103158,10 +103206,10 @@ gl_FragDepth=readDepth(vUv);
         signal?.addEventListener("abort", abort2, { once: true });
         read.promise.then(
           (data) => {
-            if (release3()) resolve(data);
+            if (release2()) resolve(data);
           },
           (error2) => {
-            if (release3()) reject(error2);
+            if (release2()) reject(error2);
           }
         );
         if (signal?.aborted) abort2();
@@ -104816,6 +104864,9 @@ gl_FragDepth=readDepth(vUv);
   var SectionWorker = _SectionWorker;
 
   // src/world/SectionMesh.ts
+  var BLOCK_SIZE = 16;
+  var QUAD_VERTICES = 4;
+  var QUAD_INDICES = 6;
   var templateCache = /* @__PURE__ */ new WeakMap();
   var WATER_TINT = new Color(4159204).toArray();
   function toInput(entries, maxAtlasSize, fluids, lighting) {
@@ -104852,8 +104903,8 @@ gl_FragDepth=readDepth(vUv);
         if (!data) {
           const indices = template.geometry.getIndex();
           const position = template.geometry.getAttribute("position");
-          const quads = indices.count / 6;
-          if (indices.count % 6 !== 0 || position.count !== quads * 4) {
+          const quads = indices.count / QUAD_INDICES;
+          if (indices.count % QUAD_INDICES !== 0 || position.count !== quads * QUAD_VERTICES) {
             throw new RangeError("Section template geometry must hold four vertices and six indices per quad");
           }
           data = {
@@ -104863,8 +104914,8 @@ gl_FragDepth=readDepth(vUv);
             uvs: new Float32Array(quads * 8),
             uvBounds: new Float32Array(quads * 16),
             colors: new Float32Array(quads * 12),
-            shade: new Float32Array(quads * 4),
-            indices: new Uint16Array(quads * 6),
+            shade: new Float32Array(quads * QUAD_VERTICES),
+            indices: new Uint16Array(quads * QUAD_INDICES),
             cullFaces: new Uint8Array(template.cullFaces),
             biomeTint: template.biomeTint ? new Uint8Array(template.biomeTint) : void 0,
             atlas: 0,
@@ -104876,7 +104927,7 @@ gl_FragDepth=readDepth(vUv);
           const bounds = template.geometry.getAttribute("uvBounds");
           const color3 = template.geometry.getAttribute("color");
           const shade = template.geometry.getAttribute("shade");
-          for (let vertex2 = 0; vertex2 < quads * 4; vertex2++) {
+          for (let vertex2 = 0; vertex2 < quads * QUAD_VERTICES; vertex2++) {
             data.positions.set([position.getX(vertex2), position.getY(vertex2), position.getZ(vertex2)], vertex2 * 3);
             data.normals.set([normal.getX(vertex2), normal.getY(vertex2), normal.getZ(vertex2)], vertex2 * 3);
             data.uvs.set([uv.getX(vertex2), uv.getY(vertex2)], vertex2 * 2);
@@ -104889,7 +104940,7 @@ gl_FragDepth=readDepth(vUv);
             data.colors.set([color3?.getX(vertex2) ?? 1, color3?.getY(vertex2) ?? 1, color3?.getZ(vertex2) ?? 1], vertex2 * 3);
             data.shade[vertex2] = shade?.getX(vertex2) ?? 1;
           }
-          for (let i5 = 0; i5 < data.indices.length; i5++) data.indices[i5] = indices.getX(i5) - 4 * Math.floor(i5 / 6);
+          for (let i5 = 0; i5 < data.indices.length; i5++) data.indices[i5] = indices.getX(i5) - QUAD_VERTICES * Math.floor(i5 / QUAD_INDICES);
           templateCache.set(template, data);
         }
         id = input.templateData.length;
@@ -104922,6 +104973,54 @@ gl_FragDepth=readDepth(vUv);
     }
     return { input, atlases: atlases2 };
   }
+  function sortTransparentQuads(mesh) {
+    const index = mesh.geometry.getIndex();
+    if (index.count <= QUAD_INDICES) return;
+    index.setUsage(DynamicDrawUsage);
+    const count = index.count / QUAD_INDICES;
+    let source, centers, depths, order;
+    const view = new Matrix4(), localCamera = new Vector3(), key = new Vector3(), previous = new Vector3();
+    let previousOrthographic;
+    mesh.onBeforeRender = (_renderer, _scene, camera) => {
+      localCamera.setFromMatrixPosition(camera.matrixWorld).applyMatrix4(view.copy(mesh.matrixWorld).invert());
+      const orthographic = !!camera.isOrthographicCamera;
+      if (orthographic) {
+        view.multiplyMatrices(camera.matrixWorldInverse, mesh.matrixWorld);
+        key.set(view.elements[2], view.elements[6], view.elements[10]);
+      } else {
+        key.copy(localCamera).divideScalar(BLOCK_SIZE).floor();
+      }
+      if (orthographic === previousOrthographic && key.equals(previous)) return;
+      previous.copy(key);
+      previousOrthographic = orthographic;
+      if (!centers) {
+        source = new Uint32Array(index.array);
+        centers = new Float32Array(count * 3);
+        depths = new Float32Array(count);
+        order = Uint32Array.from({ length: count }, (_4, quad) => quad);
+        const positions = mesh.geometry.getAttribute("position");
+        for (let quad = 0; quad < count; quad++) {
+          for (let axis = 0; axis < 3; axis++) {
+            let center = 0;
+            for (let corner = 0; corner < QUAD_VERTICES; corner++) center += positions.getComponent(quad * QUAD_VERTICES + corner, axis);
+            centers[quad * 3 + axis] = center / QUAD_VERTICES;
+          }
+        }
+      }
+      for (let quad = 0; quad < count; quad++) {
+        const x4 = centers[quad * 3], y5 = centers[quad * 3 + 1], z4 = centers[quad * 3 + 2];
+        depths[quad] = orthographic ? key.x * x4 + key.y * y5 + key.z * z4 : -((x4 - localCamera.x) ** 2 + (y5 - localCamera.y) ** 2 + (z4 - localCamera.z) ** 2);
+      }
+      order.sort((a4, b4) => depths[a4] - depths[b4] || a4 - b4);
+      if (!order.some((quad, offset) => index.array[offset * QUAD_INDICES] !== source[quad * QUAD_INDICES])) return;
+      for (let offset = 0; offset < count; offset++) {
+        for (let indexOffset = 0; indexOffset < QUAD_INDICES; indexOffset++) {
+          index.array[offset * QUAD_INDICES + indexOffset] = source[order[offset] * QUAD_INDICES + indexOffset];
+        }
+      }
+      index.needsUpdate = true;
+    };
+  }
   var SectionMesh = class _SectionMesh extends Group {
     constructor() {
       super(...arguments);
@@ -104931,7 +105030,11 @@ gl_FragDepth=readDepth(vUv);
     /** Returns the owning section cell for a triangle hit on this mesh's merged geometry. */
     getBlockIndex(hit) {
       if (hit.faceIndex === void 0 || hit.faceIndex === null) return void 0;
-      return this.blockIndices.get(hit.object)?.[Math.floor(hit.faceIndex / 2)];
+      const mesh = hit.object;
+      const owners = this.blockIndices.get(mesh);
+      if (!owners) return void 0;
+      const vertex2 = mesh.geometry.getIndex().getX(hit.faceIndex * 3);
+      return owners[Math.floor(vertex2 / QUAD_VERTICES)];
     }
     /** Builds section-local meshes from visible quads. `maxAtlasSize` limits each atlas dimension in pixels. */
     static build(entries, maxAtlasSize = 2048, fluids, lighting) {
@@ -104967,13 +105070,14 @@ gl_FragDepth=readDepth(vUv);
         const material = Materials.createShadedCanvasMaterial(canvas, transparent, false, true);
         material.side = FrontSide;
         if (page.layer === 2) {
+          material.depthWrite = !material.transparent;
           material.side = DoubleSide;
           material.forceSinglePass = true;
-          material.depthWrite = !material.transparent;
         }
         material.vertexColors = true;
         const texture = material.uniforms?.map?.value ?? material.map;
         const mesh = new Mesh(geometry, material);
+        if (transparent) sortTransparentQuads(mesh);
         section.add(mesh);
         section.blockIndices.set(mesh, page.blockIndices);
         const unsubscribe = [];