❯/spluginscat blog/custom-crafting-recipes-minecraft-plugin-2026

2026 年 Minecraft 自定义合成配方插件：完整指南

2026年6月2日Ssomar Team

ExecutableCraftingcustom-craftingrecipestutorial2026

本文译自英文。阅读原文。

原版 Minecraft 提供了 400 多个合成配方，然后就到此为止了。一把钻石剑，对刚加入的新玩家和拥有全套附魔装备的老玩家来说，价格完全相同。没有等级门槛，没有权限检查，也没有对进度的奖励，只有一个对所有人表现完全一致的 3×3 网格。

如果你运营的是生存服务器、RPG 世界或以经济为核心的服务器网络，这种千篇一律就是一个设计问题。 自定义合成配方让你可以在原版系统之上叠加进度、经济和创意。本指南将介绍这一点为何重要、不同插件如何解决这个问题，以及 ExecutableCrafting 如何以最少的麻烦为你提供最强的控制力。

为什么自定义合成配方能改变你的服务器

自定义配方不只是一个外观开关，它会在每一个进度阶段重塑玩家的行为。

打造真正的进度路线

将强力配方锁定在等级要求或权限节点之后。刚加入的玩家无法合成终局武器，必须先赢得这个资格。这道门槛能维持你的经济平衡，并为玩家在地平线上设定一个清晰的"下一个目标"。

构建独特的服务器个性

一个需要三个凋灵骷髅头颅和一颗下界之星的"Blood Rune"配方？这是一个故事，而不只是配置里的一行。自定义合成是让你的服务器拥有玩家铭记、并愿意讲给朋友听的独特风格的最快方式之一。

无需堆叠插件也能解决经济问题

你不必为了限制某些物品的获取而额外添加一个独立的"商店"插件，只需让这些物品只能用稀有材料合成。合成本身就是经济机制：活动部件更少，设计更优雅。

奖励游戏时长与社区贡献

如果一个配方需要基于游戏时长的占位符检查，或只有拥有特定等级权限的玩家才能使用，合成就变成了一种忠诚度奖励。捐赠者能合成免费玩家无法合成的东西，老玩家能合成新手无法合成的东西。工作台由此成为身份的象征。

ExecutableCrafting 与其他方案对比

在 Minecraft 服务器上添加自定义合成配方有好几种方式。下面是对这些选项的客观分析。

方案	设置方式	条件	GUI 浏览器	熔炉 / 铁砧	积极开发
ExecutableCrafting	YAML + GUI 编辑器	✅ 完整（等级、权限、占位符）	✅ 带文件夹的配方书	✅ 两者都支持	✅ 是
CustomCrafting	仅 YAML	部分	✅ 基础	✅ 熔炉	放缓
RecipeManager	仅 YAML	部分	❌	✅ 熔炉	极少
CraftEnhancer	仅 GUI	❌	❌	❌	未知
原版 datapack	JSON 文件	❌	❌	✅	N/A

原版 datapack 免费，也不需要插件，但完全不支持条件、命令或 GUI 浏览。它们适合小型个人服务器，却无法扩展到多人游戏的设计中。

CustomCrafting 是一个不错的替代方案，但开发已经放缓，其条件系统的表达能力也较弱。

ExecutableCrafting 脱颖而出有三个原因：

完整的游戏内 GUI 编辑器：你的管理员完全不需要接触 YAML。
PlaceholderAPI 条件：任何能用 PAPI 占位符表达的数据都可以作为配方的限制条件。
带文件夹的配方书：玩家可以直接浏览自己能合成的物品，无需在工作台里到处摸索。

用 ExecutableCrafting 打造的创意配方

下面是五种配方模式，展示了 EC 的真正能力范围。

1. 等级锁定的精英装备

一个只有 VIP 玩家才能合成的有序配方：其他人可以在配方书中看到它，但无法执行合成。

# recipes/elite_sword.yml
recipeType: CRAFTING
typeOfCraftingTableRecipe: SHAPED

shape:
  - "DDD"
  - " S "
  - " S "

ingredients:
  D: minecraft:diamond
  S: minecraft:stick

result: minecraft:netherite_sword

playerConditions:
  requiredPermissions:
    - vip.crafting.elite

playerCommands:
  - "SEND_MESSAGE &6Welcome to the elite tier, %player%!"

没有 vip.crafting.elite 的玩家会在 GUI 中看到该配方呈灰色显示，这是一个直观的升级动力。

2. 经验等级限制的矿石转化（熔炉配方）

玩家达到 30 级后，可以将铁粒熔炼成金粒。为生存服务器增添炼金术的风味。

# recipes/transmute_iron.yml
recipeType: FURNACE

input1: minecraft:iron_nugget
result: minecraft:gold_nugget
experience: 1.5
cookingTime: 100

playerConditions:
  requiredLevel: 30

playerCommands:
  - "SEND_MESSAGE &eTransmutation complete."

100 tick（5 秒）的烹饪时间比原版铁矿熔炼更短，缩短的时间本身就是等级奖励。

3. 通过铁砧修复并升级

将一把受损的铁剑与一个特殊的"Mystic Stone"物品结合，产出一把预附魔的钻石剑。

# recipes/mystic_upgrade.yml
recipeType: ANVIL
anvilMergeType: CUSTOM_RESULT

input1: minecraft:iron_sword
input2: minecraft:amethyst_shard

