配方生成 26.1.2

使用数据生成器设置配方生成的指南。

前置条件

请确保你已经完成数据生成器设置章节。

设置

首先，我们需要 provider。 创建一个继承 FabricRecipeProvider 的类。 我们所有的配方生成都将在提供程序的 buildRecipes 方法中进行。

import java.util.List;
import java.util.concurrent.CompletableFuture;

import net.minecraft.core.HolderLookup;
import net.minecraft.core.registries.Registries;
import net.minecraft.data.recipes.RecipeCategory;
import net.minecraft.data.recipes.RecipeOutput;
import net.minecraft.data.recipes.RecipeProvider;
import net.minecraft.data.recipes.SimpleCookingRecipeBuilder;
import net.minecraft.resources.Identifier;
import net.minecraft.tags.ItemTags;
import net.minecraft.world.item.Item;
import net.minecraft.world.item.Items;
import net.minecraft.world.item.crafting.CookingBookCategory;
import net.minecraft.world.item.crafting.Ingredient;

import net.fabricmc.fabric.api.datagen.v1.FabricPackOutput;
import net.fabricmc.fabric.api.datagen.v1.provider.FabricRecipeProvider;
import net.fabricmc.fabric.api.resource.conditions.v1.ResourceConditions;

import com.example.docs.ExampleMod;
import com.example.docs.item.ModItems;

public class ExampleModRecipeProvider extends FabricRecipeProvider {
	public ExampleModRecipeProvider(FabricPackOutput output, CompletableFuture<HolderLookup.Provider> registriesFuture) {
		super(output, registriesFuture);
	}

	@Override
	protected RecipeProvider createRecipeProvider(HolderLookup.Provider registryLookup, RecipeOutput exporter) {
		return new RecipeProvider(registryLookup, exporter) {
			@Override
			public void buildRecipes() {
				HolderLookup.RegistryLookup<Item> itemLookup = registries.lookupOrThrow(Registries.ITEM);
			}
		};
	}

	@Override
	public String getName() {
		return "ExampleModRecipeProvider";
	}
}

接着在 DataGeneratorEntrypoint 入口点的 onInitializeDataGenerator 方法里注册这个类。

pack.addProvider(ExampleModRecipeProvider::new);

无序配方

无序配方相当的简单。 只需将其添加到 provider 中的 buildRecipes 方法中：

shapeless(RecipeCategory.BUILDING_BLOCKS, Items.DIRT) // You can also specify an int to produce more than one
		.requires(Items.COARSE_DIRT) // You can also specify an int to require more than one, or a tag to accept multiple things
		// Create an advancement that gives you the recipe
		.unlockedBy(getHasName(Items.COARSE_DIRT), has(Items.COARSE_DIRT))
		.save(output);

染料配方

染料配方用于给物品栏中的物品染色。

dyedItem(ModItems.LEATHER_GLOVES, "leather_gloves");

有序配方

对于有序配方，可以使用 String 定义有序，然后定义 String 中每个 char 代表什么。

shaped(RecipeCategory.MISC, Items.CRAFTING_TABLE, 4)
		.pattern("ll")
		.pattern("ll")
		.define('l', ItemTags.LOGS) // 'l' means "any log"
		.group("multi_bench") // Put it in a group called "multi_bench" - groups are shown in one slot in the recipe book
		.unlockedBy(getHasName(Items.CRAFTING_TABLE), has(Items.CRAFTING_TABLE))
		.save(output);
shaped(RecipeCategory.MISC, Items.LOOM, 4)
		.pattern("ww")
		.pattern("ll")
		.define('w', ItemTags.WOOL) // 'w' means "any wool"
		.define('l', ItemTags.LOGS)
		.group("multi_bench")
		.unlockedBy(getHasName(Items.LOOM), has(Items.LOOM))
		.save(output);
doorBuilder(Items.OAK_DOOR, Ingredient.of(Items.OAK_BUTTON)) // Using a helper method!
		.unlockedBy(getHasName(Items.OAK_BUTTON), has(Items.OAK_BUTTON))
		.save(output);

TIP

有很多辅助方法可用于创建普通配方。 查看 RecipeProvider 提供的内容！ 在 IntelliJ 中按 Alt+7 打开类的结构，其中包括方法列表。

其他配方

其他配方的工作原理类似，但需要一些额外的参数。 比如烧炼配方需要了解奖励多少经验。

oreSmelting(
		List.of(Items.GLASS_BOTTLE), // Inputs
		RecipeCategory.MISC, // Category
		CookingBookCategory.MISC, // Category
		Items.GLASS, // Output
		0.1f, // Experience
		300, // Cooking time
		"glass_bottle_to_glass" // group
);

烟熏配方有点不同，不像类似烟熏炉的方块那样使用相同的配方生成器。

SimpleCookingRecipeBuilder.smoking(
		Ingredient.of(Items.WATER_BUCKET), // Input
		RecipeCategory.MISC, // Category (MISC for smoking recipes)
		Items.BUCKET, // Output
		0.35f, // Experience
		100 // Cooking Time
)
		.unlockedBy(getHasName(Items.WATER_BUCKET), has(Items.WATER_BUCKET)) // You can specify how this recipe is unlocked here.
		.save(output, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "water_bucket_to_bucket").toString()); // Then save the recipe with your modid and the recipe name.

资源条件

要为数据生成的配方应用资源条件，将 output 用 withConditions 包围，并提供你需要应用的任何资源条件。 这会生成应用了资源条件的配方和进度：

shapeless(RecipeCategory.BUILDING_BLOCKS, Items.SAND)
		.requires(ItemTags.SAND)
		.unlockedBy(getHasName(Items.SAND), has(Items.SAND))
		.save(withConditions(output, ResourceConditions.tagsPopulated(ItemTags.DIRT))); // Instead of providing the output directly, wrap it with withConditions