Monument Data Fix

A library that enables modders to register customized data fixers.

What is Data Fixer?

As Mojang said in the readme file, DataFixerUpper is "a set of utilities designed for incremental building, merging, and optimization of data transformations". It is created for converting the game data between different versions of the game.

What does Monument Data Fix do?

Monument Data Fix provides a set of APIs for modders to create customized data fixers. The mod by default provides data fixers for Sweet Potato Reborn and Xdi8Aho Mod, which allows you to upgrade a save in Minecraft 1.16-1.19 with Sweet Potato Mod to Minecraft 1.21+ with Sweet Potato Reborn, or upgrade a save in Minecraft 1.18.2 with Xdi8Aho Mod to Minecraft 1.21.4+ with Xdi8Aho Mod and Sweet Potato Reborn.

Note: In Minecraft 1.18.2, Xdi8Aho Mod was a combination of Sweet Potato Mod and the own content of Xdi8Aho Mod. However, Xdi8Aho Mod has already been separated into the two mods, and now Xdi8Aho Mod only contains the content of its own. Therefore, you need to install Xdi8Aho Mod and Sweet Potato Reborn at the same time in Minecraft 1.21.4+. Otherwise, the game would delete the old blocks which it could not recognize.

Do I need this mod?

For general players: If you don't need to upgrade a modded save, you don't need Monument Data Fix. If you have a modded save to upgrade, and the mod developer states that Monument Data Fix is needed as a dependency, you should install this mod.

For mod developers: If you would like to enable your mod saves to be upgraded, make a data fixer mod using Monument Data Fix as a dependency and point out "Monument Data Fix is needed when upgrading saves" in the mod description.

Currently, there isn't a program document for the mod. In order to add your custom data fixers, call top.qwerty770.monument.datafix.api.DataFixerRegistry$addDataFix(String name, CustomDataFixer dataFixer) or top.qwerty770.monument.datafix.api.DataFixerRegistry$addDataFix(String name, Function<DataFixerBuilder, DataFix> dataFixer) before net.minecraft.util.datafix.DataFixers$addFixers is called. If you have questions on the registry, refer to Monument Data Fix itself as an example, because it provides data fixers for two mods by default. You may submit issues on Github.

External Links

• Github repository
• MCMOD (introduction in Chinese)