Easy Data Fix

Easy Data Fix

Библиотека, позволяющая моддерам регистрировать собственные data fixer'ы.

О проекте

Easy Data Fix — небольшая библиотека-мод, помогающая создавать data fixer'ы для модов, позволяя безопасно конвертировать игровые данные модов между разными версиями игры. Мод оборачивает встроенные классы DataFixerUpper, которые, по словам Mojang, представляют собой «набор утилит для инкрементального построения, объединения и оптимизации преобразований данных».

Использование

1. Скачай `easy_data_fix--x.x.x+mc26.1` из одного из мест в начале этого README.
2. Скопируй скачанный jar-файл в папку mods.

Использование библиотеки при разработке

Чтобы настроить data fixer'ы для своего мода, сначала нужно добавить библиотеку как зависимость в файл build.gradle, а затем просто зарегистрировать их на pre-launch через API Easy Data Fix. Смотри пример ниже.

build.gradle

repositories {
    mavenCentral()
    maven { url 'https://jitpack.io' }
}

dependencies {
    ...

    // Replace <Tag> with the release tag string from the Releases page
    implementation "org.codeberg.VoxelBill:easy-data-fix:<Tag>"
}

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 Development Kit (JDK): версия 25 или выше.

  • Скачать JDK

• Gradle: версия 9.2 или выше.

  • Установить Gradle
• Minecraft: версия 26.1

Сборка

1. Клонируй репозиторий

git clone https://codeberg.org/VoxelBill/easy-data-fix.git

2. Перейди в директорию проекта

cd easy-data-fix

3. Собери проект с помощью Gradle

./gradlew clean build

Собранный мод можно найти по пути `easy-data-fix/build/libs/easy_data_fix--x.x.x+mc26.1.jar`.