result: minecraft:diamond_sword

itemCheckers:
  itemCheckerType: CUSTOM_CHECKS
  checkMaterial: true
  checkAmount: false
  checkDisplayName: false
  checkLore: false
  checkDurability: false

这把铁砧变成了升级站，无需编码，也无需 NPC 商店。

4. 季节 / 活动限定配方（占位符条件）

将配方限制在某个 PlaceholderAPI 值之后。下面的示例使用一个基于时间的占位符，让配方只在游戏内活动时间窗口内可用。

# recipes/event_crown.yml
recipeType: CRAFTING
typeOfCraftingTableRecipe: SHAPELESS

input1: minecraft:gold_block
input2: minecraft:gold_block
input3: minecraft:nether_star

result: minecraft:golden_helmet

placeholdersConditions:
  condition1:
    placeholder: "%server_online%"
    value: ">10"
    cancelEventIfNotMeet: true
    messageIfNotMeet: "&cThis recipe is only available during events with 10+ players online."

你可以将 %server_online% 替换为任何经济、职业、统计或自定义插件的占位符，EC 支持任何 PAPI 值。

5. 通过配方组批量设置条件

如果你有二十个配方都需要 20 级，并且发送相同的合成消息，就不要把条件块复制粘贴二十次，而是使用配方组。

# recipeGroups.yml
recipeGroups:
  journeyman_tier:
    recipesList:
      - journeyman_*      # matches any recipe whose id starts with "journeyman_"
    playerConditions:
      requiredLevel: 20
    playerCommands:
      - "SEND_MESSAGE &aJourneyman craft complete!"

任何 ID 以 journeyman_ 为前缀的配方都会自动继承这些条件。只要正确命名，就能把新配方加入该层级，无需修改任何配置。

快速入门指南

让你的第一个自定义配方上线大约只需五分钟。

步骤 1：安装插件

从 SpigotMC、Polymart 或 BuiltByBit 下载 ExecutableCrafting。将 .jar 放入 /plugins 文件夹，与 SCore（必需的依赖，可从同一市场页面下载）放在一起。重启服务器。

步骤 2：打开 GUI 编辑器

/ec editor

这会打开游戏内的配方编辑器。点击 "New Recipe"，选择配方类型（Crafting、Furnace 或 Anvil），然后将物品拖入材料槽。设置结果物品并点击 Save。

EC 会自动在 plugins/ExecutableCrafting/recipes/ 中创建 YAML 文件。

步骤 3：添加条件（可选）

打开保存好的 YAML，并添加一个 playerConditions 块：

playerConditions:
  requiredPermissions:
    - myserver.crafting.advanced
  requiredLevel: 15

运行 /ec reload 即可在不重启的情况下应用更改。

步骤 4：创建配方书

在 plugins/ExecutableCrafting/recipeBooks.yml 中定义一本配方书：

recipeBooks:
  1:
    folders:
      Basic:
        - basic_*
      Advanced:
        - advanced_*
      All:
        - "**"

使用 /ec book <playerName> 1 为玩家打开它。你可以将这条命令绑定到 GUI 插件、讲台的右键点击，或 ExecutableItems 的能力上，选择最适合你的交互方式即可。

步骤 5：测试与迭代

使用 /ec debug 启用详细日志，然后在游戏内尝试合成。调试输出会准确显示哪个条件通过或失败，这在配方无法按预期工作时非常有价值。

免费版与高级版

ExecutableCrafting 有一个免费版，对小型服务器来说确实很实用：

功能	免费版	高级版
最大配方数	300	无限制
配方书	5	无限制
物品检查器（名称、Lore、NBT）	基础	完整的细粒度检查
配方组	✅	✅
熔炉和铁砧配方	✅	✅
PlaceholderAPI 条件	✅	✅
GUI 编辑器	✅	✅

免费版足以满足大多数生存或创造服务器的需求。高级版解锁了无限规模和完整的物品检查套件，一旦你需要按显示名称、Lore 或 CustomModelData 匹配物品，就值得升级。

Ssomar 捆绑包

ExecutableCrafting 是 Ssomar 插件套件的一部分，同属该套件的还有 ExecutableItems、ExecutableBlocks 和 ExecutableEvents。这些插件被设计为可以协同工作：

一把 ExecutableItems 自定义剑，通过 ExecutableCrafting 合成时，会触发一个 ExecutableEvents 事件，记录这一里程碑并广播到 Discord。
一个需要 ExecutableItems 组件作为材料的合成配方，确保玩家使用的是正确的物品，而不只是同材质的任意物品。

高级订阅以单一价格涵盖整个套件，而不是按插件单独计费。如果你已经为某一个 Ssomar 插件付费，其余的插件都会免费附赠。

总结

自定义合成配方是你能为服务器玩家体验做出的投资回报率最高的投入之一。它们把工作台从一个静态的查询表，变成了由门槛、奖励和身份构成的动态系统。

ExecutableCrafting 为你提供了这套系统中表达能力最强的版本：有序和无序配方、熔炉和铁砧支持、完整的 PlaceholderAPI 条件、带文件夹的配方书，以及一个让你的管理团队无需记住 YAML 语法就能高效工作的 GUI 编辑器。

从免费版开始，本周就发布你的前几个配方，等超出 300 个配方的上限时再升级。

下载 ExecutableCrafting → | 完整文档 →