Domum Ornamentum 非官方 Fabric 版

Domum Ornamentum for Fabric — Minecraft 26.2

Fabric 版 Domum Ornamentum。一种方块形状，任意材料：门、活板门、栅栏、栅栏门、台阶、楼梯和墙，它们会呈现你放入其中的任何材料的纹理，此外还有木框架、木瓦、砖块、纸墙、立柱、柱子、悬浮地毯、框灯、精美门和木桶——在建筑师切割台上按需切割，现在可在 Minecraft 26.2 上配合 Fabric 加载器运行。

这是 LDTTeam 装饰模组的一个社区移植版。这是一个移植版，而非带有新功能的复刻版——每个方块、纹理和配方都是上游作者的作品；这里所做的是从 NeoForge 迁移到 Fabric。

Minecraft	26.2
加载器	Fabric 0.19.3 或更新版本
Fabric API	0.154.2+26.2（必需）
Java	25（Minecraft 26.2 本身的硬性要求）
模组版本	1.0.0（domum_ornamentum-26.2-1.0.0.jar）
模组 ID	domum_ornamentum
模组依赖	除 Fabric API 外无其他依赖
端	客户端和服务器
许可证	GPL-3.0-only

---

⚠️ 非官方移植——请先阅读

这是一个非官方、社区制作的 Fabric 移植版。Domum Ornamentum 本身是 OrionOnline、Raycoms 及贡献者的作品，发布在 LDTTeam（Let's Dev Together） 旗下——该团队也是 MineColonies、Structurize 和 BlockUI 的开发团队；此移植版与他们没有关联、未经他们认可，也得不到他们的支持。

• 请勿将本版本的错误报告发送给 LDTTeam。 请使用本项目的议题追踪器。
• 如果同样的错误也出现在官方 NeoForge 版本上，则应将其报告给上游。
• 原始模组：CurseForge · GitHub · LDTTeam Discord。

基础：上游自己的 port/26.1 分支，该分支已使用 Java 25 在 NeoForge 上将模组从 Minecraft 1.21.1 迁移到 26.1。这留下了一个需要跨越的轴——NeoForge → Fabric——以及 26.1 → 26.2 的变更。

---

🏛 Domum Ornamentum 是什么

Domum Ornamentum（“装饰之家”）添加了材质纹理方块。它不是注册数百个独立的方块，而是注册一种形状，该形状会呈现你放入其中的材料的样式：一个栅栏可以变成任何木材、任何石头或任何受支持的模组材料的栅栏。

• 原版形状，任意材料——门、活板门、栅栏、栅栏门、台阶、楼梯和墙，每种都由你插入的材料决定外观。
• 装饰方块——木框架（静态和动态）、木瓦和木瓦台阶、彩色砖块和砖块楼梯、板材、纸墙、立柱、柱子、悬浮地毯、框灯、精美门、精美活板门、额外方块和立式/卧式木桶。
• 建筑师切割台——一个精美的切石机，也是模组的核心。放入材料，从中间列表中选择形状，在右侧取出成品纹理方块。
• 基于标签的兼容性——材料从方块标签中读取，因此任何将其木板、原木或石头放入常规原版标签的模组都会被自动识别，无需在此处进行任何修补。

三个创造模式标签页包含了模组添加的所有内容：Domum Ornamentum (DO)、DO - 装饰方块和 DO - 悬浮地毯。

Domum Ornamentum 是一个独立的内容模组。除加载器和 Fabric API 外，它不声明任何模组依赖，并且作为一个纯粹的装饰模组可以完美独立运行——你不需要 MineColonies、Structurize 或 BlockUI 来使用它。

---

📥 安装

1. 为 Minecraft 26.2 安装 Fabric Loader 0.19.3+。
2. 将以下两个文件放入 mods/ 文件夹：
   • fabric-api-0.154.2+26.2.jar
   • domum_ornamentum-26.2-1.0.0.jar
3. 启动游戏。Minecraft 26.2 本身需要 Java 25。应出现三个 Domum Ornamentum 创造模式标签页。

服务器：步骤相同。模组在两端都需要——客户端需要方块模型，服务器需要方块实体和配方。

⚠️ 你需要这个 jar 文件吗，还是它已经包含在 MineColonies 中？

MineColonies 的 Fabric 移植版以单个 jar 文件的形式发布，其中包含 blockui、domum_ornamentum 和 structurize（Fabric 的 Jar-in-Jar 机制，位于 META-INF/jars/）。这意味着：

• 正在使用 MineColonies？你不需要此下载。只需安装 MineColonies jar 文件和 Fabric API，无需其他任何东西。
• 想要独立使用 Domum Ornamentum——作为装饰模组，或者在不需要 MineColonies 的情况下与 Structurize 配合使用？这个 jar 文件正是你需要的。

请勿同时安装两者。放在 mods/ 文件夹中的 jar 文件无论版本如何都会静默覆盖嵌套的 jar 文件：Fabric Loader 0.19.3 首先按 isRoot() 对模组候选项进行排序，因此松散的文件总是胜出，并且日志中不会出现任何有关替换的记录。结果是崩溃，其堆栈跟踪指向加载的代码中不存在的源代码行。

