Що таке генерація даних?

Генерація даних (або datagen) — це API для програмної генерації рецептів, досягнень, теґів, моделей предметів, мовних файлів, таблиць здобичі та всього, що базується на JSON.

Увімкнення генерації даних

Під час створення проєкту

Найпростіший спосіб увімкнути datagen — під час створення проєкту. Поставте прапорець «Увімкнути генерацію даних» під час використання генератора шаблонів.

TIP

Якщо datagen увімкнено, ви повинні мати налаштування запуску «Генерація даних» і завдання Gradle runDatagen.

Власноруч

По-перше, нам потрібно ввімкнути datagen у файлі build.gradle.

fabricApi {
	configureDataGeneration() {
		client = true
	}
}

Далі нам потрібен клас точки входу. Ось де починається наш datagen. Розмістіть це десь у пакеті 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 вашої точки входу даних нам потрібно створити Pack. Пізніше ви додасте постачальників, які додадуть згенеровані дані в цей Pack.

FabricDataGenerator.Pack pack = fabricDataGenerator.createPack();

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

Щоб запустити datagen, використовуйте налаштування запуску у вашій IDE або запустіть ./gradlew runDatagen у консолі. Згенеровані файли буде створено в src/main/generated.

Наступні кроки

Тепер, коли datagen налаштовано, нам потрібно додати постачальників. Це те, що генерує дані для додавання до вашого Pack. На наступних сторінках описано, як це зробити.

• Досягнення
• Таблиці здобичі
• Рецепти
• Теґи
• Переклади
• Моделі блока
• Моделі предмета