Настройка генерации данных 26.1.2

Руководство по настройке генерации данных с помощью API Fabric.

Что такое генерация данных?

Генерация данных (или datagen) - это API для программной генерации рецептов, улучшений, тегов, моделей предметов, языковых файлов, таблиц лута и вообще всего, что основано на JSON.

Активация генерации данных

При создании проекта

Проще всего включить datagen при создании проекта. Установите флажок "Включить генерацию данных" при использовании [генератора шаблонов] (https://fabricmc.net/develop/template/).

TIP

Если datagen включен, у вас должна быть конфигурация запуска "Генерация данных" и Gradle-задача runDatagen.

Руководство

Сначала нам нужно включить datagen в файле build.gradle.

fabricApi {
	configureDataGeneration() {
		client = true
	}
}

Далее нам нужен класс точки входа. Именно здесь начинается наш датаген. Разместите его где-нибудь в пакете client - в данном примере он находится по адресуsrc/client/java/com/example/docs/datagen/ExampleModDataGenerator.java.

public class ExampleModDataGenerator implements DataGeneratorEntrypoint {
	@Override
	public void onInitializeDataGenerator(FabricDataGenerator fabricDataGenerator) {
	}
}

Наконец, нам нужно сообщить Fabric о точке входа в нашем файле fabric.mod.json:

{
  // ...
  "entrypoints": {
    // ...
    "client": [
      // ...
    ],
    "fabric-datagen": [ 
      "com.example.docs.datagen.ExampleModDataGenerator"
    ] 
  }
}

WARNING

Не забудьте добавить запятую (,) после предыдущего блока точки входа!

Закройте и снова откройте IntelliJ, чтобы создать конфигурацию запуска для datagen.

Создание пакета

Внутри метода onInitializeDataGenerator вашей точки входа datagen нам нужно создать Pack. Позже вы добавите провайдеров, которые будут помещать сгенерированные данные в этот Pack.

FabricDataGenerator.Pack pack = fabricDataGenerator.createPack();

Запуск генерации данных

Чтобы запустить datagen, используйте конфигурацию run в вашей IDE или выполните команду ./gradlew runDatagen в консоли. Сгенерированные файлы будут созданы в src/main/generated.

Следующие шаги

Теперь, когда datagen настроен, нам нужно добавить провайдеров. Именно они генерируют данные для добавления в ваш Pack. На следующих страницах описано, как это сделать.

• Достижения
• Таблицы лута
• Рецепты
• Теги
• Переводы
• Модели блоков
• Модели предметов