Monument 数据修复

Monument Data Fix

一个允许模组开发者注册自定义数据修复器的库。

什么是 Data Fixer?

正如 Mojang 在自述文件中所说，DataFixerUpper 是“一套为数据转换的增量构建、合并和优化而设计的工具”。它旨在用于在不同游戏版本之间转换游戏数据。

Monument Data Fix 有何作用？

Monument Data Fix 为模组开发者提供了一套 API，用于创建自定义的数据修复器。该模组默认为 Sweet Potato Reborn 和 Xdi8Aho Mod 提供数据修复器，使您可以将带有 Sweet Potato Mod 的 Minecraft 1.16-1.19 存档升级到带有 Sweet Potato Reborn 的 Minecraft 1.21+，或将带有 Xdi8Aho Mod 的 Minecraft 1.18.2 存档升级到同时带有 Xdi8Aho Mod 和 Sweet Potato Reborn 的 Minecraft 1.21.4+。

注意：在 Minecraft 1.18.2 中，Xdi8Aho Mod 是 Sweet Potato Mod 和 Xdi8Aho Mod 自身内容的组合。然而，Xdi8Aho Mod 已被拆分为两个模组，现在 Xdi8Aho Mod 仅包含其自身内容。因此，您需要在 Minecraft 1.21.4+ 中同时安装 Xdi8Aho Mod 和 Sweet Potato Reborn。否则，游戏会删除其无法识别的旧方块。

我需要这个模组吗？

对于普通玩家：如果您无需升级模组存档，则不需要 Monument Data Fix。如果您有需要升级的模组存档，且模组开发者声明需要 Monument Data Fix 作为依赖，则您应安装此模组。

对于模组开发者：如果您希望您的模组存档能够被升级，请以 Monument Data Fix 作为依赖制作一个数据修复模组，并在模组描述中说明“升级存档时需要 Monument Data Fix”。

目前，该模组尚没有程序文档。要添加您的自定义数据修复器，请在调用 net.minecraft.util.datafix.DataFixers$addFixers 之前，调用 top.qwerty770.monument.datafix.api.DataFixerRegistry$addDataFix(String name, CustomDataFixer dataFixer) 或 top.qwerty770.monument.datafix.api.DataFixerRegistry$addDataFix(String name, Function<DataFixerBuilder, DataFix> dataFixer)。如果您对注册有疑问，可将 Monument Data Fix 本身作为参考示例，因为它默认提供了两个模组的数据修复器。您也可以在 Github 上提交 issue。

外部链接

• Github 仓库
• MC百科（中文介绍）