Генерація даних налаштування 1.21.4

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

WARNING

Ця сторінка написана для версії 1.21.4. Документація для старіших версій може бути неповною.

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

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

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

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

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

TIP

Якщо datagen увімкнено, ви повинні мати конфігурацію запуску "Data Generation" і завдання Gradle "runDatagen".

Власноруч

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

fabricApi {
	configureDataGeneration() {
		client = true
	}
}

Далі нам потрібен клас точки входу. Ось де починається наш datagen. Розмістіть це десь у пакеті client - у цьому прикладі це розміщено в src/client/java/com/example/docs/datagen/FabricDocsReferenceDataGenerator.java.

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

}

Нарешті, нам потрібно повідомити Fabric про точку входу в нашому fabric.mod.json:

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

WARNING

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

Закрийте та знову відкрийте IntelliJ, щоб створити налаштування запуску для datagen.

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

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

FabricDataGenerator.Pack pack = fabricDataGenerator.createPack();

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

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

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

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

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