在 Minecraft 服务端插件开发中，使用 ShapedRecipe.getIngredientMap() 只能获取默认原料（如橡木木板），无法反映配方支持的多种木材变体；而 ShapelessRecipe.getChoiceMap() 才是正确获取所有可替换原料变体（如各类木板）的关键方法。
在 minecraft 服务端插件开发中，使用 `shapedrecipe.getingredientmap()` 只能获取默认原料（如橡木木板），无法反映配方支持的多种木材变体；而 `shapelessrecipe.getchoicemap()` 才是正确获取所有可替换原料变体（如各类木板）的关键方法。
Minecraft 1.20+（尤其是使用 Mojang 的新数据驱动配方系统后）引入了更灵活的配方建模方式，其中 RecipeChoice 成为表示“可选原料组”的核心抽象。虽然 ShapedRecipe 本身不直接暴露 getChoiceMap()（该方法属于 ShapelessRecipe），但实际开发中需注意：并非所有“多变体配方”都以 ShapedRecipe 形式存在——例如木棍（stick）等支持全木材变体的合成，在新版服务端（如 Paper 1.20.4+）中已被重构为 ShapelessRecipe，其内部通过 RecipeChoice.MaterialChoice 或 RecipeChoice.ExactChoice 显式声明所有允许的 ItemStack 变体。
✅ 正确获取全部木材变体的示例代码如下：
if (recipe instanceof ShapelessRecipe shapeless) {
Map<character recipechoice> choiceMap = shapeless.getChoiceMap();
// 假设配方字符 'X' 对应木材原料
if (choiceMap.containsKey('X')) {
RecipeChoice choice = choiceMap.get('X');
if (choice instanceof RecipeChoice.MaterialChoice materialChoice) {
List<material> allowedMaterials = materialChoice.getMaterials();
// 如：[OAK_PLANKS, SPRUCE_PLANKS, BIRCH_PLANKS, ...]
for (Material mat : allowedMaterials) {
ItemStack variant = new ItemStack(mat, 1);
// 将 variant 加入你的自动合成校验逻辑
}
}
}
}</material></character>
⚠️ 注意事项：
- ShapedRecipe.getIngredientMap() 返回的是 Map
，仅返回配方定义时指定的默认实例（通常为最基础材质），不具备变体感知能力； - ShapelessRecipe.getChoiceMap() 返回 Map
，RecipeChoice 是可扩展接口，支持 MaterialChoice（按材质匹配）、ExactChoice（精确 ItemStack 匹配）等策略； - 若你遇到的配方在运行时仍是 ShapedRecipe 类型但理应支持变体，请检查服务端版本与配方注册方式——部分旧版插件或自定义配方可能未启用新版数据驱动机制，此时需手动维护变体映射表（如基于 Material.matchingBlockTags(TagKey) 查询 #minecraft:planks 标签下的全部方块）；
- 推荐统一使用 RecipeChoice API 并结合 TagKey（如 BlockTags.PLANKS）进行动态扩展，以兼容未来新增的木材类型（如绯红菌柄、诡异菌柄等）。
总之，要真正支持 Minecraft 中“一物多材”的设计哲学，必须跳出 ItemStack 的静态实例思维，转向 RecipeChoice + Tag 的语义化原料匹配模型。
