# 自定义配方插件
**版本:** Paper/Spigot 1.21.5
**作者:** TomMustBe12
---
## 概述
自定义配方允许您轻松在**游戏内**创建自己的合成配方！ 使用 `/recipe` 命令打开一个强大、直观的 GUI，可以创建持久存储在服务器重启之间的自定义配方。 这些配方完全兼容原版合成网格，让您和您的玩家可以在没有任何外部工具或配置文件的情况下制作自定义物品。
---
## 特性
- **使用您的物品栏中的物品即时创建自定义配方**
- **持久配方:** 自动跨服务器重启保存
- **在原版合成网格中可合成** — 无需特殊合成方块
- **简单 GUI 界面**来构建和管理您的配方
- **基于权限的控制**来限制谁可以创建配方
- **保存输入或输出物品的自定义 NBT 数据**，允许更大的灵活性。
---
## 命令 & 权限
### `/recipe`
- 打开自定义配方创建 GUI
- 需要权限：
- `customrecipes.set` — 允许玩家创建和管理自定义配方
### 权限总结
| 权限 | 描述 | 默认 |
|---------------------|------------------------------------|-----------|
| `customrecipes.set` | 允许使用 `/recipe` 命令和管理自定义配方 | OP only |
*注意:* 只有拥有 `customrecipes.set` 权限的玩家才能创建或修改自定义配方。 其他玩家仍然可以合成配方，但不能添加或删除它们。
---
## 如何使用自定义配方 GUI
1. **运行命令 `/recipe`** 打开配方创建 GUI。
2. GUI 显示一个 **3x3 合成网格** 在左侧，以及右下角的输出插槽。
3. **将配料** 通过从您的物品栏中点击物品到网格插槽来放置在 3x3 网格中。
4. **设置输出物品** 通过将结果物品放置在输出插槽中来设置。
5. 一旦您设置了输入配料和输出，点击 **“提交”按钮”** (绿色羊毛) 以注册配方。
6. 配方现在 **持久保存** 并且可以通过任何使用原版合成台的人合成！
7. 请注意，在未来的版本中，我将创建一个删除自定义配方的方法。 现在，要删除，您需要删除 config.yml 中的配方 ID。
---
## 其他说明
- 配方将自动保存到 config.yml；无需手动配置编辑。
- 您可以为相同的输出创建多个配方，并且所有配方都将被识别。 但是，创建已存在的配方将 **覆盖** 原版配方并替换为新配方。
---
## 使用示例
1. 给予自己权限或成为 OP:
`/lp user YourName permission set customrecipes.set true` (如果使用 LuckPerms)
2. 运行 `/recipe` 以打开 GUI。
3. 放置任何组合的配料，例如：1 钻石 + 1 棍子。
4. 设置输出物品为钻石剑。
5. 保存配方。
6. 现在任何人都可以使用钻石和棍子合成钻石剑！
---
## 支持 & 贡献
如果您发现任何 Bug 或希望请求功能，请在插件的 GitHub 页面上提出问题或联系我，TomMustBe12。