minerender 2.1.0-alpha.20 → 2.1.0-alpha.22

package/dist/browser/index.mjs

@@ -412,6 +412,7 @@ var _Caching = class _Caching {
       this.blockStateCache,
       this.listAssetCache,
       this.defaultBlockStatesCache,
+      this.blockTintCache,
       this.entityModelsCache
     ];
   }
@@ -454,6 +455,7 @@ _Caching.modelTextureAtlasCache = Caches.builder().expireAfterWrite(Time.minutes
 _Caching.blockStateCache = Caches.builder().expireAfterWrite(Time.minutes(10)).expireAfterAccess(Time.minutes(5)).expirationInterval(Time.seconds(30)).buildAsync();
 _Caching.listAssetCache = _Caching.createAssetCache();
 _Caching.defaultBlockStatesCache = _Caching.createAssetCache();
+_Caching.blockTintCache = _Caching.createAssetCache();
 _Caching.entityModelsCache = _Caching.createAssetCache();
 var Caching = _Caching;
 
@@ -1091,7 +1093,7 @@ var Meshes = class _Meshes {
 };
 
 // src/UVMapper.ts
-import { Float32BufferAttribute as Float32BufferAttribute2, Vector2, Vector3 as Vector33 } from "three";
+import { Float32BufferAttribute as Float32BufferAttribute2, Vector2, Vector3 as Vector34 } from "three";
 
 // src/model/ModelMerger.ts
 var import_ts_deepmerge = __toESM(require_dist());
@@ -1182,15 +1184,77 @@ function isAssetKey(obj) {
   return isBasicAssetKey(obj) && obj.isAssetKey === true;
 }
 
+// src/model/DisplayTransforms.ts
+import { Euler, Matrix4, Quaternion, Vector3 as Vector32 } from "three";
+
+// src/model/DisplayPosition.ts
+var 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 || {});
+var DISPLAY_POSITIONS = Object.values(DisplayPosition);
+
+// src/model/DisplayTransforms.ts
+var DisplayTransforms = class {
+  /** Resolve hand fallbacks within one model, before inheriting parent display entries. */
+  static withHandFallbacks(display) {
+    if (!display) return void 0;
+    const resolved = { ...display };
+    for (const [left, right] of [
+      ["thirdperson_lefthand" /* THIRDPERSON_LEFTHAND */, "thirdperson_righthand" /* THIRDPERSON_RIGHTHAND */],
+      ["firstperson_lefthand" /* FIRSTPERSON_LEFTHAND */, "firstperson_righthand" /* FIRSTPERSON_RIGHTHAND */]
+    ]) {
+      if (resolved[left] === void 0 && resolved[right] !== void 0) resolved[left] = resolved[right];
+    }
+    return resolved;
+  }
+  /** Build a display pose for geometry already centered at the model's [8, 8, 8] pivot. */
+  static getMatrix(display, position) {
+    const transform = this.withHandFallbacks(display)?.[position] ?? {};
+    const left = position === "firstperson_lefthand" /* FIRSTPERSON_LEFTHAND */ || position === "thirdperson_lefthand" /* THIRDPERSON_LEFTHAND */;
+    const sign = left ? -1 : 1;
+    const [x, y, z] = transform.rotation ?? [0, 0, 0];
+    const rotation = new Quaternion().setFromEuler(new Euler(toRadians(x), sign * toRadians(y), sign * toRadians(z), "XYZ"));
+    const translation = new Vector32(...transform.translation ?? [0, 0, 0]).clampScalar(-80, 80);
+    translation.x *= sign;
+    const scale = new Vector32(...transform.scale ?? [1, 1, 1]).clampScalar(-4, 4);
+    return new Matrix4().compose(translation, rotation, scale);
+  }
+  static apply(geometry, matrix) {
+    geometry.applyMatrix4(matrix);
+    if (matrix.determinant() < 0) {
+      if (!geometry.index) geometry.setIndex(Array.from({ length: geometry.getAttribute("position").count }, (_, i) => i));
+      const index = geometry.index;
+      for (let i = 0; i < index.count; i += 3) {
+        const second = index.getX(i + 1);
+        index.setX(i + 1, index.getX(i + 2));
+        index.setX(i + 2, second);
+      }
+      index.needsUpdate = true;
+    }
+  }
+};
+
 // src/model/ModelMerger.ts
 var ModelMerger = class {
   static async mergeWithParents(model) {
     const models = await this.collectAllParents(model);
     let merged = {};
-    for (let parentModel of models) {
-      merged = import_ts_deepmerge.default.withOptions({ mergeArrays: false }, merged, parentModel);
+    for (const source of [...models, model]) {
+      const inheritedDisplay = merged.display;
+      merged = import_ts_deepmerge.default.withOptions({ mergeArrays: false }, merged, source);
+      if (source.display) {
+        merged.display = { ...inheritedDisplay, ...DisplayTransforms.withHandFallbacks(source.display) };
+      }
     }
-    merged = import_ts_deepmerge.default.withOptions({ mergeArrays: false }, merged, model);
     merged.hierarchy = models.map((m) => m.parent).filter((p12) => `${p12}`);
     merged.hierarchy.push(`${merged.parent}`);
     return merged;
@@ -1445,9 +1509,9 @@ var BatchedExecutor = class {
 };
 
 // src/util/model.ts
-import { AxesHelper, BoxGeometry as BoxGeometry2, EdgesGeometry, LineBasicMaterial, LineSegments, Vector3 as Vector32 } from "three";
+import { AxesHelper, BoxGeometry as BoxGeometry2, EdgesGeometry, LineBasicMaterial, LineSegments, Vector3 as Vector33 } from "three";
 function applyElementRotation(rotation, geometry) {
-  const origin = new Vector32(rotation.origin[0], rotation.origin[1], rotation.origin[2]);
+  const origin = new Vector33(rotation.origin[0], rotation.origin[1], rotation.origin[2]);
   geometry.translate(-origin.x, -origin.y, -origin.z);
   switch (rotation.axis) {
     case "x" /* X */:
@@ -1472,7 +1536,7 @@ function applyElementRotation(rotation, geometry) {
   geometry.translate(origin.x, origin.y, origin.z);
 }
 function applyModelPartRotation(modelPart, geometry) {
-  const origin = new Vector32(modelPart.pivotX, modelPart.pivotY, modelPart.pivotZ);
+  const origin = new Vector33(modelPart.pivotX, modelPart.pivotY, modelPart.pivotZ);
   geometry.translate(-origin.x, -origin.y, -origin.z);
   geometry.rotateX(toRadians(modelPart.pitch));
   geometry.rotateY(toRadians(modelPart.yaw));
@@ -1482,18 +1546,18 @@ function applyModelPartRotation(modelPart, geometry) {
 function applyGenericRotation(axis, rotation, obj) {
   switch (axis) {
     case "x" /* X */:
-      obj.rotateOnAxis(new Vector32(1, 0, 0), toRadians(rotation));
+      obj.rotateOnAxis(new Vector33(1, 0, 0), toRadians(rotation));
       break;
     case "y" /* Y */:
-      obj.rotateOnAxis(new Vector32(0, 1, 0), toRadians(rotation));
+      obj.rotateOnAxis(new Vector33(0, 1, 0), toRadians(rotation));
       break;
     case "z" /* Z */:
-      obj.rotateOnAxis(new Vector32(0, 0, 1), toRadians(rotation));
+      obj.rotateOnAxis(new Vector33(0, 0, 1), toRadians(rotation));
       break;
   }
 }
 function addBox3WireframeToObject(box, obj, color = 16777215, w = 2) {
-  let size = new Vector32();
+  let size = new Vector33();
   box.getSize(size);
   let boxGeo = new BoxGeometry2(size.x, size.y, size.z, 1, 1, 1);
   let wireGeo = new EdgesGeometry(boxGeo);
@@ -2061,12 +2125,12 @@ var X = 0;
 var Y = 1;
 var Z = 2;
 var FACE_UV_AXES = {
-  east: [new Vector33(0, 0, -1), new Vector33(0, -1, 0)],
-  west: [new Vector33(0, 0, 1), new Vector33(0, -1, 0)],
-  up: [new Vector33(1, 0, 0), new Vector33(0, 0, 1)],
-  down: [new Vector33(1, 0, 0), new Vector33(0, 0, -1)],
-  south: [new Vector33(1, 0, 0), new Vector33(0, -1, 0)],
-  north: [new Vector33(-1, 0, 0), new Vector33(0, -1, 0)]
+  east: [new Vector34(0, 0, -1), new Vector34(0, -1, 0)],
+  west: [new Vector34(0, 0, 1), new Vector34(0, -1, 0)],
+  up: [new Vector34(1, 0, 0), new Vector34(0, 0, 1)],
+  down: [new Vector34(1, 0, 0), new Vector34(0, 0, -1)],
+  south: [new Vector34(1, 0, 0), new Vector34(0, -1, 0)],
+  north: [new Vector34(-1, 0, 0), new Vector34(0, -1, 0)]
 };
 var UVMapper = class {
   static makeUv(uvCoord, originalTextureSize, actualTextureSize) {
@@ -2647,7 +2711,7 @@ var BlockEntityModels = class {
 };
 
 // src/renderer/SceneObject.ts
-import { Euler as Euler2, InstancedMesh, MathUtils, Matrix4 as Matrix42, Mesh as Mesh3, Object3D as Object3D2, Quaternion as Quaternion2, Vector3 as Vector34 } from "three";
+import { Euler as Euler3, InstancedMesh, MathUtils, Matrix4 as Matrix43, Mesh as Mesh3, Object3D as Object3D2, Quaternion as Quaternion3, Vector3 as Vector35 } from "three";
 
 // src/instance/InstanceReference.ts
 var InstanceReference = class {
@@ -2884,7 +2948,7 @@ var _SceneObject = class _SceneObject extends Object3D2 {
   nextInstance() {
     if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
     const i = this._instanceCounter++;
-    this.setMatrixAt(i, new Matrix42());
+    this.setMatrixAt(i, new Matrix43());
     const mesh = this.children[0];
     if (mesh && isInstancedMesh(mesh)) {
       mesh.count = Math.min(this._instanceCounter, mesh.instanceMatrix.count);
@@ -2901,7 +2965,7 @@ var _SceneObject = class _SceneObject extends Object3D2 {
   }
   //</editor-fold>
   //<editor-fold desc="TRANSFORMATION">
-  getMatrixAt(index, matrix = new Matrix42()) {
+  getMatrixAt(index, matrix = new Matrix43()) {
     if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
     const child = this.children[0];
     if (child && isInstancedMesh(child)) {
@@ -2920,16 +2984,16 @@ var _SceneObject = class _SceneObject extends Object3D2 {
   }
   setPositionRotationScaleAt(index, position, rotation, scale) {
     if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
-    const oldPosition = new Vector34();
-    const oldRotation = new Quaternion2();
-    const oldScale = new Vector34();
-    const matrix = new Matrix42();
+    const oldPosition = new Vector35();
+    const oldRotation = new Quaternion3();
+    const oldScale = new Vector35();
+    const matrix = new Matrix43();
     if (!scale || !rotation || !position) {
       this.getMatrixAt(index, matrix).decompose(oldPosition, oldRotation, oldScale);
     }
     matrix.compose(
       position ? position : oldPosition,
-      rotation ? new Quaternion2().setFromEuler(rotation) : oldRotation,
+      rotation ? new Quaternion3().setFromEuler(rotation) : oldRotation,
       scale ? scale : oldScale
     );
     this.setMatrixAt(index, matrix);
@@ -2938,7 +3002,7 @@ var _SceneObject = class _SceneObject extends Object3D2 {
     if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
     this.setPositionRotationScaleAt(index, position);
   }
-  getPositionAt(index, vector = new Vector34()) {
+  getPositionAt(index, vector = new Vector35()) {
     if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
     const matrix = this.getMatrixAt(index);
     vector.setFromMatrixPosition(matrix);
@@ -2948,7 +3012,7 @@ var _SceneObject = class _SceneObject extends Object3D2 {
     if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
     this.setPositionRotationScaleAt(index, void 0, rotation, void 0);
   }
-  getRotationAt(index, euler = new Euler2()) {
+  getRotationAt(index, euler = new Euler3()) {
     if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
     const matrix = this.getMatrixAt(index);
     euler.setFromRotationMatrix(matrix);
@@ -2958,7 +3022,7 @@ var _SceneObject = class _SceneObject extends Object3D2 {
     if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
     this.setPositionRotationScaleAt(index, void 0, void 0, scale);
   }
-  getScaleAt(index, vector = new Vector34()) {
+  getScaleAt(index, vector = new Vector35()) {
     if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
     const matrix = this.getMatrixAt(index);
     vector.setFromMatrixScale(matrix);
@@ -3584,20 +3648,6 @@ function isInstanceable(obj) {
   return "nextInstance" in obj;
 }
 
-// src/model/DisplayPosition.ts
-var 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";
-  return DisplayPosition2;
-})(DisplayPosition || {});
-var DISPLAY_POSITIONS = Object.values(DisplayPosition);
-
 // src/model/GuiLight.ts
 var GuiLight = /* @__PURE__ */ ((GuiLight2) => {
   GuiLight2["FRONT"] = "front";
@@ -3620,8 +3670,93 @@ function isQuadArray(obj) {
   return Array.isArray(obj) && obj.length === 4;
 }
 
+// src/model/block/blockTints.json
+var blockTints_default = {
+  "minecraft:large_fern": { source: "grass" },
+  "minecraft:tall_grass": { source: "grass" },
+  "minecraft:grass_block": { source: "grass" },
+  "minecraft:fern": { source: "grass" },
+  "minecraft:grass": { source: "grass" },
+  "minecraft:short_grass": { source: "grass" },
+  "minecraft:potted_fern": { source: "grass" },
+  "minecraft:bush": { source: "grass" },
+  "minecraft:pink_petals": { source: "grass", untinted: [0] },
+  "minecraft:wildflowers": { source: "grass", untinted: [0] },
+  "minecraft:spruce_leaves": { source: "constant", color: 6396257 },
+  "minecraft:birch_leaves": { source: "constant", color: 8431445 },
+  "minecraft:oak_leaves": { source: "constant", color: 4764952 },
+  "minecraft:jungle_leaves": { source: "constant", color: 4764952 },
+  "minecraft:acacia_leaves": { source: "constant", color: 4764952 },
+  "minecraft:dark_oak_leaves": { source: "constant", color: 4764952 },
+  "minecraft:vine": { source: "constant", color: 4764952 },
+  "minecraft:mangrove_leaves": { source: "constant", color: 4764952 },
+  "minecraft:leaf_litter": { source: "constant", color: 6044722 },
+  "minecraft:water_cauldron": { source: "constant", color: 4159204 },
+  "minecraft:redstone_wire": { source: "redstone" },
+  "minecraft:attached_melon_stem": { source: "constant", color: 14731036 },
+  "minecraft:attached_pumpkin_stem": { source: "constant", color: 14731036 },
+  "minecraft:melon_stem": { source: "stem" },
+  "minecraft:pumpkin_stem": { source: "stem" },
+  "minecraft:lily_pad": { source: "constant", color: 7455580 }
+};
+
+// src/model/block/BlockTints.ts
+var rules = blockTints_default;
+var BlockTints = class {
+  /** Resolves block preview colors without biome context; explicit tints take precedence. */
+  static async get(key, state, model, tints) {
+    const rule = key && rules[key.toNamespacedString()];
+    if (!key || !rule) return tints;
+    const indices = /* @__PURE__ */ new Set();
+    for (const element of model.elements ?? []) {
+      for (const face of Object.values(element.faces)) {
+        const index = face?.tintindex;
+        if (index !== void 0 && index >= 0 && tints?.[index] === void 0 && !rule.untinted?.includes(index)) {
+          indices.add(index);
+        }
+      }
+    }
+    if (!indices.size) return tints;
+    let color;
+    switch (rule.source) {
+      case "constant":
+        color = rule.color;
+        break;
+      case "grass":
+        color = await this.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);
+        break;
+      }
+      case "stem": {
+        const age = Number(state.age ?? 0);
+        color = age * 32 << 16 | 255 - age * 8 << 8 | age * 4;
+        break;
+      }
+    }
+    return { ...Object.fromEntries([...indices].map((index) => [index, color])), ...tints };
+  }
+  static async grassColor(origin) {
+    const key = AssetKey.parse("textures", "minecraft:colormap/grass", origin);
+    return await Caching.blockTintCache.get(key.serialize(), async () => {
+      const image = await ModelTextures.get(key);
+      if (!image) throw new MineRenderError(`Missing grass colormap: ${key.toNamespacedString()}`);
+      if (image.width !== 256 || image.height !== 256) {
+        throw new MineRenderError("Grass colormaps must be 256 \xD7 256 pixels");
+      }
+      const [red, green, blue] = image.data.getImageData(127, 127, 1, 1).data;
+      return red << 16 | green << 8 | blue;
+    });
+  }
+};
+
 // src/model/scene/ModelObject.ts
-import { BoxGeometry as BoxGeometry5, BufferAttribute as BufferAttribute4, Color as Color3, Euler as Euler4, Matrix4 as Matrix45 } from "three";
+import { BoxGeometry as BoxGeometry5, BufferAttribute as BufferAttribute4, Color as Color3, Euler as Euler5, Matrix4 as Matrix46 } from "three";
 
 // src/three/BufferGeometryUtils.js
 import {
@@ -3633,7 +3768,7 @@ import {
   TriangleFanDrawMode,
   TriangleStripDrawMode,
   TrianglesDrawMode,
-  Vector3 as Vector36
+  Vector3 as Vector37
 } from "three";
 function computeTangents(geometry) {
   geometry.computeTangents();
@@ -3952,15 +4087,15 @@ function computeMorphedAttributes(object) {
     console.error("THREE.BufferGeometryUtils: Geometry is not of type BufferGeometry.");
     return null;
   }
-  const _vA = new Vector36();
-  const _vB = new Vector36();
-  const _vC = new Vector36();
-  const _tempA = new Vector36();
-  const _tempB = new Vector36();
-  const _tempC = new Vector36();
-  const _morphA = new Vector36();
-  const _morphB = new Vector36();
-  const _morphC = new Vector36();
+  const _vA = new Vector37();
+  const _vB = new Vector37();
+  const _vC = new Vector37();
+  const _tempA = new Vector37();
+  const _tempB = new Vector37();
+  const _tempC = new Vector37();
+  const _morphA = new Vector37();
+  const _morphB = new Vector37();
+  const _morphC = new Vector37();
   function _calculateMorphedAttributeData(object2, material2, attribute, morphAttribute, morphTargetsRelative2, a2, b2, c2, modifiedAttributeArray) {
     _vA.fromBufferAttribute(attribute, a2);
     _vB.fromBufferAttribute(attribute, b2);
@@ -4197,13 +4332,14 @@ var _ModelObject = class _ModelObject extends SceneObject {
   createMeshes(force = false) {
     if (this.meshesCreated && !force) return;
     const mat = Materials.MISSING_TEXTURE;
+    const displayTransform = this.options.displayPosition ? DisplayTransforms.getMatrix(this.originalModel.display, this.options.displayPosition) : void 0;
     let allGeos = [];
     if (this.atlas) {
       if (this.atlas.model.elements) {
         this.atlas.model.elements?.forEach((el) => {
           const elGeo = this._getBoxGeometryFromElement(el).clone();
           if (this.options.uvLockRotation) {
-            UVMapper.lockUvs(elGeo, el.faces, this.atlas, new Euler4(...this.options.uvLockRotation));
+            UVMapper.lockUvs(elGeo, el.faces, this.atlas, new Euler5(...this.options.uvLockRotation));
           }
           if (this.options.tints) {
             const colors = new Float32Array(elGeo.getAttribute("position").count * 3).fill(1);
@@ -4219,12 +4355,13 @@ var _ModelObject = class _ModelObject extends SceneObject {
             }
             elGeo.setAttribute("color", new BufferAttribute4(colors, 3));
           }
-          elGeo.applyMatrix4(new Matrix45().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 Matrix45().makeTranslation(el.from[0], el.from[1], el.from[2]));
+          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]));
           if (el.rotation) {
             applyElementRotation(el.rotation, elGeo);
           }
-          elGeo.applyMatrix4(new Matrix45().makeTranslation(-8, -8, -8));
+          elGeo.applyMatrix4(new Matrix46().makeTranslation(-8, -8, -8));
+          if (displayTransform) DisplayTransforms.apply(elGeo, displayTransform);
           if (this.options.mergeMeshes) {
             allGeos.push(elGeo);
           } else {
@@ -4246,6 +4383,7 @@ var _ModelObject = class _ModelObject extends SceneObject {
         combinedGeo = mergeBufferGeometries(allGeos);
       } else {
         combinedGeo = new BoxGeometry5(16, 16, 16);
+        if (displayTransform) DisplayTransforms.apply(combinedGeo, displayTransform);
       }
       combinedGeo.computeBoundingBox();
       let mesh;
@@ -4299,7 +4437,7 @@ function isModelObject(obj) {
 
 // src/model/block/scene/BlockObject.ts
 var import_ts_deepmerge6 = __toESM(require_dist());
-import { Euler as Euler5, Matrix4 as Matrix46, Vector3 as Vector37 } from "three";
+import { Euler as Euler6, Matrix4 as Matrix47, Vector3 as Vector38 } from "three";
 var p10 = prefix("BlockObject");
 function matchesCondition(condition, state) {
   return Object.entries(condition).every(([key, value]) => {
@@ -4356,7 +4494,7 @@ var _BlockObject = class _BlockObject extends SceneObject {
       if (isModelObject(model)) {
         model.removeFromScene();
       } else if (isInstanceReference(model)) {
-        model.setScale(new Vector37(0, 0, 0));
+        model.setScale(new Vector38(0, 0, 0));
       }
     }
     super.removeFromScene();
@@ -4417,7 +4555,7 @@ var _BlockObject = class _BlockObject extends SceneObject {
     }
     for (let model of this._models) {
       if (isInstanceReference(model)) {
-        model.setScale(new Vector37(0, 0, 0));
+        model.setScale(new Vector38(0, 0, 0));
       } else {
         model.dispose();
       }
@@ -4454,7 +4592,7 @@ var _BlockObject = class _BlockObject extends SceneObject {
     await this.createVariant(variant);
   }
   async createVariant(variant) {
-    const rotation = new Euler5();
+    const rotation = new Euler6();
     if (typeof variant.x !== "undefined") {
       rotation.x = toRadians(clampRotationDegrees(variant.x));
     }
@@ -4464,6 +4602,7 @@ var _BlockObject = class _BlockObject extends SceneObject {
     const model = await Models.getMerged(AssetKey.parse("models", variant.model));
     const options = {
       ...this.options,
+      tints: model ? await BlockTints.get(this.blockState.key, this.state, model, this.options.tints) : this.options.tints,
       uvLockRotation: variant.uvlock && (rotation.x !== 0 || rotation.y !== 0) ? [rotation.x, rotation.y, rotation.z] : void 0
     };
     const obj = await this.scene.addModel(model, options);
@@ -4540,7 +4679,7 @@ var _BlockObject = class _BlockObject extends SceneObject {
   setPositionRotationScaleAt(index, position, rotation, scale) {
     super.setPositionRotationScaleAt(index, position, rotation, scale);
   }
-  getMatrixAt(index, matrix = new Matrix46()) {
+  getMatrixAt(index, matrix = new Matrix47()) {
     if (!this.isInstanced) throw new MineRenderError("Object is not instanced");
     const child = this._models[0];
     if (child && isModelObject(child)) {
@@ -5536,7 +5675,8 @@ var _MineRenderScene = class _MineRenderScene extends Scene2 {
       console.log("instanceMeshes + key");
       let key = asset.key.serialize();
       if (isModelObject(obj)) {
-        const { uvLockRotation, tints } = obj.options;
+        const { displayPosition, uvLockRotation, tints } = obj.options;
+        if (displayPosition) key += `|display:${displayPosition}`;
         if (uvLockRotation) key += `|uvlock:${uvLockRotation.join(",")}`;
         const palette = Object.entries(tints ?? {}).sort(([a], [b]) => Number(a) - Number(b));
         if (palette.length) key += `|tints:${JSON.stringify(palette)}`;
@@ -5585,7 +5725,7 @@ function isMineRenderScene(obj) {
 }
 
 // src/renderer/Renderer.ts
-import { AxesHelper as AxesHelper3, GridHelper, OrthographicCamera, PCFSoftShadowMap, PerspectiveCamera, SRGBColorSpace as SRGBColorSpace3, Vector3 as Vector39, WebGLRenderer } from "three";
+import { AxesHelper as AxesHelper3, GridHelper, OrthographicCamera, PCFSoftShadowMap, PerspectiveCamera, SRGBColorSpace as SRGBColorSpace3, Vector3 as Vector310, WebGLRenderer } from "three";
 var import_ts_deepmerge9 = __toESM(require_dist());
 import Stats from "stats.js";
 import { EffectComposer, RenderPass } from "postprocessing";
@@ -5594,11 +5734,11 @@ import { EffectComposer, RenderPass } from "postprocessing";
 import {
   EventDispatcher,
   MOUSE,
-  Quaternion as Quaternion3,
+  Quaternion as Quaternion4,
   Spherical,
   TOUCH,
   Vector2 as Vector23,
-  Vector3 as Vector38
+  Vector3 as Vector39
 } from "three";
 var _changeEvent = { type: "change" };
 var _startEvent = { type: "start" };
@@ -5612,7 +5752,7 @@ var OrbitControls = class extends EventDispatcher {
     this.domElement = domElement;
     this.domElement.style.touchAction = "none";
     this.enabled = true;
-    this.target = new Vector38();
+    this.target = new Vector39();
     this.minDistance = 0;
     this.maxDistance = Infinity;
     this.minZoom = 0;
@@ -5664,11 +5804,11 @@ var OrbitControls = class extends EventDispatcher {
       state = STATE.NONE;
     };
     this.update = function() {
-      const offset = new Vector38();
-      const quat = new Quaternion3().setFromUnitVectors(object.up, new Vector38(0, 1, 0));
+      const offset = new Vector39();
+      const quat = new Quaternion4().setFromUnitVectors(object.up, new Vector39(0, 1, 0));
       const quatInverse = quat.clone().invert();
-      const lastPosition = new Vector38();
-      const lastQuaternion = new Quaternion3();
+      const lastPosition = new Vector39();
+      const lastQuaternion = new Quaternion4();
       const twoPI = 2 * Math.PI;
       return function update() {
         const position = scope.object.position;
@@ -5757,7 +5897,7 @@ var OrbitControls = class extends EventDispatcher {
     const spherical = new Spherical();
     const sphericalDelta = new Spherical();
     let scale = 1;
-    const panOffset = new Vector38();
+    const panOffset = new Vector39();
     let zoomChanged = false;
     const rotateStart = new Vector23();
     const rotateEnd = new Vector23();
@@ -5783,7 +5923,7 @@ var OrbitControls = class extends EventDispatcher {
       sphericalDelta.phi -= angle;
     }
     const panLeft = function() {
-      const v = new Vector38();
+      const v = new Vector39();
       return function panLeft2(distance, objectMatrix) {
         v.setFromMatrixColumn(objectMatrix, 0);
         v.multiplyScalar(-distance);
@@ -5791,7 +5931,7 @@ var OrbitControls = class extends EventDispatcher {
       };
     }();
     const panUp = function() {
-      const v = new Vector38();
+      const v = new Vector39();
       return function panUp2(distance, objectMatrix) {
         if (scope.screenSpacePanning === true) {
           v.setFromMatrixColumn(objectMatrix, 1);
@@ -5804,7 +5944,7 @@ var OrbitControls = class extends EventDispatcher {
       };
     }();
     const pan = function() {
-      const offset = new Vector38();
+      const offset = new Vector39();
       return function pan2(deltaX, deltaY) {
         const element = scope.domElement;
         if (scope.object.isPerspectiveCamera) {
@@ -6551,8 +6691,8 @@ _Renderer.DEFAULT_OPTIONS = (0, import_ts_deepmerge9.default)({}, {
       top: void 0,
       bottom: void 0
     },
-    position: new Vector39(50, 50, 50),
-    lookingAt: new Vector39(0, 0, 0)
+    position: new Vector310(50, 50, 50),
+    lookingAt: new Vector310(0, 0, 0)
   },
   render: {
     fpsLimit: 60,
@@ -6746,10 +6886,10 @@ var Skins = class {
 };
 
 // src/world/Chunk.ts
-import { Box3 as Box32, Object3D as Object3D6, Vector3 as Vector311 } from "three";
+import { Box3 as Box32, Object3D as Object3D6, Vector3 as Vector312 } from "three";
 
 // src/world/MineRenderWorld.ts
-import { Vector3 as Vector310 } from "three";
+import { Vector3 as Vector311 } from "three";
 var MineRenderWorld = class {
   constructor(scene) {
     this._size = 4;
@@ -6760,10 +6900,10 @@ var MineRenderWorld = class {
   }
   getBlockAt(posOrX, y, z) {
     if (typeof posOrX == "number") {
-      return this.getBlockAt(new Vector310(posOrX, y, z));
+      return this.getBlockAt(new Vector311(posOrX, y, z));
     }
     if (isTripleArray(posOrX)) {
-      return this.getBlockAt(new Vector310(posOrX[0], posOrX[1], posOrX[2]));
+      return this.getBlockAt(new Vector311(posOrX[0], posOrX[1], posOrX[2]));
     }
     const chunk = this.getChunkAt(posOrX);
     if (typeof chunk === "undefined") {
@@ -6774,10 +6914,10 @@ var MineRenderWorld = class {
   }
   async setBlockAt(posOrX, yOrBlock, z, block) {
     if (typeof posOrX == "number") {
-      return this.setBlockAt(new Vector310(posOrX, yOrBlock, z), block);
+      return this.setBlockAt(new Vector311(posOrX, yOrBlock, z), block);
     }
     if (isTripleArray(posOrX)) {
-      return this.setBlockAt(new Vector310(posOrX[0], posOrX[1], posOrX[2]), yOrBlock);
+      return this.setBlockAt(new Vector311(posOrX[0], posOrX[1], posOrX[2]), yOrBlock);
     }
     this.validatePosBounds(posOrX);
     const chunk = this.getOrCreateChunkAt(posOrX);
@@ -6823,14 +6963,14 @@ var MineRenderWorld = class {
     return this._chunks[index];
   }
   static worldToScenePosition(pos) {
-    return new Vector310(
+    return new Vector311(
       pos.x * 16,
       pos.y * 16,
       pos.z * 16
     );
   }
   static sceneToWorldPosition(pos) {
-    return new Vector310(
+    return new Vector311(
       pos.x / 16,
       pos.y / 16,
       pos.z / 16
@@ -6872,7 +7012,7 @@ var Chunk = class _Chunk {
     scene.add(anchor);
     anchor.position.set(this.x * 256 + 128 - 8, this.y * 256 + 128 - 8, this.z * 256 + 128 - 8);
     addBox3WireframeToObject(
-      new Box32(new Vector311(0, 0, 0), new Vector311(256, 256, 256)),
+      new Box32(new Vector312(0, 0, 0), new Vector312(256, 256, 256)),
       anchor,
       16776960,
       4
@@ -6880,10 +7020,10 @@ var Chunk = class _Chunk {
   }
   getBlockAt(posOrX, y, z) {
     if (typeof posOrX == "number") {
-      return this.getBlockAt(new Vector311(posOrX, y, z));
+      return this.getBlockAt(new Vector312(posOrX, y, z));
     }
     if (isTripleArray(posOrX)) {
-      return this.getBlockAt(new Vector311(posOrX[0], posOrX[1], posOrX[2]));
+      return this.getBlockAt(new Vector312(posOrX[0], posOrX[1], posOrX[2]));
     }
     const pos = this.worldPosToChunkPos(posOrX);
     const index = _Chunk.chunkPosToBlockIndex(pos);
@@ -6891,10 +7031,10 @@ var Chunk = class _Chunk {
   }
   async setBlockAt(posOrX, yOrBlock, z, block) {
     if (typeof posOrX == "number") {
-      return this.setBlockAt(new Vector311(posOrX, yOrBlock, z), block);
+      return this.setBlockAt(new Vector312(posOrX, yOrBlock, z), block);
     }
     if (isTripleArray(posOrX)) {
-      return this.setBlockAt(new Vector311(posOrX[0], posOrX[1], posOrX[2]), yOrBlock);
+      return this.setBlockAt(new Vector312(posOrX[0], posOrX[1], posOrX[2]), yOrBlock);
     }
     const worldPos = posOrX;
     const pos = this.worldPosToChunkPos(worldPos);
@@ -6940,7 +7080,7 @@ var Chunk = class _Chunk {
   }
   async clear() {
     let promises = [];
-    let pos = new Vector311();
+    let pos = new Vector312();
     for (let x = 0; x < 16; x++) {
       for (let z = 0; z < 16; z++) {
         for (let y = 0; y < 16; y++) {
@@ -6959,14 +7099,14 @@ var Chunk = class _Chunk {
     return pos.y * 16 * 16 + pos.z * 16 + pos.x;
   }
   worldPosToChunkPos(pos) {
-    return new Vector311(
+    return new Vector312(
       pos.x - this.x * 16,
       pos.y - this.y * 16,
       pos.z - this.z * 16
     );
   }
   chunkPosToWorldPos(pos) {
-    return new Vector311(
+    return new Vector312(
       this.x * 16 + pos.x,
       this.y * 16 + pos.y,
       this.z * 16 + pos.z
@@ -6990,6 +7130,7 @@ export {
   BlockEntityModels,
   BlockObject,
   BlockStates,
+  BlockTints,
   BrowserArchiveProxy,
   BrowserCache,
   BrowserEnv,
@@ -7006,6 +7147,7 @@ export {
   DISPLAY_POSITIONS,
   DefaultBlockStates,
   DisplayPosition,
+  DisplayTransforms,
   Entities,
   EntityModels,
   EntityObject,