minerender 2.1.0-alpha.125 → 2.1.0-alpha.128

package/dist/browser/index.mjs

@@ -1208,118 +1208,6 @@ var init_Materials = __esm({
   }
 });
 
-// src/model/Model.ts
-function isDoubleArray(obj) {
-  return Array.isArray(obj) && obj.length === 2;
-}
-function isTripleArray(obj) {
-  return Array.isArray(obj) && obj.length === 3;
-}
-function isQuadArray(obj) {
-  return Array.isArray(obj) && obj.length === 4;
-}
-var ITEM_GENERATED, BUILTIN_GENERATED, BUILTIN_ENTITY, DEFAULT_ELEMENTS;
-var init_Model = __esm({
-  "src/model/Model.ts"() {
-    ITEM_GENERATED = "item/generated";
-    BUILTIN_GENERATED = "builtin/generated";
-    BUILTIN_ENTITY = "builtin/entity";
-    DEFAULT_ELEMENTS = [];
-  }
-});
-
-// ../../node_modules/ts-deepmerge/dist/index.js
-var require_dist = __commonJS({
-  "../../node_modules/ts-deepmerge/dist/index.js"(exports) {
-    "use strict";
-    var __assign = exports && exports.__assign || function() {
-      __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-          s = arguments[i];
-          for (var p11 in s) if (Object.prototype.hasOwnProperty.call(s, p11))
-            t[p11] = s[p11];
-        }
-        return t;
-      };
-      return __assign.apply(this, arguments);
-    };
-    var __read = exports && exports.__read || function(o, n) {
-      var m = typeof Symbol === "function" && o[Symbol.iterator];
-      if (!m) return o;
-      var i = m.call(o), r, ar = [], e;
-      try {
-        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
-      } catch (error) {
-        e = { error };
-      } finally {
-        try {
-          if (r && !r.done && (m = i["return"])) m.call(i);
-        } finally {
-          if (e) throw e.error;
-        }
-      }
-      return ar;
-    };
-    var __spreadArray = exports && exports.__spreadArray || function(to, from, pack) {
-      if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-          if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-          ar[i] = from[i];
-        }
-      }
-      return to.concat(ar || Array.prototype.slice.call(from));
-    };
-    Object.defineProperty(exports, "__esModule", { value: true });
-    var isObject = function(obj) {
-      if (typeof obj === "object" && obj !== null) {
-        if (typeof Object.getPrototypeOf === "function") {
-          var prototype = Object.getPrototypeOf(obj);
-          return prototype === Object.prototype || prototype === null;
-        }
-        return Object.prototype.toString.call(obj) === "[object Object]";
-      }
-      return false;
-    };
-    var PROTECTED_KEYS = ["__proto__"];
-    var merge10 = function() {
-      var objects = [];
-      for (var _i = 0; _i < arguments.length; _i++) {
-        objects[_i] = arguments[_i];
-      }
-      return objects.reduce(function(result, current) {
-        Object.keys(current).forEach(function(key) {
-          if (PROTECTED_KEYS.includes(key)) {
-            return;
-          }
-          if (Array.isArray(result[key]) && Array.isArray(current[key])) {
-            result[key] = merge10.options.mergeArrays ? Array.from(new Set(result[key].concat(current[key]))) : current[key];
-          } else if (isObject(result[key]) && isObject(current[key])) {
-            result[key] = merge10(result[key], current[key]);
-          } else {
-            result[key] = current[key];
-          }
-        });
-        return result;
-      }, {});
-    };
-    var defaultOptions = {
-      mergeArrays: true
-    };
-    merge10.options = defaultOptions;
-    merge10.withOptions = function(options) {
-      var objects = [];
-      for (var _i = 1; _i < arguments.length; _i++) {
-        objects[_i - 1] = arguments[_i];
-      }
-      merge10.options = __assign({ mergeArrays: true }, options);
-      var result = merge10.apply(void 0, __spreadArray([], __read(objects), false));
-      merge10.options = defaultOptions;
-      return result;
-    };
-    exports.default = merge10;
-  }
-});
-
 // src/assets/AssetKey.ts
 function isResourceLocation(value) {
   return typeof value === "string" && /^(?:[a-z0-9_.-]+:)?[a-z0-9_./-]+$/.test(value);
@@ -1436,123 +1324,6 @@ var init_AssetKey = __esm({
   }
 });
 
