Налаштування генерації даних 26.2

Посібник із генерації даних налаштування за допомогою API Fabric.

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

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

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

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

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

TIP

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

Власноруч

По-перше, нам потрібно ввімкнути генерацію даних у файлі 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, щоб створити налаштування запуску для генерації даних.

Створення пакета

Усередині методу onInitializeDataGenerator вашої точки входу даних нам потрібно створити Pack. Пізніше ви додасте постачальників, які додадуть згенеровані дані в цей Pack.

FabricDataGenerator.Pack pack = fabricDataGenerator.createPack();

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

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

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

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

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