GoldenAppleControl - 金苹果控制

💡注意：项目已弃用

此插件已不再维护，需要大量工作才能修复。由于其自身复杂性较高，存在较多错误风险。建议使用其他替代插件。源代码可通过反编译获取，请勿使用 GitHub 上的代码（当前已损坏）。遵循许可协议：您可以进行改编和分享，但请注明原作者、链接至许可协议，并保持非商业用途（不得出售）。感谢大家的支持！

🎮插件简介

GoldenAppleControl 是一款功能全面的金苹果冷却时间管理插件。它不仅能为普通和附魔金苹果设置冷却，还能控制任何可食用物品的食用效果与冷却，并提供基于权限的冷却减免、完整的 PlaceholderAPI 支持以及高度自定义的配置选项。

✨主要功能

• 支持任意物品
• 不仅限于金苹果，您可以控制任何可食用物品的冷却与效果。

• 自定义冷却时间
• 轻松为两种金苹果（或任何物品）设置独立的冷却时间，防止玩家滥用。

• 自定义食用效果
• 完全自定义物品被食用时提供的效果、饱食度与饱和度。例如，您可以将附魔金苹果的再生效果等级调低，或改为给予负面效果。

• 基于权限的冷却
• 通过权限节点为特定玩家（如赞助者）设置不同的冷却时间，配置灵活。

• 占位符支持
• 完美支持 Clip's 和 Maxim's 的 PlaceholderAPI，可在消息中显示动态冷却时间。

• 高度可配置
• 所有消息、冷却时间、效果均可通过配置文件自由调整。

• 内置命令
• 提供 /gapple 命令，方便玩家查询剩余冷却时间。

🔧命令与权限

命令

• /gapple (别名: goldenapplecontrol, gac, goldenapple, gapplecooldown, gcd)
• 描述：显示你剩余的金苹果冷却时间。

权限

• goldenapplecontrol.use
• 描述：允许玩家使用 /gapple 命令查看冷却时间。
• 默认：op（仅限管理员）

• goldenapplecontrol.bypass
• 描述：允许玩家绕过所有冷却时间限制。
• 默认：op（仅限管理员）

⭐配置示例与说明

以下为配置文件的核心部分示例与说明

# 插件消息配置
plugin-messages:
  no-permission: "&7[&eGolden&6Apple&fControl&7] &cYou don't have permission."

# 使用 /gapple 命令时显示的剩余时间信息（需 PlaceholderAPI）
remaining-time:
  - "&6Golden apple&7:"
  - "&c%goldenapplecontrol_gapple%"
  - "&eEnchanted golden apple&7:"
  - "&c%goldenapplecontrol_enchantedgapple%"

# 物品配置示例
items:
  # 自定义配置项名称，可任意定义
  whatever-you-want:
    material: GOLDEN_APPLE # 物品材质
    data: 0 # 物品数据值
    permission: "goldenapplecontrol.randomperm" # 可选的专属权限节点
    cooldown:
      enabled: true # 是否启用冷却
      duration: 30 # 冷却时间（秒）
      use-formatted-time: true # 是否使用格式化的时间显示
      consume-message: # 尝试食用时的提示消息
        - "&7You can't eat another &6golden apple&7 for &c%TIME%&7."
      expired-message: # 冷却结束时的提示消息
        - "&7You may now eat another &6golden apple&7."
    placeholder:
      enabled: true # 是否启用占位符
      register-this: "gapple" # 占位符名称，使用时为 %goldenapplecontrol_gapple%
    consumption-control: # 食用效果控制
      enabled: true
      food-level: 4 # 恢复的饥饿值（半鸡腿）
      saturation: 9.6 # 饱和度
      effects: # 药水效果列表
        - ABSORPTION:2400:0 # 效果类型:持续时间(刻):放大器(等级-1)
        - REGENERATION:100:1

效果格式说明：效果类型:持续时间(刻):放大器(等级-1)。例如，REGENERATION:100:1 表示给予玩家 5 秒（100 ticks）的再生 II 效果。

❓开发者信息

API 接入

您可以通过 GoldenAppleControl.getInstance().getItemManager() 接入插件，以访问配置中的所有物品及其信息。请注意，Item#getPlaceholder()、Item#getPermissionNode()、Item#getCoolDown() 和 Item#getConsumptionControl() 可能返回 null。通过向 ItemManager#getItems() 添加新的 Item 对象可以轻松添加自定义物品。

Maven 依赖（仓库已离线，请勿使用）

<repository>
  <id>terrocidepvp-repo</id>
  <url>http://repo.terrocidepvp.net/artifactory/jenkins/</url>
</repository>
<dependency>
  <groupId>net.terrocidepvp</groupId>
  <artifactId>GoldenAppleControl</artifactId>
  <version>2.0.4</version>
</dependency>

🔧重要提醒

• 请勿在评论区（Reviews）提交错误报告，请使用私信或讨论区（Discussion）进行反馈。
• 插件版权归 GoldenAppleControl © 2016 所有。
• 配置中的 config-version 请勿手动修改。