minerender 2.1.0-alpha.53 → 2.1.0-alpha.55

package/dist/node/index.mjs

@@ -290,6 +290,12 @@ var init_Caching = __esm({
       static {
         this.entityTextureCache = _Caching.createAssetCache();
       }
+      static {
+        this.entityAnimationCache = _Caching.createAssetCache();
+      }
+      static {
+        this.blockEntityIndexCache = _Caching.createAssetCache();
+      }
       static createAssetCache() {
         return Caches.builder().expireAfterWrite(Time.minutes(10)).expireAfterAccess(Time.minutes(5)).expirationInterval(Time.seconds(30)).buildAsync();
       }
@@ -314,7 +320,9 @@ var init_Caching = __esm({
           this.defaultBlockStatesCache,
           this.blockTintCache,
           this.entityModelCache,
-          this.entityTextureCache
+          this.entityTextureCache,
+          this.entityAnimationCache,
+          this.blockEntityIndexCache
         ];
       }
       static clear() {
@@ -843,7 +851,7 @@ var init_Textures = __esm({
 });
 
 // src/Materials.ts
-import { Color, DoubleSide, FrontSide, MeshBasicMaterial, MeshStandardMaterial, ShaderChunk, ShaderMaterial } from "three";
+import { Color, CustomBlending, DoubleSide, OneFactor, RepeatWrapping, FrontSide, MeshBasicMaterial, MeshStandardMaterial, ShaderChunk, ShaderMaterial, ZeroFactor } from "three";
 var Materials;
 var init_Materials = __esm({
   "src/Materials.ts"() {
@@ -885,6 +893,71 @@ var init_Materials = __esm({
           alphaTest: 0.5
         });
       }
+      /** Whether vanilla's render type for the mode culls back faces. */
+      static entityModeCulls(mode = "cutout") {
+        return mode === "cutout_cull" || mode === "solid" || mode === "eyes" || mode === "water_mask";
+      }
+      /** UV offset per tick of entity age for the scrolling modes, as vanilla's texture matrix applies it. */
+      static entityModeScroll(mode = "cutout") {
+        if (mode === "energy_swirl") return [0.01, 0.01];
+        if (mode === "breeze_wind") return [0.02, 0];
+        return void 0;
+      }
+      /**
+       * Entity material for one of vanilla's render types. Entities are unlit here, so the lit and full-bright modes
+       * differ only in blending and depth state. Culling is not a material property: {@link entityModeCulls} decides
+       * whether the geometry gets inward faces.
+       */
+      static createEntityCanvasMaterial(canvas, mode = "cutout", tint) {
+        const material = _Materials.createBasicCanvasMaterial(canvas);
+        switch (mode) {
+          case "cutout":
+          case "cutout_cull":
+            break;
+          case "cutout_z_offset":
+            material.polygonOffset = true;
+            material.polygonOffsetFactor = -1;
+            material.polygonOffsetUnits = -10;
+            break;
+          case "solid":
+            material.alphaTest = 0;
+            break;
+          case "translucent":
+          case "breeze_wind":
+            material.transparent = true;
+            material.alphaTest = 0.1;
+            break;
+          case "translucent_emissive":
+            material.transparent = true;
+            material.alphaTest = 0.1;
+            material.depthWrite = false;
+            break;
+          case "eyes":
+            material.transparent = true;
+            material.alphaTest = 0;
+            material.depthWrite = false;
+            break;
+          case "energy_swirl":
+            material.transparent = true;
+            material.alphaTest = 0.1;
+            material.blending = CustomBlending;
+            material.blendSrc = OneFactor;
+            material.blendDst = OneFactor;
+            material.blendSrcAlpha = ZeroFactor;
+            material.blendDstAlpha = OneFactor;
+            material.color.set(8421504);
+            break;
+          case "water_mask":
+            material.alphaTest = 0;
+            material.colorWrite = false;
+            break;
+        }
+        if (_Materials.entityModeScroll(mode)) {
+          material.map.wrapS = material.map.wrapT = RepeatWrapping;
+        }
+        if (tint !== void 0) material.color.multiply(new Color(tint));
+        return material;
+      }
       static createGuiCanvasMaterial(canvas) {
         const material = new MeshBasicMaterial({
           map: Textures.createCanvasTexture(canvas),
@@ -3096,7 +3169,7 @@ var init_InstanceReference = __esm({
 });
 
 // src/renderer/SceneObject.ts
-import { Color as Color2, Euler as Euler3, InstancedBufferAttribute, InstancedMesh, MathUtils, Matrix4 as Matrix43, Mesh as Mesh3, Object3D as Object3D2, Quaternion as Quaternion3, Vector3 as Vector35 } from "three";
+import { Color as Color2, Euler as Euler3, InstancedBufferAttribute, InstancedMesh, MathUtils, Matrix4 as Matrix44, Mesh as Mesh3, Object3D as Object3D2, Quaternion as Quaternion3, Vector3 as Vector35 } from "three";
 function isSceneObject(obj) {
   return obj.isSceneObject;
 }
@@ -3312,7 +3385,7 @@ var init_SceneObject = __esm({
           mesh.instanceColor.needsUpdate = true;
         }
         if (this._scene) this._scene.stats.instanceCount++;
-        this.setMatrixAt(index, new Matrix43());
+        this.setMatrixAt(index, new Matrix44());
         return reference;
       }
       /** Returns the live reference for a raycast hit on this object's instance mesh. */
@@ -3325,7 +3398,7 @@ var init_SceneObject = __esm({
       removeInstanceAt(index) {
         if (!this.instanceReferences.has(index)) return;
         const mesh = this.instanceMesh;
-        this.setMatrixAt(index, new Matrix43().makeScale(0, 0, 0));
+        this.setMatrixAt(index, new Matrix44().makeScale(0, 0, 0));
         this.instanceReferences.delete(index);
         this.freeInstanceIndices.push(index);
         this._instanceCounter = this.instanceReferences.size;
@@ -3355,7 +3428,7 @@ var init_SceneObject = __esm({
       }
       //</editor-fold>
       //<editor-fold desc="TRANSFORMATION">
-      getMatrixAt(index, matrix = new Matrix43()) {
+      getMatrixAt(index, matrix = new Matrix44()) {
         if (!this.instanceReferences.has(index)) throw new MineRenderError("Instance is not active");
         this.instanceMesh.getMatrixAt(index, matrix);
         return matrix;
@@ -3374,7 +3447,7 @@ var init_SceneObject = __esm({
         const oldPosition = new Vector35();
         const oldRotation = new Quaternion3();
         const oldScale = new Vector35();
-        const matrix = new Matrix43();
+        const matrix = new Matrix44();
         if (!scale || !rotation || !position) {
           this.getMatrixAt(index, matrix).decompose(oldPosition, oldRotation, oldScale);
         }
@@ -4122,7 +4195,7 @@ var init_ModelCulling = __esm({
 });
 
 // src/model/scene/ModelObject.ts
-import { BoxGeometry as BoxGeometry5, BufferAttribute as BufferAttribute5, Color as Color7, Euler as Euler5, Matrix4 as Matrix46 } from "three";
+import { BoxGeometry as BoxGeometry5, BufferAttribute as BufferAttribute5, Color as Color8, Euler as Euler6, Matrix4 as Matrix48 } from "three";
 function isModelObject(obj) {
   return obj.isModelObject;
 }
@@ -4188,7 +4261,7 @@ var init_ModelObject = __esm({
                 elGeo.clearGroups();
               }
               if (this.options.uvLockRotation) {
-                UVMapper.lockUvs(elGeo, el.faces, this.atlas, new Euler5(...this.options.uvLockRotation));
+                UVMapper.lockUvs(elGeo, el.faces, this.atlas, new Euler6(...this.options.uvLockRotation));
               }
               if (this.options.tints) {
                 const colors = new Float32Array(elGeo.getAttribute("position").count * 3).fill(1);
@@ -4197,19 +4270,19 @@ 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 Color7(tint);
+                  const color = new Color8(tint);
                   for (let vertex = 0; vertex < 4; vertex++) {
                     color.toArray(colors, (faceIndex * 4 + vertex) * 3);
                   }
                 }
                 elGeo.setAttribute("color", new BufferAttribute5(colors, 3));
               }
-              elGeo.applyMatrix4(new Matrix46().makeTranslation((el.to[0] - el.from[0]) / 2, (el.to[1] - el.from[1]) / 2, (el.to[2] - el.from[2]) / 2));
-              elGeo.applyMatrix4(new Matrix46().makeTranslation(el.from[0], el.from[1], el.from[2]));
+              elGeo.applyMatrix4(new Matrix48().makeTranslation((el.to[0] - el.from[0]) / 2, (el.to[1] - el.from[1]) / 2, (el.to[2] - el.from[2]) / 2));
+              elGeo.applyMatrix4(new Matrix48().makeTranslation(el.from[0], el.from[1], el.from[2]));
               if (el.rotation) {
                 applyElementRotation(el.rotation, elGeo);
               }
-              elGeo.applyMatrix4(new Matrix46().makeTranslation(-8, -8, -8));
+              elGeo.applyMatrix4(new Matrix48().makeTranslation(-8, -8, -8));
               if (displayTransform) DisplayTransforms.apply(elGeo, displayTransform);
               if (this.options.mergeMeshes) {
                 allGeos.push(elGeo);
@@ -4461,7 +4534,7 @@ __export(FluidModelObject_exports, {
   FluidModelObject: () => FluidModelObject,
   sampleFluid: () => sampleFluid
 });
-import { BufferAttribute as BufferAttribute6, Color as Color8, DoubleSide as DoubleSide3 } from "three";
+import { BufferAttribute as BufferAttribute6, Color as Color9, DoubleSide as DoubleSide3 } from "three";
 function sampleFluid(kind, sample) {
   const cells = [];
   const key = [];
@@ -4512,7 +4585,7 @@ var init_FluidModelObject = __esm({
           }
         }
         geometry.clearGroups();
-        const color = new Color8(this.options.tints?.[0] ?? (this.kind === "water" ? 4159204 : 16777215));
+        const color = new Color9(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);
         geometry.setAttribute("color", new BufferAttribute6(colors, 3));
@@ -4778,6 +4851,59 @@ function shutdown() {
 init_AssetKey();
 init_AssetLoader();
 init_Assets();
+
+// src/assets/BlockEntities.ts
+init_AssetKey();
+init_AssetLoader();
+init_source();
+init_Caching();
+import { Matrix4 as Matrix43 } from "three";
+var 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 (error) {
+        console.warn("Could not load the block entity index; block entities are drawn as plain block models", error);
+        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 Matrix43()) {
+    return matrix.makeTranslation(8, 0, 8).multiply(new Matrix43().makeRotationY(resolved.rotation * Math.PI / 180)).multiply(new Matrix43().makeTranslation(resolved.translation[0] - 8, resolved.translation[1], resolved.translation[2] - 8));
+  }
+};
+
+// src/assets/index.ts
 init_BlockStates();
 
 // src/assets/Entities.ts
@@ -4809,32 +4935,53 @@ var Entities = class {
   static async getLayerList(modelKey) {
     return Object.keys((await this.getModelFile(modelKey))?.layers ?? {});
   }
+  /** The dataset's extra draws on top of `main`; their `when` labels are the states `EntityModelOptions.when` can enable. */
+  static async getPassList(modelKey) {
+    return (await this.getModelFile(modelKey))?.passes ?? [];
+  }
   static async getEntity(modelKey, textureKey, options) {
     const model = await this.getModelFile(modelKey);
     if (!model) return void 0;
-    const names = [...new Set(options?.layers ?? [options?.layer ?? "main"])];
-    if (names.length === 0) throw new MineRenderError(`Entity ${model.id} requires at least one layer`);
-    const selected = names.map((name) => {
-      const layer = model.layers[name];
+    const passes = options?.layers || options?.layer !== void 0 ? [] : (model.passes ?? []).filter((pass) => pass.when === void 0 || options?.when?.includes(pass.when));
+    const draws = [...new Set(options?.layers ?? [options?.layer ?? "main"])].map((layer) => ({ layer }));
+    if (draws.length === 0) throw new MineRenderError(`Entity ${model.id} requires at least one layer`);
+    draws.push(...passes);
+    const names = [];
+    const selected = draws.map((pass) => {
+      const layer = model.layers[pass.layer];
       if (!layer) {
-        throw new MineRenderError(`Entity ${model.id} has no layer "${name}". Available layers: ${Object.keys(model.layers).join(", ")}`);
+        throw new MineRenderError(`Entity ${model.id} has no layer "${pass.layer}". Available layers: ${Object.keys(model.layers).join(", ")}`);
       }
-      return { name, layer };
+      let name = pass.layer;
+      for (let n = 2; names.includes(name); n++) name = `${pass.layer}#${n}`;
+      names.push(name);
+      return { name, layer, pass };
     });
-    const layers = Object.fromEntries(await Promise.all(selected.map(async ({ name, layer }, index) => {
+    const layers = Object.fromEntries(await Promise.all(selected.map(async ({ name, layer, pass }, index) => {
       const override = options?.textures?.[name] ?? (index === 0 ? textureKey : void 0);
+      const textureLocation = pass.textureLocation ?? layer.textureLocation;
       let texture;
       if (override) {
         const path = isAssetKey(override) ? override.getFullPath() : override.path;
         texture = isAssetKey(override) && override.assetType === "textures" && path.startsWith("entity/") ? override : new AssetKey(override.namespace, path, "textures", "entity", "assets", ".png", isAssetKey(override) ? override.root : void 0);
-      } else if (layer.textureLocation !== void 0) {
-        texture = AssetKey.parse("textures", layer.textureLocation.replace(/^([^:]+:)?textures\//, "$1"));
+      } else if (textureLocation !== void 0) {
+        texture = AssetKey.parse("textures", textureLocation.replace(/^([^:]+:)?textures\//, "$1"));
       } else {
         texture = await this.resolveTexture(modelKey);
       }
-      return [name, { key: override ?? modelKey, texture, layer }];
+      const render = pass.render ?? layer.render;
+      return [name, { key: override ?? modelKey, texture, layer, ...render && { render }, ...pass.tint && { tint: pass.tint } }];
     })));
-    return { ...layers[names[0]], id: model.id, layers };
+    return { ...layers[names[0]], id: model.id, layers, ...model.transform && { transform: model.transform } };
+  }
+  /**
+   * Vanilla's keyframe animations of a model by name, or undefined when the model or the selected version has none.
+   */
+  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");
+    const file = await Caching.entityAnimationCache.get(key.serialize(), () => AssetLoader.get(key, "json" /* JSON */));
+    return file?.animations;
   }
   static async resolveTexture(modelKey) {
     const path = isAssetKey(modelKey) ? modelKey.getFullPath() : modelKey.path;
@@ -4912,15 +5059,129 @@ function trimCanvas(source) {
   return canvas;
 }
 
+// src/entity/EntityAnimation.ts
+var ENTITY_ANIMATION_CHANNELS = ["position", "rotation", "scale"];
+function catmullRom(delta, p0, p1, p22, p32) {
+  return 0.5 * (2 * p1 + (p22 - p0) * delta + (2 * p0 - 5 * p1 + 4 * p22 - p32) * delta * delta + (3 * p1 - p0 - 3 * p22 + p32) * delta * delta * delta);
+}
+function sampleEntityKeyframes(keyframes, time) {
+  if (keyframes.length === 0) return [0, 0, 0];
+  let low = 0, high = keyframes.length;
+  while (low < high) {
+    const middle = low + high >>> 1;
+    if (time <= keyframes[middle].time) high = middle;
+    else low = middle + 1;
+  }
+  const a = Math.max(0, low - 1);
+  const b = Math.min(keyframes.length - 1, a + 1);
+  const from = keyframes[a];
+  const to = keyframes[b];
+  const delta = a === b ? 0 : Math.min(1, Math.max(0, (time - from.time) / (to.time - from.time)));
+  if (to.interpolation === "catmullrom") {
+    const before = keyframes[Math.max(0, a - 1)].value;
+    const after = keyframes[Math.min(keyframes.length - 1, b + 1)].value;
+    return [0, 1, 2].map((i) => catmullRom(delta, before[i], from.value[i], to.value[i], after[i]));
+  }
+  const target = to.pre ?? to.value;
+  return [0, 1, 2].map((i) => from.value[i] + (target[i] - from.value[i]) * delta);
+}
+function entityAnimationTime(animation, time, loop = animation.loop) {
+  return loop && animation.length > 0 ? time % animation.length : time;
+}
+function sampleEntityAnimation(animation, time, loop = animation.loop) {
+  const elapsed = entityAnimationTime(animation, time, loop);
+  const pose = {};
+  for (const [name, bone] of Object.entries(animation.bones)) {
+    const sampled = pose[name] = {};
+    for (const channel of ENTITY_ANIMATION_CHANNELS) {
+      const keyframes = bone[channel];
+      if (keyframes?.length) sampled[channel] = sampleEntityKeyframes(keyframes, elapsed);
+    }
+  }
+  return pose;
+}
+
+// src/entity/scene/EntityAnimationPlayer.ts
+var ZERO = [0, 0, 0];
+var EntityAnimationPlayer = class {
+  constructor() {
+    this.parts = [];
+    this._time = 0;
+    this.loop = false;
+    this.speed = 1;
+  }
+  get animation() {
+    return this._animation;
+  }
+  get time() {
+    return this._time;
+  }
+  /**
+   * Starts an animation on the named parts below each layer root. The current pose of a part becomes its default;
+   * bones without a matching part are skipped.
+   */
+  play(layers, animation, options = {}) {
+    this.stop();
+    this._animation = animation;
+    this._time = options.time ?? 0;
+    this.loop = options.loop ?? animation.loop;
+    this.speed = options.speed ?? 1;
+    for (const layer of layers) {
+      for (const bone of Object.keys(animation.bones)) {
+        const object = layer.getObjectByName(`group:${bone}`);
+        if (!object) continue;
+        this.parts.push({ bone, object, position: object.position.clone(), rotation: object.rotation.clone(), scale: object.scale.clone() });
+      }
+    }
+    this.apply();
+  }
+  /** Restores the default poses. Returns whether an animation was active. */
+  stop() {
+    if (!this._animation) return false;
+    for (const part of this.parts) {
+      part.object.position.copy(part.position);
+      part.object.rotation.copy(part.rotation);
+      part.object.scale.copy(part.scale);
+    }
+    this.clear();
+    return true;
+  }
+  /** Forgets the animation without touching the parts, for parts that no longer exist. */
+  clear() {
+    this.parts = [];
+    this._animation = void 0;
+    this._time = 0;
+  }
+  setTime(seconds) {
+    if (!this._animation) return false;
+    this._time = seconds;
+    this.apply();
+    return true;
+  }
+  advance(deltaSeconds) {
+    return this.setTime(this._time + deltaSeconds * this.speed);
+  }
+  apply() {
+    const pose = sampleEntityAnimation(this._animation, this._time, this.loop);
+    for (const part of this.parts) {
+      const { position = ZERO, rotation = ZERO, scale = ZERO } = pose[part.bone];
+      part.object.position.set(part.position.x + position[0], part.position.y + position[1], part.position.z + position[2]);
+      part.object.rotation.set(part.rotation.x + rotation[0], part.rotation.y + rotation[1], part.rotation.z + rotation[2], part.rotation.order);
+      part.object.scale.set(part.scale.x + scale[0], part.scale.y + scale[1], part.scale.z + scale[2]);
+    }
+  }
+};
+
 // src/entity/scene/EntityObject.ts
 init_SceneObject();
 init_Caching();
 var import_ts_deepmerge4 = __toESM(require_dist());
+init_Ticker();
 init_model();
 init_ModelTextures();
 init_AssetKey();
 init_Materials();
-import { Object3D as Object3D3 } from "three";
+import { Color as Color3, Euler as Euler4, Matrix4 as Matrix45, Object3D as Object3D3 } from "three";
 init_three();
 var EntityObject = class _EntityObject extends SceneObject {
   constructor(entity, options) {
@@ -4928,10 +5189,15 @@ var EntityObject = class _EntityObject extends SceneObject {
     this.entity = entity;
     this.isEntityObject = true;
     this.meshesCreated = false;
+    /** Scrolling materials are owned: their texture offset follows this entity's age. */
+    this.scrollMaterials = [];
+    /** Entity age in ticks, as vanilla's `ageInTicks`; drives the scrolling render modes. */
+    this.age = 0;
+    this.animationPlayer = new EntityAnimationPlayer();
     this.options = (0, import_ts_deepmerge4.default)({}, _EntityObject.DEFAULT_OPTIONS, options ?? {});
   }
   static {
-    this.DEFAULT_OPTIONS = (0, import_ts_deepmerge4.default)({}, SceneObject.DEFAULT_OPTIONS, { flip: true });
+    this.DEFAULT_OPTIONS = (0, import_ts_deepmerge4.default)({}, SceneObject.DEFAULT_OPTIONS);
   }
   async init() {
     this.createMeshes();
@@ -4940,6 +5206,59 @@ var EntityObject = class _EntityObject extends SceneObject {
   dispose() {
     super.dispose();
   }
+  disposeAndRemoveAllChildren() {
+    this.clearScrollMaterials();
+    this.animationPlayer.clear();
+    super.disposeAndRemoveAllChildren();
+  }
+  clearScrollMaterials() {
+    Ticker.remove(this.scrollTicker);
+    this.scrollTicker = void 0;
+    for (const { material } of this.scrollMaterials.splice(0)) {
+      material.map?.dispose();
+      material.dispose();
+    }
+  }
+  /** Applies the entity age to the scrolling materials; the ticker calls this 20 times per second. */
+  updateScroll() {
+    for (const { offset, speed } of this.scrollMaterials) {
+      offset.set(this.age * speed[0] % 1, 0 - this.age * speed[1] % 1);
+    }
+    this.notifyDirty();
+  }
+  //<editor-fold desc="ANIMATION">
+  /** The animation started by {@link playAnimation}, until {@link stopAnimation} or disposal. */
+  get animation() {
+    return this.animationPlayer.animation;
+  }
+  /** Seconds since the animation started, before looping. */
+  get animationTime() {
+    return this.animationPlayer.time;
+  }
+  /**
+   * Poses the object from a keyframe animation of {@link Entities.getAnimations}, replacing the current one.
+   * Parts of every layer are matched by name and their current pose is the default the offsets add to.
+   * The object owns no clock: call {@link advanceAnimation} per frame, or {@link setAnimationTime}.
+   */
+  playAnimation(animation, options) {
+    this.createMeshes();
+    const layers = Object.keys(this.entityLayers).map((name) => this.getLayerGroup(name)).filter((layer) => !!layer);
+    this.animationPlayer.play(layers, animation, options);
+    this.notifyDirty();
+  }
+  /** Stops the animation and restores the default pose. */
+  stopAnimation() {
+    if (this.animationPlayer.stop()) this.notifyDirty();
+  }
+  /** Poses the object at an explicit time in seconds. Has no effect without an animation. */
+  setAnimationTime(seconds) {
+    if (this.animationPlayer.setTime(seconds)) this.notifyDirty();
+  }
+  /** Advances the animation by a frame delta in seconds, scaled by its speed. Has no effect without an animation. */
+  advanceAnimation(deltaSeconds) {
+    if (this.animationPlayer.advance(deltaSeconds)) this.notifyDirty();
+  }
+  //</editor-fold>
   getLayerGroup(name) {
     return super.getGroupByName(`layer:${name}`);
   }
@@ -4970,16 +5289,29 @@ var EntityObject = class _EntityObject extends SceneObject {
   createMeshes(force = false) {
     if (this.meshesCreated && !force) return;
     const modelRoot = new Object3D3();
-    if (this.options.flip) modelRoot.scale.set(-1, -1, 1);
+    const transform = this.options.flip === void 0 ? this.entity.transform : void 0;
+    if (transform) {
+      for (const op of transform) {
+        const matrix = new Matrix45();
+        if ("scale" in op) matrix.makeScale(...op.scale);
+        else if ("translate" in op) matrix.makeTranslation(...op.translate);
+        else matrix.makeRotationFromEuler(new Euler4(...op.rotate, "ZYX"));
+        modelRoot.matrix.multiply(matrix);
+      }
+      modelRoot.matrixAutoUpdate = false;
+    } else if (this.options.flip ?? true) {
+      modelRoot.scale.set(-1, -1, 1);
+    }
     this.add(modelRoot);
     Object.entries(this.entityLayers).forEach(([name, layer], index) => {
       const group = this.createGroup(`layer:${name}`);
       modelRoot.add(group);
-      this.createPart("root", layer.layer.root, group, layer.layer.texture, Materials.MISSING_TEXTURE, index);
+      const inward = !Materials.entityModeCulls(layer.render ?? layer.layer.render);
+      this.createPart("root", layer.layer.root, group, layer.layer.texture, Materials.MISSING_TEXTURE, index, inward);
     });
     this.meshesCreated = true;
   }
-  createPart(name, part, parent, textureSize, material, renderOrder) {
+  createPart(name, part, parent, textureSize, material, renderOrder, inward = true) {
     const anchor = this.createGroup(name);
     anchor.position.fromArray(part.pose.offset);
     anchor.rotation.set(...part.pose.rotation, "ZYX");
@@ -4998,7 +5330,7 @@ var EntityObject = class _EntityObject extends SceneObject {
         uv
       ).clone();
       geometry.translate(cube.origin[0] + width / 2, cube.origin[1] + height / 2, cube.origin[2] + depth / 2);
-      if (Math.min(width + growX * 2, height + growY * 2, depth + growZ * 2) > 0) {
+      if (inward && Math.min(width + growX * 2, height + growY * 2, depth + growZ * 2) > 0) {
         const index = Array.from(geometry.getIndex().array);
         geometry.setIndex(index.concat(index.slice().reverse()));
       }
@@ -5008,26 +5340,42 @@ var EntityObject = class _EntityObject extends SceneObject {
       if (this.options.wireframe) addWireframeToMesh(geometry, mesh);
     }
     for (const [childName, child] of Object.entries(part.children)) {
-      this.createPart(childName, child, anchor, size, material, renderOrder);
+      this.createPart(childName, child, anchor, size, material, renderOrder, inward);
     }
   }
   async applyTextures() {
+    this.clearScrollMaterials();
     await Promise.all(Object.entries(this.entityLayers).map(async ([name, layer]) => {
+      const mode = layer.render ?? layer.layer.render ?? "cutout";
+      const tint = layer.tint === void 0 ? void 0 : this.options.tints?.[layer.tint];
+      const scroll = Materials.entityModeScroll(mode);
       const assetKeyStr = this.getTextureKey(layer).serialize();
-      const keyStr = `entity:${assetKeyStr}`;
-      let mat = Caching.materialCache.getIfPresent(keyStr);
+      const keyStr = `entity:${mode}:${tint === void 0 ? "" : new Color3(tint).getHexString()}:${assetKeyStr}`;
+      let mat = scroll ? void 0 : Caching.materialCache.getIfPresent(keyStr);
       if (!mat) {
         const cachedAsset = Caching.textureAssetCache.getIfPresent(assetKeyStr);
         const imageData = await this.loadTextures(layer);
         if (!imageData) return;
         const canvas = imageData.data.canvas;
-        const createMaterial = () => Materials.createBasicCanvasMaterial(canvas);
-        mat = cachedAsset && Caching.textureAssetCache.getIfPresent(assetKeyStr) === cachedAsset ? Caching.materialCache.get(keyStr, createMaterial) : createMaterial();
+        const createMaterial = () => Materials.createEntityCanvasMaterial(canvas, mode, tint);
+        mat = !scroll && cachedAsset && Caching.textureAssetCache.getIfPresent(assetKeyStr) === cachedAsset ? Caching.materialCache.get(keyStr, createMaterial) : createMaterial();
+        if (scroll) {
+          this.scrollMaterials.push({ material: mat, offset: mat.map.offset, speed: scroll });
+        }
       }
       this.getLayerGroup(name)?.traverse((object) => {
         if (isMesh(object)) object.material = mat;
       });
     }));
+    if (!this.children.length) {
+      this.clearScrollMaterials();
+    } else if (this.scrollMaterials.length) {
+      this.updateScroll();
+      this.scrollTicker = Ticker.add(() => {
+        this.age++;
+        this.updateScroll();
+      });
+    }
     this.notifyDirty();
   }
 };
@@ -5039,11 +5387,11 @@ function isEntityObject(obj) {
 init_MineRenderError();
 
 // src/export/SceneExporter.ts
-import { ClampToEdgeWrapping as ClampToEdgeWrapping2, Color as Color6, Float32BufferAttribute as Float32BufferAttribute3, Matrix4 as Matrix45, Mesh as Mesh5, MeshBasicMaterial as MeshBasicMaterial2, NearestFilter as NearestFilter3, RGBAFormat as RGBAFormat3, Scene as Scene4, Source as Source2, Texture as Texture4, UnsignedByteType } from "three";
+import { ClampToEdgeWrapping as ClampToEdgeWrapping2, Color as Color7, Float32BufferAttribute as Float32BufferAttribute3, Matrix4 as Matrix47, Mesh as Mesh5, MeshBasicMaterial as MeshBasicMaterial2, NearestFilter as NearestFilter3, RGBAFormat as RGBAFormat3, Scene as Scene4, Source as Source2, Texture as Texture4, UnsignedByteType } from "three";
 
 // ../../node_modules/three/examples/jsm/exporters/OBJExporter.js
 import {
-  Color as Color3,
+  Color as Color4,
   Matrix3,
   Vector2 as Vector22,
   Vector3 as Vector36
@@ -5055,7 +5403,7 @@ var OBJExporter = class {
     let indexVertexUvs = 0;
     let indexNormals = 0;
     const vertex = new Vector36();
-    const color = new Color3();
+    const color = new Color4();
     const normal = new Vector36();
     const uv = new Vector22();
     const face = [];
@@ -5186,7 +5534,7 @@ var OBJExporter = class {
 import {
   Matrix3 as Matrix32,
   Vector3 as Vector37,
-  Color as Color4
+  Color as Color5
 } from "three";
 var PLYExporter = class {
   parse(object, onDone, options = {}) {
@@ -5244,7 +5592,7 @@ var PLYExporter = class {
         includeIndices = false;
       }
     });
-    const tempColor = new Color4();
+    const tempColor = new Color5();
     includeIndices = includeIndices && excludeAttributes.indexOf("index") === -1;
     includeNormals = includeNormals && excludeAttributes.indexOf("normal") === -1;
     includeColors = includeColors && excludeAttributes.indexOf("color") === -1;
@@ -5456,7 +5804,7 @@ property list uchar int vertex_index
 import {
   BufferAttribute as BufferAttribute3,
   ClampToEdgeWrapping,
-  Color as Color5,
+  Color as Color6,
   DoubleSide as DoubleSide2,
   InterpolateDiscrete,
   InterpolateLinear,
@@ -5465,14 +5813,14 @@ import {
   LinearMipmapLinearFilter,
   LinearMipmapNearestFilter,
   MathUtils as MathUtils2,
-  Matrix4 as Matrix44,
+  Matrix4 as Matrix46,
   MirroredRepeatWrapping,
   NearestFilter as NearestFilter2,
   NearestMipmapLinearFilter,
   NearestMipmapNearestFilter,
   PropertyBinding,
   RGBAFormat as RGBAFormat2,
-  RepeatWrapping,
+  RepeatWrapping as RepeatWrapping2,
   Scene as Scene3,
   Source,
   SRGBColorSpace as SRGBColorSpace4,
@@ -5690,7 +6038,7 @@ THREE_TO_WEBGL[LinearFilter] = WEBGL_CONSTANTS.LINEAR;
 THREE_TO_WEBGL[LinearMipmapNearestFilter] = WEBGL_CONSTANTS.LINEAR_MIPMAP_NEAREST;
 THREE_TO_WEBGL[LinearMipmapLinearFilter] = WEBGL_CONSTANTS.LINEAR_MIPMAP_LINEAR;
 THREE_TO_WEBGL[ClampToEdgeWrapping] = WEBGL_CONSTANTS.CLAMP_TO_EDGE;
-THREE_TO_WEBGL[RepeatWrapping] = WEBGL_CONSTANTS.REPEAT;
+THREE_TO_WEBGL[RepeatWrapping2] = WEBGL_CONSTANTS.REPEAT;
 THREE_TO_WEBGL[MirroredRepeatWrapping] = WEBGL_CONSTANTS.MIRRORED_REPEAT;
 var PATH_PROPERTIES = {
   scale: "scale",
@@ -5698,7 +6046,7 @@ var PATH_PROPERTIES = {
   quaternion: "rotation",
   morphTargetInfluences: "weights"
 };
-var DEFAULT_SPECULAR_COLOR = new Color5();
+var DEFAULT_SPECULAR_COLOR = new Color6();
 var GLB_HEADER_BYTES = 12;
 var GLB_HEADER_MAGIC = 1179937895;
 var GLB_VERSION = 2;
@@ -6755,7 +7103,7 @@ var GLTFWriter = class {
     if (rootJoint === void 0) return null;
     const joints = [];
     const inverseBindMatrices = new Float32Array(skeleton.bones.length * 16);
-    const temporaryBoneInverse = new Matrix44();
+    const temporaryBoneInverse = new Matrix46();
     for (let i = 0; i < skeleton.bones.length; ++i) {
       joints.push(nodeMap.get(skeleton.bones[i]));
       temporaryBoneInverse.copy(skeleton.boneInverses[i]);
@@ -7221,7 +7569,7 @@ var GLTFMeshGpuInstancing = class {
     const translationAttr = new Float32Array(mesh.count * 3);
     const rotationAttr = new Float32Array(mesh.count * 4);
     const scaleAttr = new Float32Array(mesh.count * 3);
-    const matrix = new Matrix44();
+    const matrix = new Matrix46();
     const position = new Vector38();
     const quaternion = new Quaternion4();
     const scale = new Vector38();
@@ -7395,7 +7743,7 @@ var SceneExporter = class {
   }
 };
 function localMatrix(object) {
-  return object.matrixAutoUpdate ? new Matrix45().compose(object.position, object.quaternion, object.scale) : object.matrix.clone();
+  return object.matrixAutoUpdate ? new Matrix47().compose(object.position, object.quaternion, object.scale) : object.matrix.clone();
 }
 function createSnapshot(root, gltf, bakeColors = false) {
   const scene = new Scene4();
@@ -7480,7 +7828,7 @@ function createSnapshot(root, gltf, bakeColors = false) {
       const material = copyMaterial(sourceMaterial, geometry);
       if (!sourceMaterial.vertexColors) geometry.deleteAttribute("color");
       if (bakeColors || instanceColor) {
-        const tint = (material.color ?? new Color6()).clone();
+        const tint = (material.color ?? new Color7()).clone();
         if (instanceColor) tint.multiply(instanceColor);
         if (bakeColors) {
           const original = geometry.getAttribute("color");
@@ -7507,9 +7855,9 @@ function createSnapshot(root, gltf, bakeColors = false) {
       const instanced = mesh;
       if (instanced.isInstancedMesh) {
         for (let i = 0; i < instanced.count; i++) {
-          const matrix = new Matrix45();
+          const matrix = new Matrix47();
           instanced.getMatrixAt(i, matrix);
-          const color = instanced.instanceColor ? new Color6().fromBufferAttribute(instanced.instanceColor, i) : void 0;
+          const color = instanced.instanceColor ? new Color7().fromBufferAttribute(instanced.instanceColor, i) : void 0;
           addMesh(mesh, world.clone().multiply(matrix), color);
         }
       } else {
@@ -7521,7 +7869,7 @@ function createSnapshot(root, gltf, bakeColors = false) {
   try {
     const ancestors = [];
     for (let parent = root.parent; parent; parent = parent.parent) ancestors.unshift(parent);
-    const world = new Matrix45();
+    const world = new Matrix47();
     for (const ancestor of ancestors) {
       if (!ancestor.visible) return { scene, dispose };
       world.multiply(localMatrix(ancestor));
@@ -7588,11 +7936,69 @@ function copyDataTexture(source) {
 }
 
 // src/gui/GuiHelper.ts
+init_AssetKey();
 var GuiHelper = class {
   static inventorySlot(slot, origin = [0, 0], offset = [18, 18], rowSize = 9) {
     const [column, row] = typeof slot === "number" ? [slot % rowSize, Math.floor(slot / rowSize)] : slot;
     return [origin[0] + column * offset[0], origin[1] + row * offset[1]];
   }
+  /** Creates crafting-table layers for ingredients and the result; stack counts are not drawn. */
+  static recipe(recipe, options = {}) {
+    const layers = [
+      { name: "background", texture: "minecraft:gui/container/crafting_table", crop: [0, 0, 176, 166] }
+    ];
+    const itemKey = (ingredient) => {
+      const item = typeof ingredient === "string" && !ingredient.startsWith("#") ? ingredient : typeof ingredient === "object" && "item" in ingredient ? ingredient.item : options.resolveIngredient?.(ingredient);
+      if (isAssetKey(item)) return item;
+      if (!item || item.startsWith("#")) {
+        throw new Error(`Select a concrete item for recipe ingredient ${JSON.stringify(ingredient)}`);
+      }
+      const key = AssetKey.parse("models", item);
+      return new AssetKey(key.namespace, key.getFullPath(), "models", "item");
+    };
+    const addIngredient = (ingredient, slot) => {
+      layers.push({
+        name: `ingredient-${slot}`,
+        item: itemKey(ingredient),
+        position: this.inventorySlot(slot, [30, 17], [18, 18], 3)
+      });
+    };
+    switch (recipe.type) {
+      case "minecraft:crafting_shaped":
+      case "crafting_shaped": {
+        const pattern = recipe.pattern;
+        if (!pattern.length || pattern.length > 3 || !pattern[0].length || pattern[0].length > 3 || pattern.some((row) => row.length !== pattern[0].length)) {
+          throw new Error("Crafting patterns must be rectangular, with 1\u20133 rows and columns");
+        }
+        const cells = pattern.flatMap((row, y) => row.split("").map((symbol, x) => ({ symbol, x, y }))).filter((cell) => cell.symbol !== " ");
+        if (!cells.length) throw new Error("Crafting patterns must contain an ingredient");
+        const minX = Math.min(...cells.map((cell) => cell.x)), maxX = Math.max(...cells.map((cell) => cell.x));
+        const minY = Math.min(...cells.map((cell) => cell.y)), maxY = Math.max(...cells.map((cell) => cell.y));
+        const offsetX = minX === maxX ? 1 : 0, offsetY = minY === maxY ? 1 : 0;
+        for (const { symbol, x, y } of cells) {
+          const ingredient = recipe.key[symbol];
+          if (!ingredient) throw new Error(`Missing recipe ingredient for symbol ${JSON.stringify(symbol)}`);
+          addIngredient(ingredient, (y - minY + offsetY) * 3 + x - minX + offsetX);
+        }
+        break;
+      }
+      case "minecraft:crafting_shapeless":
+      case "crafting_shapeless":
+        if (!recipe.ingredients.length || recipe.ingredients.length > 9) {
+          throw new Error("Shapeless crafting recipes require 1\u20139 ingredients");
+        }
+        recipe.ingredients.forEach(addIngredient);
+        break;
+      default:
+        throw new Error(`Unsupported crafting recipe type: ${recipe.type}`);
+    }
+    layers.push({
+      name: "result",
+      item: itemKey("id" in recipe.result ? recipe.result.id : recipe.result.item),
+      position: [124, 35]
+    });
+    return layers;
+  }
 };
 
 // src/gui/scene/GuiObject.ts
@@ -8180,7 +8586,7 @@ init_ModelMerger();
 init_BlockStates();
 init_MineRenderError();
 init_util();
-import { Euler as Euler6 } from "three";
+import { Euler as Euler7 } from "three";
 function matchesCondition(condition, state) {
   return Object.entries(condition).every(([key, value]) => {
     if (Array.isArray(value)) {
@@ -8255,7 +8661,7 @@ var BlockStateResolver = class {
     return variants[variants.length - 1];
   }
   static rotation(variant) {
-    const rotation = new Euler6();
+    const rotation = new Euler7();
     if (typeof variant.x !== "undefined") {
       rotation.x = toRadians(clampRotationDegrees(variant.x));
     }
@@ -8365,7 +8771,7 @@ var import_ts_deepmerge6 = __toESM(require_dist());
 init_MineRenderError();
 init_InstanceReference();
 init_AssetKey();
-import { Euler as Euler7, Matrix4 as Matrix47, Quaternion as Quaternion5, Vector3 as Vector311 } from "three";
+import { Euler as Euler8, Matrix4 as Matrix49, Quaternion as Quaternion5, Vector3 as Vector311 } from "three";
 init_ModelCulling();
 init_FluidGeometry();
 var BlockObject = class _BlockObject extends SceneObject {
@@ -8382,6 +8788,9 @@ var BlockObject = class _BlockObject extends SceneObject {
     this._variants = [];
     this._models = [];
     this._cullMask = 0;
+    this._entities = [];
+    this._entityPlacement = new Matrix49();
+    this._entityGeneration = 0;
     this.options = (0, import_ts_deepmerge6.default)({}, _BlockObject.DEFAULT_OPTIONS, options ?? {});
   }
   static {
@@ -8406,6 +8815,8 @@ var BlockObject = class _BlockObject extends SceneObject {
   }
   clearModels() {
     this.removeModels(this._models.splice(0));
+    this._entityGeneration++;
+    this.removeEntities(this._entities.splice(0));
     this._fluidKey = void 0;
     this._fluidModel = void 0;
     this._isInstanced = false;
@@ -8417,6 +8828,57 @@ var BlockObject = class _BlockObject extends SceneObject {
       if (!isInstanceReference(model)) model.dispose();
     }
   }
+  removeEntities(entities) {
+    for (const entity of entities) {
+      entity.removeFromScene();
+      entity.dispose();
+    }
+  }
+  /** Entity models drawn for this block instead of its block model; they are scene children, unlike the block. */
+  get blockEntities() {
+    return this._entities;
+  }
+  /**
+   * Draws the block through the dataset's block-entity index. Returns false, leaving nothing behind,
+   * when the block is not listed or one of its models cannot be loaded.
+   */
+  async createBlockEntities() {
+    const key = this.blockState.key;
+    if (!key || this.options.displayPosition) return false;
+    const generation = this._entityGeneration;
+    const created = [];
+    let resolved;
+    try {
+      resolved = BlockEntities.resolve(await BlockEntities.getIndex(key.root), key.toNamespacedString(), this.state);
+      if (!resolved) return false;
+      for (const part of resolved.parts) {
+        const [namespace, path] = part.model.includes(":") ? part.model.split(":") : [key.namespace, part.model];
+        const texture = part.textureLocation === void 0 ? void 0 : AssetKey.parse("textures", part.textureLocation.replace(/^([^:]+:)?textures\//, "$1"));
+        if (texture) texture.root = key.root;
+        const entity = await Entities.getEntity(new BasicAssetKey(namespace, path), texture, { layer: part.layer });
+        if (!entity) throw new MineRenderError(`Missing entity model ${part.model}`);
+        created.push(await this.scene.addEntity(entity, { wireframe: this.options.wireframe }));
+      }
+    } catch (error) {
+      console.warn(`Could not draw block entity ${key.toNamespacedString()}, using its block model`, error);
+      this.removeEntities(created);
+      return false;
+    }
+    if (generation !== this._entityGeneration) {
+      this.removeEntities(created);
+      return true;
+    }
+    BlockEntities.matrix(resolved, this._entityPlacement);
+    this._entities = created;
+    this.placeEntities();
+    return true;
+  }
+  placeEntities() {
+    const matrix = new Matrix49().makeTranslation(this.position.x - 8, this.position.y - 8, this.position.z - 8).multiply(this._entityPlacement);
+    for (const entity of this._entities) {
+      matrix.decompose(entity.position, entity.quaternion, entity.scale);
+    }
+  }
   get isOccluding() {
     return this._models.some((model) => {
       const object = isInstanceReference(model) ? model.instanceable : model;
@@ -8436,7 +8898,7 @@ var BlockObject = class _BlockObject extends SceneObject {
     const scale = new Vector311();
     this.getModelMatrix(model).decompose(position, rotation, scale);
     if (position.distanceToSquared(this.position) > 1e-10 || scale.distanceToSquared(new Vector311(1, 1, 1)) > 1e-10) return 0;
-    return ModelCulling.toLocalMask(worldMask, new Euler7().setFromQuaternion(rotation));
+    return ModelCulling.toLocalMask(worldMask, new Euler8().setFromQuaternion(rotation));
   }
   async setCullMask(worldMask) {
     worldMask &= 63;
@@ -8498,7 +8960,7 @@ var BlockObject = class _BlockObject extends SceneObject {
       () => new FluidModelObject2(kind, surface.sample, this.blockState.key, this.options)
     );
     const previous = this._fluidModel;
-    const matrix = previous ? this.getModelMatrix(previous) : new Matrix47().makeTranslation(...this.position.toArray());
+    const matrix = previous ? this.getModelMatrix(previous) : new Matrix49().makeTranslation(...this.position.toArray());
     if (isInstanceReference(replacement)) replacement.setMatrix(matrix);
     else matrix.decompose(replacement.position, replacement.quaternion, replacement.scale);
     this._models = this._models.filter((model) => model !== previous);
@@ -8528,13 +8990,20 @@ var BlockObject = class _BlockObject extends SceneObject {
       await this.updateFluid(this._fluidSampler);
       return;
     }
+    const hasEntities = await this.createBlockEntities();
     const variantsToCreate = await this.mapStateToVariant(this.state);
     this._variants = variantsToCreate;
     for (let blockStateVariant of variantsToCreate) {
+      if (hasEntities && !await this.hasGeometry(blockStateVariant)) continue;
       this._models.push(await this.createVariant(blockStateVariant));
     }
     await this.updateFluid(this._fluidSampler);
   }
+  async hasGeometry(variant) {
+    const modelKey = AssetKey.parse("models", variant.model);
+    modelKey.root = this.blockState.key?.root;
+    return !!(await Models.getMerged(modelKey))?.elements?.length;
+  }
   getSingleVariant(variants) {
     return BlockStateResolver.choose(variants);
   }
@@ -8629,7 +9098,7 @@ var BlockObject = class _BlockObject extends SceneObject {
   setPositionRotationScaleAt(index, position, rotation, scale) {
     super.setPositionRotationScaleAt(index, position, rotation, scale);
   }
-  getMatrixAt(index, matrix = new Matrix47()) {
+  getMatrixAt(index, matrix = new Matrix49()) {
     if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
     const child = this._models[0];
     if (child && isModelObject(child)) {
@@ -8654,6 +9123,7 @@ var BlockObject = class _BlockObject extends SceneObject {
     for (let model of this._models) {
       model.setPosition(position);
     }
+    this.placeEntities();
     this.notifyDirty();
   }
   //TODO: should override rotation + scale methods
@@ -13191,7 +13661,7 @@ init_CubeFace();
 init_AssetKey();
 init_Models();
 init_CubeFace();
-import { Matrix4 as Matrix48, Vector3 as Vector314 } from "three";
+import { Matrix4 as Matrix410, Vector3 as Vector314 } from "three";
 init_ModelCulling();
 init_ModelObject();
 init_UVMapper();
@@ -13254,7 +13724,7 @@ var SectionModels = class {
         });
         await object.init();
         const geometry = object.children[0].geometry;
-        geometry.applyMatrix4(new Matrix48().makeRotationFromEuler(rotation));
+        geometry.applyMatrix4(new Matrix410().makeRotationFromEuler(rotation));
         object.clear();
         const cullFaces = CUBE_FACES.map((face) => {
           const local = CUBE_FACES.findIndex((name) => name === atlas.model.elements[0].faces[face]?.cullface);
@@ -13666,7 +14136,8 @@ var Chunk = class _Chunk {
         this.data.set(index, void 0);
         return void 0;
       }
-      const template = getFluidKind(blockState.key, stored.properties) ? void 0 : await this.sectionModels?.get(blockState, stored.properties);
+      const perBlock = !this.sectionModels || getFluidKind(blockState.key, stored.properties) || blockState.key && BlockEntities.entry(await BlockEntities.getIndex(blockState.key.root), blockState.key.toNamespacedString());
+      const template = perBlock ? void 0 : await this.sectionModels.get(blockState, stored.properties);
       if (template) {
         this.sectionBlocks.set(index, { index, template, cullMask: 0 });
         this.meshDirty = true;
@@ -13775,6 +14246,7 @@ export {
   BUILTIN_GENERATED,
   BasicAssetKey,
   BatchedExecutor,
+  BlockEntities,
   BlockObject,
   BlockStateResolver,
   BlockStates,
@@ -13796,7 +14268,9 @@ export {
   DefaultBlockStates,
   DisplayPosition,
   DisplayTransforms,
+  ENTITY_ANIMATION_CHANNELS,
   Entities,
+  EntityAnimationPlayer,
   EntityObject,
   Env,
   FluidModelObject,
@@ -13872,6 +14346,7 @@ export {
   createCanvas2 as createCanvas,
   createFluidGeometry,
   createImage,
+  entityAnimationTime,
   estimateBytesUsed,
   getBlockFluidState,
   getFluidKind,
@@ -13904,6 +14379,8 @@ export {
   mergeVertices,
   prefix,
   registerNodeEnv,
+  sampleEntityAnimation,
+  sampleEntityKeyframes,
   sampleFluid,
   serializeBoxGeometryKey,
   serializeImageKey,