Monument Data Fix
A library modification that provides developers with tools for creating specialized game data converters.
What is Data Fixer?
DataFixerUpper, according to Mojang's official description, represents a set of tools for gradual creation, merging, and optimization of data transformation. This system is designed for converting game files between different versions of Minecraft.
Functionality
Monument Data Fix offers developers convenient APIs for implementing their own data conversion systems. In the base configuration, the mod already includes built-in converters for two popular modifications:
- Sweet Potato Reborn - allows updating saves from Minecraft versions 1.16-1.19 with the original Sweet Potato Mod to version 1.21+ with the reborn sweet potato
- Xdi8Aho Mod - provides data migration from Minecraft 1.18.2 to modern versions 1.21.4+
Important note: In Minecraft version 1.18.2, Xdi8Aho Mod was a combination of two mods, but currently these projects have separated. For proper operation in Minecraft 1.21.4+, you need to simultaneously install:
- Xdi8Aho Mod (contains exclusively original content)
- Sweet Potato Reborn (separate mod)
Otherwise, the game will automatically delete unknown blocks, leading to data loss.
Who needs this mod?
Regular players: If you don't plan to transfer saves between Minecraft versions with different modifications - you won't need Monument Data Fix. Install the library only if:
- There's a need to update old worlds with mods
- The developer of a specific mod explicitly indicated Monument Data Fix as a mandatory dependency
Mod developers: The library will help implement a data migration system for your projects. Add Monument Data Fix as a dependency and specify in the mod description that the library is required for updating saves.
Technical Information
Currently, there is no documentation, so developers are recommended to study the source code as an implementation example. For registering custom data converters, call:
top.qwerty770.monument.datafix.api.DataFixerRegistry$addDataFix(String name, CustomDataFixer dataFixer)top.qwerty770.monument.datafix.api.DataFixerRegistry$addDataFix(String name, Function<DataFixerBuilder, DataFix> dataFixer)
These calls must be made before executing net.minecraft.util.datafix.DataFixers$addFixers. You can use the built-in converters for the two mentioned mods as a sample implementation. Questions about API usage can be discussed on the project's GitHub repository.
Useful Links