检查你的启动日志或模组列表：安装了 MineColonies jar 文件后，domum_ornamentum 必须缩进显示在 minecolonies 下方。如果它位于顶层，则说明 mods/ 文件夹中有一个多余的 jar 文件——请移除其中一个。

---

⚠️ 与官方版本相比的已知限制

一些仅在 NeoForge 中可用的挂钩在 Fabric 或原版 26.2 中没有对应项。在这种情况下，原始代码被保留、注释并记录，而不是删除——因此以下每一项都是已知的、有记录的差距，而不是一个谜。

• 无 JEI 集成——目前还没有适用于 26.2 的 JEI 版本。建筑师切割台、其配方和制作功能均正常工作；只是没有了 JEI 配方类别。
• 爆炸抗性不随外观材料变化——原版 26.2 没有位置感知的 getExplosionResistance，因此方块使用自身的基础强度，而不是所插入材料的强度。
• 方块音效不随外观材料变化，原因相同：原版 26.2 没有位置感知的 getSoundType。
• 无半透明放置预览——即时模式渲染缓冲区已在 26.2 中移除。
• 物品无颜色着色。 BlockColor/ItemColor 已从原版中移除，因此物品使用基础模型渲染；放置的方块颜色着色正常。
• 含水木框架绘制普通水面——液体覆盖层是仅 NeoForge 的渲染挂钩。
• 在 ≤1.20 世界保存的 Domum Ornamentum 物品加载时没有纹理——仅 NeoForge 的物品加载挂钩在 Fabric 中没有对应项。升级逻辑本身已移植且完整。
• 创造模式标签页排序遵循注册顺序；withTabsBefore 已不存在。

以上每一项都对应源码中的一个 TODO(port-26.2) 标记，以及仓库中 PORT-GAPS.md 文件中的一行和具体的修复计划。

已测试和未测试的内容

• build 通过，整个代码树的 compileJava 无错误。
• 数据生成以上游生成的 JSON 作为对照基准进行复现：746 个文件全部 746 个复现成功。
• 一个专用的 26.2 服务器将新世界启动到 Done!，零错误行。
• 一次模型审计发现并修复了十二个纹理引用未解析的柱子模型（之前 162 个未解析，之后 0 个）——已针对此 jar 文件进行静态验证，而非在运行中的客户端中验证。
• 客户端渲染可以编译和加载，但尚未进行端到端的视觉试玩测试。如果发现任何外观问题，请提交议题——这是发现剩余瑕疵的方式。

---

❓ 常见问题

Domum Ornamentum 能在 Fabric 上运行吗？ 官方来说，不能——上游仅提供 NeoForge 版本。这是为 Minecraft 26.2 制作的社区 Fabric 移植版。

我需要 MineColonies 或 Structurize 才能使用它吗？ 不需要。Domum Ornamentum 除 Fabric API 外没有其他模组依赖，并且作为一个装饰模组可以独立运行。

我已经安装了 MineColonies 的 Fabric 移植版。我还需要这个吗？ 不需要——那个 jar 文件内部已经包含了一个 Fabric 版本的 Domum Ornamentum。如果再安装这个，会覆盖打包的副本；请参阅上面的安装警告。

其他模组的木材和石头会出现在建筑师切割台中吗？ 如果它们将方块添加到常规的原版方块标签中，会——材料从标签中自动读取。

它能在专用服务器上运行吗？ 能，而且模组在两端都是必需的。

我可以使用我的旧世界吗？ 来自 NeoForge 1.21.1 版本的世界不能直接移植——Minecraft 26.2 本身就改变了存档格式。另请注意，在 ≤1.20 世界中保存的 Domum Ornamentum 物品加载时没有纹理；请参阅上面的限制。

在哪里报告错误？ 在本项目的 GitHub 议题追踪器上。请附上你的 Minecraft / Fabric Loader / Fabric API 版本、完整的 logs/latest.log 或崩溃报告、你的其他模组以及复现步骤。如果同样的错误发生在官方 NeoForge 版本上，请改为向上游报告。

---

🙏 致谢

Domum Ornamentum 是 OrionOnline（所有者）、Raycoms 及贡献者的作品，发布在 LDTTeam（Let's Dev Together) 旗下。每个方块、纹理、配方和游戏逻辑代码都源自他们。从 CurseForge 获取官方版本。

组件	上游	此移植版的源代码
Domum Ornamentum	ldtteam/Domum-Ornamentum	unknown-wq/Domum-Ornamentum
BlockUI	ldtteam/BlockUI	unknown-wq/BlockUI
Structurize	ldtteam/Structurize	unknown-wq/Structurize
MineColonies	ldtteam/minecolonies	unknown-wq/minecolonies

📄 许可证

根据 GPL-3.0-only 许可，与上游项目相同的许可证，并按其条款分发。每个发布 jar 文件的完整对应源代码位于上表链接中。