Генерація даних налаштування
Посібник із генерації даних налаштування за допомогою API Fabric.
WARNING
Ця сторінка написана для версії 1.21.10. Документація для старіших версій може бути неповною.
Що таке генерація даних?
Генерація даних (або 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/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. На наступних сторінках описано, як це зробити.