ItemRewards - 自定义物品奖励炸弹

ItemRewards 是一款功能强大的“物品炸弹”创造插件。玩家可以购买并投掷这些炸弹，根据炸弹类型，为全服玩家或自己发放随机物品奖励。所有奖励物品、概率、成本、动画效果均可自定义，为服务器经济与活动系统增添无限可能。

💡核心功能

• 物品奖励商店 (GUI)：玩家可通过直观的图形界面购买奖励。
• 物品奖励使用界面 (GUI)：玩家可在此查看并投掷已购买的奖励。
• 自定义奖励：
• 自定义名称与描述。
• 设置购买成本（需要 Vault 经济插件）。
• 设置每次可赢取的奖品数量（最多 3 个）。
• 设置奖励类型：全局 (Global) 或私有 (Private)。
• 选择领取奖励时的动画效果。
• 设置购买权限。
• 配置自定义奖品物品。
• 自定义奖品物品：
• 自定义名称与描述。
• 添加附魔。
• 添加药水效果。
• 设置皮革盔甲颜色。
• 添加附魔书属性。
• 创建成书。
• 设置烟花火箭属性。
• 设置旗帜与盾牌属性。
• 设置头颅材质。
• 隐藏物品标签。
• 设置物品为不可破坏。
• 添加属性修饰符。
• 设置随机数量。
• 使用命令代替物品作为奖励。
• 便捷命令：使用 /ir save 可快速保存手中物品至配置。
• 世界控制：可指定插件生效的世界。
• 跨版本兼容：支持 1.8 及以上版本。
• 多语言支持：通过 messages.yml 文件轻松翻译。
• 服务端兼容：支持 CraftBukkit 与 Spigot。

🎮命令与权限

可用命令

• /ir - 打开购买/使用物品奖励的 GUI 菜单。
• /ir give <玩家> <奖励名称> [数量] - 给予指定玩家特定数量的物品奖励。
• /ir open <玩家> <奖励名称> - 为指定玩家直接打开一个物品奖励。
• /ir save <名称> - 将手中物品的属性保存至配置文件。
• /ir help - 显示帮助信息。
• /ir info - 显示插件信息。
• /ir reload - 重载插件配置。

权限节点

• itemrewards.admin - 授予使用所有管理员命令的权限。

🔧安装与配置

安装步骤

• 从 BukkitDev 下载 ItemRewards 和 Vault 插件。
• 将两个 .jar 文件放入服务器的 plugins 文件夹。
• 启动服务器，插件将自动生成配置文件夹和文件。
• 根据下方教程编辑 config.yml 文件。
• 编辑完成后，在游戏内或控制台执行 /ir reload 使配置生效。

配置教程

主要设置 (Main Section)

在 config.yml 的顶部，您可以进行基础设置：

• 物品 ID：定义菜单装饰、主菜单按钮等使用的物品。1.13+ 版本请使用材质名。
• 音效：为各种事件（如全局奖励、动画）设置音效。不同 Minecraft 版本音效名称不同，请查阅对应资料。
• firework_on_reward: true - 玩家领取奖励时是否生成烟花。
• enabled-worlds - 列出插件生效的世界名。
• buy-item-rewards-enabled: true - 是否启用商店购买功能。

创建物品 (Items Section)

在此部分定义可作为奖品发放的自定义物品。您可以直接编辑配置，或使用 /ir save <名称> 命令快速保存手中物品。

一个手动配置的示例

Items:
  我的头盔:
    id: 306 # 物品ID，1.13+请使用材质名
    name: "&6守护者头盔"
    amount: 1 # 或使用 1-30 表示随机数量
    lore:
      - "&8拥有此物，令人敬畏"
    enchants:
      - PROTECTION_ENVIRONMENTAL;7
    hide-flags:
      - HIDE_ATTRIBUTES
    unbreakable: true
    command-reward: # 使用命令作为奖励
      - pex user %player% group set VIP

重要提示：对于头颅、附魔书、烟花等复杂物品，强烈建议使用 /ir save 命令自动生成配置。

创建奖励 (Rewards Section)

在此部分定义玩家可以购买的“物品炸弹”奖励。

一个配置示例

Rewards:
  普通奖励:
    name: "&a普通 &2物品奖励 &7[&e%star%&7]" # %star% 变量会显示为 ✮
    lore:
      - "&7最基础的物品奖励"
      - "&2价格: &a$1000"
    cost: 1000 # 价格，需要Vault
    permission: itemrewards.buy.普通奖励 # 可选购买权限
    prizes_to_win: 1 # 可赢取的奖品数量 (1, 2, 或 3)
    type: private # 类型：private (私有) 或 global (全局)
    animation_type: 1 # 动画类型
    items:
      - 钻石;80 # 格式：物品配置名;概率权重
      - 胸甲;15

• 全局奖励：投掷后，全服在线玩家会收到一条可点击的聊天信息来领取奖励。
• 私有奖励：只有投掷者自己能获得奖励。

❓常见问题

• 我需要 Vault 吗？

是的，如果您需要设置奖励的价格（经济系统），则必须安装 Vault。Vault 是大多数经济插件的桥梁。

• 支持其他经济插件吗？

只要该经济插件通过 Vault 提供支持，即可兼容。如果您使用的插件不兼容，请联系开发者寻求支持。

• 如何翻译插件信息？

编辑 plugins/ItemRewards/messages.yml 文件，修改其中的文字内容即可。文件内已包含英文和西班牙文示例。

• 配置出错怎么办？

请先检查 YAML 语法（如缩进、冒号后的空格）。修改配置后，务必使用 /ir reload 重载。如果问题依旧，请到插件讨论区反馈。

✨提示与支持

• 充分利用 /ir save 命令，它能极大简化自定义物品（尤其是带有复杂附魔、描述、属性的物品）的配置过程。
• 在发布负面评价前，请先通过讨论区联系开发者反馈问题。开发者会积极查看并修复漏洞。
• 您可以在插件页面找到详细的配置教程视频（西班牙语、英语、俄语）。