-// src/model/DisplayPosition.ts
-var DisplayPosition, DISPLAY_POSITIONS;
-var init_DisplayPosition = __esm({
-  "src/model/DisplayPosition.ts"() {
-    DisplayPosition = /* @__PURE__ */ ((DisplayPosition3) => {
-      DisplayPosition3["THIRDPERSON_RIGHTHAND"] = "thirdperson_righthand";
-      DisplayPosition3["THIRDPERSON_LEFTHAND"] = "thirdperson_lefthand";
-      DisplayPosition3["FIRSTPERSON_RIGHTHAND"] = "firstperson_righthand";
-      DisplayPosition3["FIRSTPERSON_LEFTHAND"] = "firstperson_lefthand";
-      DisplayPosition3["GUI"] = "gui";
-      DisplayPosition3["HEAD"] = "head";
-      DisplayPosition3["GROUND"] = "ground";
-      DisplayPosition3["FIXED"] = "fixed";
-      DisplayPosition3["ON_SHELF"] = "on_shelf";
-      return DisplayPosition3;
-    })(DisplayPosition || {});
-    DISPLAY_POSITIONS = Object.values(DisplayPosition);
-  }
-});
-
-// src/model/DisplayTransforms.ts
-import { Euler, Matrix4, Quaternion, Vector3 as Vector32 } from "three";
-var DisplayTransforms;
-var init_DisplayTransforms = __esm({
-  "src/model/DisplayTransforms.ts"() {
-    init_DisplayPosition();
-    init_util();
-    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);
-      }
-      /** Transforms geometry in place and reverses triangle winding when the matrix reflects it. */
-      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 import_ts_deepmerge, ModelMerger;
-var init_ModelMerger = __esm({
-  "src/model/ModelMerger.ts"() {
-    init_Model();
-    init_Models();
-    import_ts_deepmerge = __toESM(require_dist());
-    init_AssetKey();
-    init_DisplayTransforms();
-    ModelMerger = class {
-      /** Loads the parent chain and returns a merged model without modifying the supplied definition. */
-      static async mergeWithParents(model) {
-        const parts = model.parts;
-        if (parts) return { ...model, parts: await Promise.all(parts.map((part) => this.mergeWithParents(part))) };
-        const models = await this.collectAllParents(model);
-        let merged = {};
-        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.hierarchy = models.map((m) => m.parent).filter((p11) => `${p11}`);
-        merged.hierarchy.push(`${merged.parent}`);
-        if (model.components) merged.components = model.components;
-        return merged;
-      }
-      static async collectAllParents(model) {
-        if (!model.parent) {
-          return [];
-        }
-        const models = [];
-        const parentKey = AssetKey.parse("models", model.parent);
-        if (parentKey.namespace === "minecraft" && parentKey.getFullPath() === BUILTIN_ENTITY) return models;
-        parentKey.root = model.key?.root;
-        const parentModel = await Models.getRaw(parentKey);
-        if (parentModel) {
-          models.unshift(parentModel);
-          models.unshift(...await this.collectAllParents(parentModel));
-        }
-        return models;
-      }
-    };
-  }
-});
-
 // src/assets/source/parser/AssetParsers.ts
 var AssetParser;
 var init_AssetParsers = __esm({
@@ -1670,7 +1441,9 @@ ${key}` : key, async () => {
       static validDataset(dataset, data) {
         if (!object(data)) return false;
         if (dataset === "potionColors") return object(data.effects) && Object.values(data.effects).every(Number.isInteger) && object(data.potions) && Object.values(data.potions).every((effects) => Array.isArray(effects) && effects.every((effect) => object(effect) && typeof effect.id === "string" && Number.isInteger(effect.amplifier)));
+        if (dataset === "renames") return data.format === "data-fixer-renames" && Number.isInteger(data.baseDataVersion) && ["blocks", "items", "entities"].every((kind) => object(data[kind]) && Object.values(data[kind]).every((entry) => object(entry) && typeof entry.registered === "boolean" && Array.isArray(entry.ranges) && entry.ranges.length > 0 && entry.ranges.every((range) => object(range) && Number.isInteger(range.before) && typeof range.to === "string")));
         if (dataset === "legacyBlocks") return object(data.blocks) && Object.values(data.blocks).every((value) => typeof value === "string");
+        if (dataset === "blockCulling") return Array.isArray(data.profiles) && data.profiles.every((profile) => object(profile) && typeof profile.type === "string") && object(data.blocks) && Object.values(data.blocks).every((index) => Number.isInteger(index) && index >= 0 && index < data.profiles.length) && (data.groups === void 0 || object(data.groups) && Object.values(data.groups).every((group) => Array.isArray(group) && group.every((type) => typeof type === "string")));
         return Object.values(data).every((value) => {
           if (!object(value)) return false;
           switch (dataset) {
@@ -1693,6 +1466,275 @@ ${key}` : key, async () => {
   }
 });
 
+// src/assets/Renames.ts
+var Renames;
+var init_Renames = __esm({
+  "src/assets/Renames.ts"() {
+    init_AssetKey();
+    init_MineRenderData();
+    Renames = class {
+      /** Loads the selected version's rename table, or `undefined` when its published data has none. */
+      static async get(root) {
+        const resolved = await MineRenderData.resolve(root);
+        return resolved.manifest.datasets.renames ? MineRenderData.get("renames", root) : void 0;
+      }
+      /**
+       * Returns the ID that replaced `id`, or `undefined` when `id` keeps its meaning.
+       * Without a data version, an ID that the selected version still registers keeps its meaning.
+       */
+      static async resolve(kind, id, dataVersion, root) {
+        const data = await this.get(root);
+        if (!data || !Object.prototype.hasOwnProperty.call(data[kind], id)) return void 0;
+        const entry = data[kind][id];
+        if (dataVersion === void 0) return entry.registered ? void 0 : entry.ranges[entry.ranges.length - 1].to;
+        if (dataVersion < data.baseDataVersion) return void 0;
+        return entry.ranges.find((range) => dataVersion < range.before)?.to;
+      }
+      /** Returns a copy of `key` for the replacement ID, or `undefined` when the ID keeps its meaning. */
+      static async key(kind, key) {
+        const renamed = await this.resolve(kind, `${key.namespace}:${key.path}`, void 0, key.root);
+        if (!renamed) return void 0;
+        const [namespace, path] = renamed.split(":");
+        return new AssetKey(namespace, path, key.assetType, key.type, key.rootType, key.extension, key.root);
+      }
+    };
+  }
+});
+
+// src/model/Model.ts
+function isDoubleArray(obj) {
+  return Array.isArray(obj) && obj.length === 2;
+}
+function isTripleArray(obj) {
+  return Array.isArray(obj) && obj.length === 3;
+}
+function isQuadArray(obj) {
+  return Array.isArray(obj) && obj.length === 4;
+}
+var ITEM_GENERATED, BUILTIN_GENERATED, BUILTIN_ENTITY, DEFAULT_ELEMENTS;
+var init_Model = __esm({
+  "src/model/Model.ts"() {
+    ITEM_GENERATED = "item/generated";
+    BUILTIN_GENERATED = "builtin/generated";
+    BUILTIN_ENTITY = "builtin/entity";
+    DEFAULT_ELEMENTS = [];
+  }
+});
+
+// ../../node_modules/ts-deepmerge/dist/index.js
+var require_dist = __commonJS({
+  "../../node_modules/ts-deepmerge/dist/index.js"(exports) {
+    "use strict";
+    var __assign = exports && exports.__assign || function() {
+      __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+          s = arguments[i];
+          for (var p11 in s) if (Object.prototype.hasOwnProperty.call(s, p11))
+            t[p11] = s[p11];
+        }
+        return t;
+      };
+      return __assign.apply(this, arguments);
+    };
+    var __read = exports && exports.__read || function(o, n) {
+      var m = typeof Symbol === "function" && o[Symbol.iterator];
+      if (!m) return o;
+      var i = m.call(o), r, ar = [], e;
+      try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+      } catch (error) {
+        e = { error };
+      } finally {
+        try {
+          if (r && !r.done && (m = i["return"])) m.call(i);
+        } finally {
+          if (e) throw e.error;
+        }
+      }
+      return ar;
+    };
+    var __spreadArray = exports && exports.__spreadArray || function(to, from, pack) {
+      if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+          if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+          ar[i] = from[i];
+        }
+      }
+      return to.concat(ar || Array.prototype.slice.call(from));
+    };
+    Object.defineProperty(exports, "__esModule", { value: true });
+    var isObject = function(obj) {
+      if (typeof obj === "object" && obj !== null) {
+        if (typeof Object.getPrototypeOf === "function") {
+          var prototype = Object.getPrototypeOf(obj);
+          return prototype === Object.prototype || prototype === null;
+        }
+        return Object.prototype.toString.call(obj) === "[object Object]";
+      }
+      return false;
+    };
+    var PROTECTED_KEYS = ["__proto__"];
+    var merge10 = function() {
+      var objects = [];
+      for (var _i = 0; _i < arguments.length; _i++) {
+        objects[_i] = arguments[_i];
+      }
+      return objects.reduce(function(result, current) {
+        Object.keys(current).forEach(function(key) {
+          if (PROTECTED_KEYS.includes(key)) {
+            return;
+          }
+          if (Array.isArray(result[key]) && Array.isArray(current[key])) {
+            result[key] = merge10.options.mergeArrays ? Array.from(new Set(result[key].concat(current[key]))) : current[key];
+          } else if (isObject(result[key]) && isObject(current[key])) {
+            result[key] = merge10(result[key], current[key]);
+          } else {
+            result[key] = current[key];
+          }
+        });
+        return result;
+      }, {});
+    };
+    var defaultOptions = {
+      mergeArrays: true
+    };
+    merge10.options = defaultOptions;
+    merge10.withOptions = function(options) {
+      var objects = [];
+      for (var _i = 1; _i < arguments.length; _i++) {
+        objects[_i - 1] = arguments[_i];
+      }
+      merge10.options = __assign({ mergeArrays: true }, options);
+      var result = merge10.apply(void 0, __spreadArray([], __read(objects), false));
+      merge10.options = defaultOptions;
+      return result;
+    };
+    exports.default = merge10;
+  }
+});
+
+// src/model/DisplayPosition.ts
+var DisplayPosition, DISPLAY_POSITIONS;
+var init_DisplayPosition = __esm({
+  "src/model/DisplayPosition.ts"() {
+    DisplayPosition = /* @__PURE__ */ ((DisplayPosition3) => {
+      DisplayPosition3["THIRDPERSON_RIGHTHAND"] = "thirdperson_righthand";
+      DisplayPosition3["THIRDPERSON_LEFTHAND"] = "thirdperson_lefthand";
+      DisplayPosition3["FIRSTPERSON_RIGHTHAND"] = "firstperson_righthand";
+      DisplayPosition3["FIRSTPERSON_LEFTHAND"] = "firstperson_lefthand";
+      DisplayPosition3["GUI"] = "gui";
+      DisplayPosition3["HEAD"] = "head";
+      DisplayPosition3["GROUND"] = "ground";
+      DisplayPosition3["FIXED"] = "fixed";
+      DisplayPosition3["ON_SHELF"] = "on_shelf";
+      return DisplayPosition3;
+    })(DisplayPosition || {});
+    DISPLAY_POSITIONS = Object.values(DisplayPosition);
+  }
+});
+
+// src/model/DisplayTransforms.ts
+import { Euler, Matrix4, Quaternion, Vector3 as Vector32 } from "three";
+var DisplayTransforms;
+var init_DisplayTransforms = __esm({
+  "src/model/DisplayTransforms.ts"() {
+    init_DisplayPosition();
+    init_util();
+    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.getTransform(display, position);
+        return new Matrix4().compose(transform.position, transform.quaternion, transform.scale);
+      }
+      /** Position, rotation, and scale of a display pose for geometry already centered at the model's [8, 8, 8] pivot. */
+      static getTransform(display, position) {
+        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 { position: translation, quaternion: rotation, scale };
+      }
+      /** Transforms geometry in place and reverses triangle winding when the matrix reflects it. */
+      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 import_ts_deepmerge, ModelMerger;
+var init_ModelMerger = __esm({
+  "src/model/ModelMerger.ts"() {
+    init_Model();
+    init_Models();
+    import_ts_deepmerge = __toESM(require_dist());
+    init_AssetKey();
+    init_DisplayTransforms();
+    ModelMerger = class {
+      /** Loads the parent chain and returns a merged model without modifying the supplied definition. */
+      static async mergeWithParents(model) {
+        const parts = model.parts;
+        if (parts) return { ...model, parts: await Promise.all(parts.map((part) => this.mergeWithParents(part))) };
+        const models = await this.collectAllParents(model);
+        let merged = {};
+        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.hierarchy = models.map((m) => m.parent).filter((p11) => `${p11}`);
+        merged.hierarchy.push(`${merged.parent}`);
+        if (model.components) merged.components = model.components;
+        return merged;
+      }
+      static async collectAllParents(model) {
+        if (!model.parent) {
+          return [];
+        }
+        const models = [];
+        const parentKey = AssetKey.parse("models", model.parent);
+        if (parentKey.namespace === "minecraft" && parentKey.getFullPath() === BUILTIN_ENTITY) return models;
+        parentKey.root = model.key?.root;
+        const parentModel = await Models.getRaw(parentKey);
+        if (parentModel) {
+          models.unshift(parentModel);
+          models.unshift(...await this.collectAllParents(parentModel));
+        }
+        return models;
+      }
+    };
+  }
+});
+
 // src/assets/BannerPatterns.ts
 var DYE_COLORS, BannerPatterns;
 var init_BannerPatterns = __esm({
@@ -2015,6 +2057,7 @@ var init_ItemTints = __esm({
 var Models;
 var init_Models = __esm({
   "src/assets/Models.ts"() {
+    init_Renames();
     init_Caching();
     init_ModelMerger();
     init_AssetLoader();
@@ -2344,6 +2387,11 @@ var init_Models = __esm({
           key.extension = ".json";
         }
         const preview = this.snapshotContext(key, context);
+        if (key.type === "item") {
+          const renamed = await Renames.key("items", key);
+          const replacement = renamed && await this.getMerged(renamed, preview);
+          if (replacement) return replacement;
+        }
         const dataKey = await this.applyDefaults(key, preview);
         const keyStr = AssetLoader.persistentKey(key.serialize() + (key.type === "item" ? this.contextKey(preview) + dataKey : ""));
         const model = await Caching.mergedModelCache.get(keyStr, async () => {
@@ -2377,6 +2425,7 @@ var init_BlockStates = __esm({
     init_AssetKey();
     init_PersistentCache();
     init_AssetParsers();
+    init_Renames();
     init_MineRenderData();
     BlockStates = class {
       static get PERSISTENT_CACHE() {
@@ -2417,6 +2466,9 @@ var init_BlockStates = __esm({
         if (!key.extension) {
           key.extension = ".json";
         }
+        const renamed = await Renames.key("blocks", key);
+        const replacement = renamed && await this.get(renamed);
+        if (replacement) return replacement;
         const keyStr = key.serialize();
         return Caching.blockStateCache.get(keyStr, (k) => {
           return this.PERSISTENT_CACHE.getOrLoad(AssetLoader.persistentKey(keyStr), (k1) => {
@@ -7014,16 +7066,21 @@ var init_ModelObject = __esm({
         const special = this.originalModel.special;
         if (special) {
           const parts2 = await SpecialItems.getParts(special, this.originalModel.key?.root, this.originalModel.components);
-          const transform = this.options.displayPosition ? DisplayTransforms.getMatrix(this.originalModel.display, this.options.displayPosition) : new Matrix48();
-          transform.multiply(new Matrix48().makeTranslation(-8, -8, -8));
+          const display = new SceneObject();
+          if (this.options.displayPosition) {
+            const transform = DisplayTransforms.getTransform(this.originalModel.display, this.options.displayPosition);
+            display.position.copy(transform.position);
+            display.quaternion.copy(transform.quaternion);
+            display.scale.copy(transform.scale);
+          }
+          this.add(display);
+          const offset = new Matrix48().makeTranslation(-8, -8, -8);
           try {
             const targets = [];
             for (const part of parts2) {
               const object4 = new EntityObject(part.model, { flip: false, wireframe: this.options.wireframe, tints: part.tints, faces: part.faces });
-              object4.matrix.copy(transform).multiply(part.transform);
-              object4.matrixWorldNeedsUpdate = true;
-              object4.matrixAutoUpdate = false;
-              this.add(object4);
+              object4.matrix.multiplyMatrices(offset, part.transform).decompose(object4.position, object4.quaternion, object4.scale);
+              display.add(object4);
               await object4.init(part.material);
               object4.iterateAllMeshes((mesh) => {
                 const source = mesh.material;
@@ -7973,6 +8030,7 @@ var Fonts = class {
 init_MineRenderData();
 init_ModelTextures();
 init_Models();
+init_Renames();
 init_source();
 
 // src/cache/index.ts
@@ -17397,6 +17455,7 @@ var SectionModels = class {
 };
 
 // src/world/_entities/WorldEntities.ts
+init_Renames();
 init_Entities();
 init_EntityObject();
 
@@ -17556,8 +17615,10 @@ var WorldEntities = class {
         try {
           if (!current()) return;
           const models = await Entities.getEntityList();
-          if (!models.includes(placement.key.path) || !current()) return;
-          const model = await Entities.getEntity(placement.key, placement.texture, { when: placement.when });
+          const renamed = models.includes(placement.key.path) ? void 0 : await Renames.key("entities", placement.key);
+          const key = renamed && models.includes(renamed.path) ? renamed : placement.key;
+          if (!models.includes(key.path) || !current()) return;
+          const model = await Entities.getEntity(key, placement.texture, { when: placement.when });
           if (!model || !current()) return;
           let tints = placement.tints;
           if (placement.woolDye) {
@@ -17572,7 +17633,7 @@ var WorldEntities = class {
           object4.rotation.y = placement.yaw;
           await object4.init();
           if (!current()) return;
-          placement.owner.set(object4, { type: placement.key.toNamespacedString(), position: placement.position });
+          placement.owner.set(object4, { type: key.toNamespacedString(), position: placement.position });
           this.scene.add(object4);
         } catch (error) {
           console.warn(`Could not draw saved entity ${placement.key.toNamespacedString()}, skipping it`, error);
@@ -17626,6 +17687,38 @@ function sampleSectionLight(light, index) {
   };
 }
 
+// src/world/_culling/BlockCulling.ts
+init_Assets();
+init_MineRenderData();
+init_CubeFace();
+async function loadBlockCulling(root) {
+  const { manifest } = await MineRenderData.resolve(root);
+  return manifest.datasets.blockCulling ? MineRenderData.get("blockCulling", root) : void 0;
+}
+function blockCullingRule(data, type) {
+  if (!type.includes(":")) type = `${DEFAULT_NAMESPACE}:${type}`;
+  return Object.prototype.hasOwnProperty.call(data.blocks, type) ? data.profiles[data.blocks[type]] : void 0;
+}
+function skipsBlockFace(data, rule, block, neighbor, face) {
+  const type = block.type.includes(":") ? block.type : `${DEFAULT_NAMESPACE}:${block.type}`;
+  const other = neighbor.type.includes(":") ? neighbor.type : `${DEFAULT_NAMESPACE}:${neighbor.type}`;
+  const same = type === other;
+  const vertical = CUBE_FACES[face] === "up" /* UP */ || CUBE_FACES[face] === "down" /* DOWN */;
+  switch (rule.type) {
+    case "same_block":
+      return same;
+    case "same_block_vertical":
+      return same && vertical;
+    case "connected": {
+      if (vertical) return same;
+      const group = rule.group ? data.groups?.[rule.group] : void 0;
+      return (same || !!group?.includes(type) && group.includes(other)) && String(block.properties?.[CUBE_FACES[face]]) === "true" && String(neighbor.properties?.[CUBE_FACES[face ^ 1]]) === "true";
+    }
+    default:
+      return false;
+  }
+}
+
 // src/world/MineRenderWorld.ts
 var MineRenderWorld = class {
   constructor(scene, options = {}) {
@@ -18014,15 +18107,23 @@ var MineRenderWorld = class {
     return this.culling ?? (this.culling = Promise.resolve().then(async () => {
       let sliceStart = performance.now();
       try {
+        const culling = await loadBlockCulling();
         while (this.pendingCulling.size) {
           const batch = [...this.pendingCulling];
           this.pendingCulling.clear();
           for (const [chunk, indices] of batch) {
             const neighbors = CUBE_FACE_OFFSETS.map(([x, y, z]) => this._chunks.get(`${chunk.x + x}_${chunk.y + y}_${chunk.z + z}`));
-            const masks = chunk.updateCullMasks(indices === "all" ? void 0 : indices, (x, y, z) => {
+            const neighborAt = (x, y, z) => {
               const lx = x - chunk.x * 16, ly = y - chunk.y * 16, lz = z - chunk.z * 16;
               const section = neighbors[lx >= 16 ? 0 : lx < 0 ? 1 : ly >= 16 ? 2 : ly < 0 ? 3 : lz >= 16 ? 4 : 5];
-              return section?.isOccludingIndex((ly & 15) * 256 + (lz & 15) * 16 + (lx & 15)) ?? false;
+              return [section, (ly & 15) * 256 + (lz & 15) * 16 + (lx & 15)];
+            };
+            const masks = chunk.updateCullMasks(indices === "all" ? void 0 : indices, (x, y, z) => {
+              const [section, i] = neighborAt(x, y, z);
+              return section?.isOccludingIndex(i) ?? false;
+            }, culling, (x, y, z) => {
+              const [section, i] = neighborAt(x, y, z);
+              return section?.visibleBlockIndex(i);
             });
             const fluidIndices = indices === "all" ? function* () {
               for (let index = 0; index < 4096; index++) yield index;
@@ -19137,6 +19238,10 @@ var Chunk = class _Chunk {
   isBlockVisibleIndex(index) {
     return this.renderedBlocks.has(index) && !this.hiddenBlocks.has(index);
   }
+  /** Stored state of a rendered, visible cell, or `undefined`. */
+  visibleBlockIndex(index) {
+    return this.isBlockVisibleIndex(index) ? this.data.stateAt(this.data.idAt(index)) : void 0;
+  }
   /** Fluid kind bits and level of a cell, or 0. Hidden cells report 0. */
   fluidByteIndex(index) {
     return this.hiddenBlocks.has(index) ? 0 : this.fluidCells[index];
@@ -19155,18 +19260,30 @@ var Chunk = class _Chunk {
   async setCullMaskAt(pos, mask) {
     await this.setCullMaskIndex(_Chunk.chunkPosToBlockIndex(this.worldPosToChunkPos(pos)), mask);
   }
-  /** Recomputes section masks and returns changed per-block masks. Omit indices to visit every cell. */
-  updateCullMasks(indices, occludes) {
+  /**
+   * Recomputes section masks and returns changed per-block masks. Omit indices to visit every cell.
+   * `culling` supplies neighbor face rules; `blockAt` supplies visible states outside this chunk.
+   */
+  updateCullMasks(indices, occludes, culling, blockAt) {
     const changed = [];
+    const rules = [];
     for (const index of indices ?? this.fluidCells.keys()) {
       if (!this.isBlockVisibleIndex(index)) continue;
       const x = index % 16, y = Math.floor(index / 256), z = Math.floor(index / 16) % 16;
+      const id = this.data.idAt(index);
+      let rule = rules[id];
+      if (culling && rule === void 0) rules[id] = rule = blockCullingRule(culling, this.data.stateAt(id).type) ?? null;
+      const block = rule ? this.data.stateAt(id) : void 0;
       let mask = 0;
       for (let face = 0; face < CUBE_FACE_OFFSETS.length; face++) {
         const [dx, dy, dz] = CUBE_FACE_OFFSETS[face];
         const nx = x + dx, ny = y + dy, nz = z + dz;
         const inner = nx >= 0 && nx < 16 && ny >= 0 && ny < 16 && nz >= 0 && nz < 16;
         if (inner ? this.isOccludingIndex(ny * 256 + nz * 16 + nx) : occludes(this.x * 16 + nx, this.y * 16 + ny, this.z * 16 + nz)) mask |= 1 << face;
+        else if (rule) {
+          const neighbor = inner ? this.visibleBlockIndex(ny * 256 + nz * 16 + nx) : blockAt?.(this.x * 16 + nx, this.y * 16 + ny, this.z * 16 + nz);
+          if (neighbor && skipsBlockFace(culling, rule, block, neighbor, face)) mask |= 1 << face;
+        }
       }
       if (this.fluidCells[index]) this.meshDirty = true;
       const entries = this.sectionBlocks.get(index);
@@ -19579,6 +19696,7 @@ export {
   PackMetadata,
   PersistentCache,
   PlayerHeadTextures,
+  Renames,
   Renderer,
   RequestError,
   Requests,