ULTIMATE FOODS - 终极美食

本插件适用于 1.20 或更早的 Minecraft 版本，请使用 1.3.0 版本。运行此插件需要 ProtocolLib 作为前置依赖。

欢迎通过为插件留下五星好评和评论来帮助我们，这将有助于我们改进插件的各个方面，并激励我们上传更多内容！您也可以加入我们的 Discord 社区，提出建议、疑问或推荐。

💡重要须知

• 版本兼容性：针对 1.20 或更早版本，请务必使用插件版本 1.3.0。
• 前置需求：此插件必须安装 ProtocolLib 才能正常运行。

🔧支持与反馈

• 在插件页面留下 ⭐⭐⭐⭐⭐ 好评和评论。
• 加入我们的 Discord 社区，分享您的建议、疑问或想法。

UltimateFoods 插件文档

UltimateFoods 是一款为 Minecraft 服务器设计的插件，它允许你创建自定义食物和饮料。这些物品可以恢复生命值、饱食度，并提供各种药水效果，为你的服务器增添独特的生存体验。

💡功能特性

• 自定义食物与饮料：创建具有独特名称、外观和属性的食物与饮品。
• 可配置的属性：为每个物品设置恢复的生命值、饱食度以及药水效果。
• 合成支持：所有自定义食物都可以通过工作台合成。
• 管理员工具：提供方便的命令来获取和管理自定义食物。

🎮命令与权限

命令列表

• /uf help

- 描述：显示帮助信息。

- 权限：`ultimatefoods.help`

• /uf reload

- 描述：重载插件的配置文件。

- 权限：`ultimatefoods.reload`

• /uf give <玩家> <食物ID> [数量]

- 描述：给予指定玩家自定义食物。

- 权限：`ultimatefoods.give`

• /uf list

- 描述：列出所有已配置的自定义食物及其ID。

- 权限：`ultimatefoods.list`

• /uf info <食物ID>

- 描述：显示指定食物的详细信息。

- 权限：`ultimatefoods.info`

权限节点

• ultimatefoods.*：拥有所有 UltimateFoods 权限。
• ultimatefoods.help：允许使用 /uf help 命令。
• ultimatefoods.reload：允许使用 /uf reload 命令。
• ultimatefoods.give：允许使用 /uf give 命令。
• ultimatefoods.list：允许使用 /uf list 命令。
• ultimatefoods.info：允许使用 /uf info 命令。

🔧配置指南

创建自定义食物

所有自定义食物都在 plugins/UltimateFoods/foods.yml 文件中进行配置。每个食物都是一个独立的配置节。

配置格式示例

以下是一个名为“黄金苹果汁”的饮料配置示例

golden_apple_juice: # 食物ID，用于命令识别
  name: "&6黄金苹果汁" # 物品显示名称（支持颜色代码）
  material: POTION # 物品材质（必须为有效的 Minecraft 材料名）
  custom-model-data: 1000 # 自定义模型数据（用于资源包）
  lore: # 物品描述（支持颜色代码）
    - "&7一杯由黄金苹果制成的神奇果汁。"
    - "&a提供强大的再生效果！"
  food-level: 6 # 恢复的饱食度（鸡腿图标）
  saturation: 14.4 # 饱和度
  health: 4.0 # 恢复的生命值（2颗心）
  effects: # 提供的药水效果列表
    - REGENERATION:3600:1 # 效果类型:持续时间(刻):等级
  recipe: # 合成配方（形状和材料）
    shape:
      - "AGA"
      - "GPG"
      - "AGA"
    ingredients:
      A: GOLDEN_APPLE
      G: GLASS_BOTTLE
      P: POTION

关键配置项说明

• material：必须是有效的 Minecraft 材料名（如 APPLE, COOKED_BEEF, POTION）。
• custom-model-data：用于配合资源包修改物品纹理。如果不需要，可以删除此行。
• food-level 与 saturation：控制食物恢复的饥饿值与饱和度。
• health：直接恢复的生命值（2.0 代表 1 颗心）。
• effects：格式为 效果:持续时间:等级。持续时间以刻为单位（20刻=1秒）。
• recipe：定义工作台合成配方。shape 定义3x3形状，ingredients 定义字符对应的材料。

✨安装与使用

安装步骤

• 将下载的 UltimateFoods.jar 文件放入服务器的 plugins 文件夹。
• 重启或重载服务器。
• 插件会自动生成配置文件目录 plugins/UltimateFoods/。
• 编辑 foods.yml 文件来创建你的自定义食物。
• 使用 /uf reload 命令加载新的配置。

获取食物

• 管理员可以使用 /uf give <玩家名> <食物ID> 命令直接给予食物。
• 玩家可以在工作台中使用配置的合成配方来制作食物。

❓常见问题

• 问：如何让食物提供速度效果？

- 答：在 `effects` 列表中添加 `SPEED:600:1`（速度 I 效果，持续30秒）。

• 问：配方不起作用？

- 答：请确保 `material` 和配方中的 `ingredients` 使用了正确的 Minecraft 材料枚举名。重启服务器或使用 `/uf reload` 重载配置。

• 问：支持 1.16+ 的新物品吗？

- 答：是的，只要在 `material` 字段中使用对应版本有效的材料名即可。

• 问：如何删除一个自定义食物？

- 答：只需在 `foods.yml` 文件中删除对应的配置节（例如删除整个 `golden_apple_juice:` 部分），然后重载配置。

⭐注意事项

• 修改 foods.yml 后，必须使用 /uf reload 命令或在控制台输入 ultimatefoods:uf reload 使更改生效。
• 合成配方中的材料键（如 A, G）是自定义的，但必须在 ingredients 部分明确定义其对应的材料。
• 生命值恢复（health）会直接加到玩家当前生命值上，不受最大生命值限制，请合理设置数值。
• 建议在正式使用前，在测试服务器上充分测试食物的属性和合成配方。