简易数据修复

简易数据修复

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

Easy Data Fix

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


关于项目

Easy Data Fix 是一个小型库模组,用于帮助为模组创建数据修复器,使自定义模组游戏数据能够在不同版本的游戏之间安全转换。该模组封装了内置的 DataFixerUpper 类,正如 Mojang 所说,它们是“一套用于增量构建、合并和优化数据转换的实用工具”。

使用

  1. 从本 README 顶部的任一位置下载 easy_data_fix-<loader>-x.x.x+mc26.1。
  2. 将下载的 jar 文件复制到你的 mods 文件夹中。

在开发中使用本库

要为你的模组设置数据修复器,首先需要在 build.gradle 文件中将该库添加为依赖项,然后在预启动阶段使用 Easy Data Fix 的 API 注册它们。参见下方示例。

build.gradle

repositories {
    mavenCentral()
    maven {
        name = "CurseForge"
        url = "https://cursemaven.com"
    }
}

dependencies { ...

// 将 &lt;FileID&gt; 替换为 CurseForge 版本下拉菜单中的文件 ID 编号
implementation "curse.maven:easy-data-fix-1762395:&lt;FileID&gt;"

}

ExampleFix.java

public class ExampleFix implements PreLaunchEntrypoint {
    @Override
    public void onPreLaunch() {
        DataFixerRegistry.addDataFix("Description of data fixer", builder -> {
            // dataVersion = The Minecraft data version used in the version your upgrading to.
            // SchemaVersion = The builtin schema class that goes with the data version.
            // Example: (4773, V4771::new) = 26.1 full release
            Schema schema = builder.addSchema(dataVersion, V[SchemaVersion]::new);
            builder.addFixer(BlockRenameFix.create(schema, "Fixer Name", DataFixerAPI.createRenamer("example_mod:mod_block", "example_mod:new_mod_block")));
            builder.addFixer(ItemRenameFix.create(schema, "Fixer Name", DataFixerAPI.createRenamer("example_mod:mod_item", "example_mod:new_mod_item")));
        });
        // You may also have multiple DataFixerRegistry here to better organize your data fixes or to support other versions.
    }
}

开发入门

要在本地获取并运行副本,请按照以下简单步骤操作。

前置条件

确保你的机器上已安装以下内容:

  • Java 开发工具包(JDK):版本 25 或更高。
  • Gradle:版本 9.2 或更高。
  • Minecraft:版本 26.1

构建

  1. 克隆仓库
git clone https://codeberg.org/VoxelBill/easy-data-fix.git
  1. 导航到项目目录
cd easy-data-fix
  1. 使用 Gradle 构建项目
./gradlew clean build

你可以在 easy-data-fix/<loader>/build/libs/easy_data_fix-<loader>-x.x.x+mc26.1.jar 找到构建好的模组。

声明

本项目是以下作品的衍生作品:MonumentDataFix。

Easy Data Fix 是 MonumentDataFix 的一个分支,它继续支持后续版本并做出了一些改进。