[Discontinue]ConsumeFood - [停更]ConsumeFood 食物消耗插件

ConsumeFood 是一款功能全面的 Minecraft 插件，它允许你深度自定义游戏内的食物系统。你可以修改原版食物的属性，创建全新的自定义食物，并精细控制玩家的饥饿值与饱和度，为服务器带来独特的生存体验。

💡前置要求与兼容性

• Java 版本: 需要 Java 11 或更高版本。
• NBTAPI: 如果你的服务器（例如 Spigot）没有 Paper API，则需要安装 NBTAPI 插件。如果服务器已使用 Paper API，则不需要此插件。
• 兼容性支持:

- 支持 PlaceholderAPI (PAPI)，可使用相关占位符。

- 支持与任务或成就类插件联动。

PAPI 占位符

• %consumefood_foodlevel% - 玩家当前的自定义饥饿值。
• %consumefood_max_foodlevel% - 玩家最大的自定义饥饿值。

✨核心功能

• 修改任何食物的饥饿值恢复量与饱和度恢复量。
• 为食物添加食用后触发的药水效果或控制台/玩家命令。
• 通过命令直接设置或查询玩家的饥饿值与饱和度。
• 创建全新的自定义食物，并支持游戏内 GUI 编辑器进行编辑。
• 设置独立的、可同步的自定义饥饿值系统。
• 支持食物冷却时间设置（全局或个人）。
• 食用碗装或瓶装食物后，可设置是否返还碗或瓶子。

🔧安装方法

安装非常简单，只需将插件文件放入服务器的 plugins 文件夹，然后重启服务器即可。

🎮命令与权限

所有命令的权限默认对 OP 玩家开放。

帮助与重载

• 命令: /consumefood help
• 权限: consumefood.command.help
• 描述: 显示插件命令列表。

• 命令: /consumefood reload
• 权限: consumefood.command.reload
• 描述: 重载插件的配置文件。

自定义食物编辑器

• 命令: /consumefood edit
• 权限: consumefood.command.edit
• 描述: 打开自定义食物编辑 GUI。

给予自定义食物

• 命令: /consumefood get <player> <internalname> <amount>
• 权限: consumefood.command.get
• 描述: 给予指定玩家指定数量的自定义食物。
• 参数:

- `<player>`: 目标玩家。

- `<internalname>`: 自定义食物在 `customfood.yml` 中的内部名称（如 `food_1`）。

- `<amount>`: 数量。

管理饥饿值

• 命令: /consumefood hunger set <player> <amount>
• 权限: consumefood.command.hunger
• 描述: 设置玩家的饥饿值（原版饥饿条）。

• 命令: /consumefood hunger get <player>
• 权限: consumefood.command.hunger
• 描述: 查询玩家的饥饿值。

管理饱和度

• 命令: /consumefood saturation set <player> <amount>
• 权限: consumefood.command.saturation
• 描述: 设置玩家的饱和度。

• 命令: /consumefood saturation get <player>
• 权限: consumefood.command.saturation
• 描述: 查询玩家的饱和度。

管理自定义饥饿值

• 命令: /consumefood customhunger set <player> <amount>
• 权限: consumefood.command.customhunger
• 描述: 设置玩家的自定义饥饿值（需在配置中启用）。

• 命令: /consumefood customhunger get <player>
• 权限: consumefood.command.customhunger
• 描述: 查询玩家的自定义饥饿值。

⭐配置详解

config.yml 主要设置

**兼容性设置** (需重启服务器生效)

• PlaceholderAPI: 是否启用 PAPI 支持。
• Quest-or-Achievement: 是否启用任务/成就插件兼容。

**自定义饥饿值设置**

• Enabled-CustomFoodLevel: 是否启用自定义饥饿值系统。
• Sync-CustomFoodLevel: 是否将玩家原版饥饿值与自定义饥饿值同步（建议为 true）。例如，自定义饥饿值为 10/40 时，原版饥饿值会按比例显示为 5。
• Max-FoodLevel: 最大自定义饥饿值。
• Max-Saturation: 最大饱和度。
• Sprint-FoodLevel: 玩家能够奔跑所需的最低饥饿值（仅在同步启用时生效）。
• Return-BowlOrBottle: 食用炖菜、蜂蜜瓶等后是否返还碗或瓶子。

**饱腹时食用设置**

• Max-Consumable.Enabled: 当玩家饥饿条已满时，是否仍允许食用食物（但不会播放进食动画）。

**冷却设置**

• Cooldown-Setting.Type: 冷却类型，可选 global（全局冷却）、personal（每种食物独立冷却）、disable（无冷却）。
• Global_Cooldown: 全局冷却时间（秒）。

**食物属性配置**

在 Food: 部分，可以为每种原版食物（如 APPLE, COOKED_BEEF）设置：

• FoodLevel: 恢复的饥饿值。
• Saturation: 恢复的饱和度。
• Cooldown: 该食物的独立冷却时间（当全局类型为 personal 时生效）。
• PotionEffect: 食用后获得的药水效果列表，格式为 <效果类型>:<等级>:<持续时间（秒）>:<触发几率（0-1）>。效果类型参考 Spigot Javadoc。
• Command: 食用后执行的命令列表，格式为 <执行类型>:<命令>。执行类型可以是 console（控制台）或 player（玩家）。如果启用了 PAPI，命令中可使用占位符。

customfood.yml 自定义食物

在此文件中，你可以创建全新的食物。每个食物都需要一个唯一键（如 food_1），并可以设置以下属性：

• Material: 物品材质。
• Name: 物品显示名称（支持颜色代码）。
• Data: 物品附加值（可选）。
• Lore: 物品描述（支持颜色代码）。
• TextureValue: 当材质为 player_head 时，可设置头颅皮肤值。
• FoodLevel / Saturation / Cooldown / PotionEffect / Command: 功能同原版食物配置。

此外，还可以为所有自定义食物统一设置

• CustomFood-Max-Consumable.Enabled: 饱腹时是否仍可食用自定义食物。
• CustomFood-Disable-Block_Place.Enabled: 是否禁止放置自定义食物（防止其作为方块被放置）。
• CustomFood-Cooldown-Setting: 自定义食物的冷却设置，格式同全局配置。

message.yml 消息文件

你可以在此自定义插件发送的各种提示信息。如果留空，则不会发送该消息。消息中可以使用占位符（例如 %player_name%）。预定义的占位符包括：

• <customfood_global_timeleft>: 自定义食物全局冷却剩余时间。
• <customfood_personal_timeleft>: 特定自定义食物冷却剩余时间。
• <vanilla_global_timeleft>: 原版食物全局冷却剩余时间。
• <vanilla_personal_timeleft>: 特定原版食物冷却剩余时间。
• <max_foodlevel> / <max_saturation>: 最大饥饿值/饱和度。
• <customfood_name> / <food_name>: 食物名称。

❓支持与反馈

如果你在使用中遇到任何错误，或有希望添加的新功能，欢迎通过以下渠道反馈：

• Discord: https://discord.gg/YscANyuxrH
• 插件讨论页
• GitHub Issues

开发版本（Dev builds）会在 Discord 中发布，如果需要帮助或想体验最新功能，请加入我们的 Discord 服务器。开发者会根据时间安排，尽力添加大家期望的功能。