SimpleCrates - 简易宝箱插件

SimpleCrates 是一款易于使用的箱子插件，允许你创建多种带有不同钥匙、奖励和命令的箱子，并包含大量其他功能，例如下面列出的这些。本插件完全免费，如果你喜欢它，可以考虑通过捐赠来支持开发者。

💡核心功能

• 创建带有自定义名称和描述的钥匙
• 创建无限数量的箱子和无限奖励
• 每个奖励可关联无限条命令
• 一个箱子可设置无限个摆放位置
• 使用单一命令轻松设置或移除箱子
• 轻松给予玩家钥匙（非常适合投票奖励！）
• 可自定义语言文件，以修改所有提示消息
• 开箱时可播放粒子效果、烟花和/或音效
• 若玩家使用错误钥匙，可将其击退
• 用于展示奖品的图形化界面（GUI）
• 高度可定制

扩展插件

• CSGOCrates：以 CS:GO 风格（横向、纵向、单列）的 GUI 滚动抽取箱子奖励。

🎮命令列表

• /crates - 显示主帮助页面
• /crates set <箱子名称> - 在目标方块处设置一个箱子
• /crates unset - 移除目标方块处的箱子
• /crates give <玩家> <箱子名称> <数量> - 给予玩家指定箱子的钥匙
• /crates giveall <箱子名称> <数量> - 给予所有在线玩家指定箱子的钥匙
• /crates reload - 重新加载语言文件（修改 lang.yml 后应使用此命令）
• /crates update - 手动检查并下载 SimpleCrates 更新
• /crates convert <箱子名称> - 如果启用了 CSGOCrates，将此箱子的所有奖励导入到 CSGOCrates 中

🔧权限

• crates.crates - 主要且唯一的权限。如果玩家没有此权限，则无法使用任何命令。此权限应仅授予管理员，因为它用于给予钥匙、设置/移除箱子和重载语言文件。
• 注意：普通用户仍然可以使用箱子和钥匙。

✨配置文件

插件生成以下配置文件，位于 plugins/SimpleCrates/ 目录下：

• crateList.yml：存储所有箱子的位置信息，请勿手动修改。
• crates 文件夹：存放所有箱子的配置文件。你必须复制、粘贴并编辑这些文件来创建新箱子。
• lang.yml：存储所有发送给玩家的消息文本，你可以在此文件中自定义消息。
• global-settings.yml：存储插件全局设置，如数据统计、概率 GUI 和自动更新。

global-settings.yml (v2.7 示例)

chanceGUI: false
check-updates: true
metrics: true

箱子配置文件示例 (example.yml)

key:
  name: '&a&lExample Key Name'
  lore:
    - '&b&lExample Key Lore'
  material: TRIPWIRE_HOOK
  data: 0
chest:
  blocks:
    - CHEST
    - ENDER_CHEST
broadcast:
  server: '&6%player% has opened an &8Example &6crate!'
  player: '&aThank you for opening an &8Example &6crate!'
reward:
  sample:
    command:
      command1:
        command: give %player% diamond 1
        delay: 0
      command2:
        command: broadcast %player% has won 1 diamond!
        delay: 0
    chance: 50
    gui:
      item: '5:2'
      name: '&6Pears'
      lore:
        - '&cWin 1 diamond!'
      enchants: 0:4, 1:3, 2:1
      amount: 1
      glow: false
  example:
    command:
      command1:
        command: eco give %player% 1000
        delay: 0
      command2:
        command: broadcast %player% has won $1000
        delay: 0
    chance: 50
    gui:
      item: '5:1'
      name: '&aguiName'
      lore:
        - '&cWin 1000 dollars!'
      enchants: 2:4, 1:1, 3:1
      amount: 2
      glow: false
chance-gui-name: '&6&lExample'
firework:
  enabled: true
  power: 1
  effects:
    - flicker:true
    - trail:true
    - with:BALL
    - withColor:255,0,255
    - withFade:0,255,255
particles:
  enabled: true
  type: MOBSPAWNER_FLAMES
  offset-x:
    min: -1.0
    max: 1.0
  offset-z:
    min: -1.0
    max: 1.0
  amount: 10
  id: 0
  data: 0
  speed: 0.1
  radius: 15
sound:
  enabled: true
  type: UI_BUTTON_CLICK
  volume: 5.0
  pitch: 0.0
knockback:
  power-x: 0.25
  power-y: 0.3
  power-z: 0.25
crate-particles:
  enabled: true
  type: LARGE_SMOKE
  offset:
    x: 1
    z: 1
  amount: 10
  id: 0
  data: 0
  speed: 0.1
  radius: 15
  delay: 20

lang.yml (v2.7 示例)

target-not-chest: '&c目标方块不是箱子！'
sender-not-player: '&c你不能通过控制台执行此命令！'
proper-set-usage: '&4正确用法: &c/crates set <箱子名称>'
proper-give-usage: '&4正确用法: &c/crates give <玩家> <箱子名称> <数量>'
proper-give-all-usage: '&4正确用法: &c/crates giveall <箱子名称> <数量>'
crate-not-found: '&c此位置没有设置箱子！'
crate-unset: '&a已移除此位置的 %crate% 箱子！'
given-key: '&a你获得了 1 把 %crate% 钥匙！'
given-keys: '&a你获得了 %amount% 把 %crate% 钥匙！'
gave-key: '&a你给予了 %givento% 1 把 %crate% 钥匙'
gave-keys: '&a你给予了 %givento% %amount% 把 %crate% 钥匙'
player-not-online: '&c玩家不在线！'
not-a-number: '&c请输入有效的数字！'
crate-set: '&a已在此位置设置了一个 %crate% 箱子！'
reloaded: '&a语言文件已重新加载！'
no-crate-with-this-name: '&c没有此名称的箱子！'
regenerate-config: '&c请重新生成你的配置文件！'
more-than-100: '&c奖励概率总和超过 100！请联系管理员修复此问题！'
not-unlockable-with-item: '&c你需要一把 %need% 钥匙才能使用此箱子！'
unknown-subcommand: '&c未知的子命令！'
didnt-win: '&c你没有从 %crate% 中获得任何奖励！'

❓如何设置新箱子

• 复制并粘贴示例箱子文件（example.yml），或直接编辑该文件以满足你的需求。
• 复制文件后，请务必更改文件名，并根据你的喜好编辑其内容。

**教程视频**

• [英文教程]
• [土耳其语教程]

⭐注意事项与支持

• 如果你正在使用 Spigot 1.8，请确保你使用的音效类型是兼容的。如果是 1.9 或更高版本，请参考相关更新说明。
• 开发者免费维护此插件。如果你觉得它很棒，可以考虑通过页面顶部的链接进行捐赠。捐赠后可以私信开发者验证，你的服务器 IP 可能会被列在感谢列表中。
• 如果你有任何建议、错误报告或评论，请在插件的讨论区发布或私信开发者。
• 如果你喜欢这个插件，请留下真诚的评论！