数据生成设置 1.21.4

使用 Fabric API 设置数据生成的指南。

WARNING

本页面适用于 1.21.4 版本。 针对旧版本的文档可能不完整。

数据生成是什么？ 数据生成是什么？

数据生成 (又称 Datagen) 是一种 API，用于以编程方式生成配方、进度、标签、物品模型、语言文件、战利品表以及基本上任何基于 JSON 的内容。

启用数据生成

在项目创建时

启用数据生成的最简单方法是在创建项目时。 使用模板生成器时，勾选“启用数据生成”框。

TIP

如果启用了 datagen，应该有一个“数据生成”运行配置和一个 runDatagen Gradle 任务。

手动

首先，我们需要在 build.gradle 文件中启用 datagen。

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 的运行配置。

创建包

在 datagen 入口点的 onInitializeDataGenerator 方法中，我们需要创建一个 Pack。 稍后，你将添加提供程序，将生成的数据放入此 Pack 中。

FabricDataGenerator.Pack pack = fabricDataGenerator.createPack();

运行数据生成

要运行 datagen，请使用 IDE 中的运行配置，或者在控制台中运行 ./gradlew runDatagen。 生成的文件将创建在 src/main/generated 中。

下一步

现在 datagen 已设置完毕，我们需要添加提供程序。 这些提供程序将生成要添加到 Pack 的数据。 以下页面概述了如何执行此操作。

• 进度
• 战利品表
• 配方
• 标签
• 翻译