修复：

• 修复了一个问题：当边界被关闭且你没有第二页时，原本会显示一块玻璃板。
  • 现在在边界开启前，该位置将直接为空气。

修复：

• 修复了奖励分页的问题。
• 修复了下一个/主页/返回按钮为静态而非动态的问题。
  • 更改行数时，这些按钮不会随界面重新调整大小。

更改：

• 如果玩家不在四重箱装下界石英的会话中，则不再在 PlayerMoveEvent 上执行繁重的检查

重大变更：（仅针对现有配置）

如果你不进行此更改，你所有的预览界面都会显示异常。

• config.yml 有一项无法自动完成的更改。
  • 由于最近的物品栏（Inventory）更改，自定义项（customizer）中的 slot 选项受到影响。
  • 你必须将每个选项减 1，并从 slot:0 开始，而不是 slot:1。
• crate（板条箱）文件中的每个选项也需要进行类似的调整，将数值减 1。
  • 具体涉及 /crates 中板条箱的位置以及等级预览中等级的位置。
• 为什么会有这个更改？物品栏（Inventory）本身是从 0 开始计数的，而我现在使用的 GUI 框架也是从 0 开始的。
  • 这一更改使得物品栏管理更加轻松，并为未来功能提供了便利。

新增内容：

• 为奖品新增了一项功能：可以设置奖品的中奖次数限制。
  • 如果某个奖品的 Max-Pulls 设置为任意数字（即 1 或更高）。
  • 该限制将对所有玩家全局生效。
  • 一旦达到该限制，该奖品将无法再被抽中。
    • %pull% 和 %maxpulls% 是 2 个新的占位符，可用于 DisplayLore、DisplayName、Messages、Commands 以及全局/单奖品广播中。
  • 符合条件的奖品会自动添加一条描述信息（lore）。
    • 该消息可以在 messages.yml 中编辑，如果你不希望添加，可以将其设置为空。

以下是带有 Max-Pulls 选项的奖品示例：

    '6':
      # 在 GUI 中显示的物品名称。
      DisplayName: "<green>华丽盾牌 <gray>| <red>%pulls%<gray>/<red>%maxpulls%"
      # 在 GUI 中显示的附魔。
      DisplayItem: "shield"
      # 图案列表：https://jd.papermc.io/paper/1.21/org/bukkit/block/banner/PatternType.html
      # 图案不需要大写，你可以连同颜色一起使用小写输入。
      # 图案必须按特定顺序排列，否则显示会不正确。
      # 这同样适用于 Items 部分。
      DisplayPatterns:
        - "base:white"
        - "gradient_up:light_gray"
        - "straight_cross:light_blue"
        - "flower:light_blue"
      # 奖品设置
      Settings:
        # 物品的自定义模型数据，-1 表示禁用。
        Custom-Model-Data: -1
        # 此物品可被抽中的次数。
        Max-Pulls: 10

• 新增了为奖品设置单奖品广播和全局广播的功能。
  • 用于筛选谁能看到广播的权限已注册为正式权限，因此它们会显示在 LuckPerms 中。
  • 当你关闭单奖品广播或全局广播时，这些权限会被移除。

移除内容：

• 所有旧版颜色代码已被移除，我已经找到了无需依赖它们的解决方案，因此不再维护。
  • 你可以运行 /crazycrates migrate LegacyColorAll，这将迁移 config.yml、messages.yml 以及所有 crate 文件中的所有值。

修复内容：

• CSGO 板条箱动画莫名延迟了 1 tick。
• 修复了 https://github.com/Crazy-Crew/CrazyCrates/issues/788
• 修复了 migrate 命令用法中的间距问题。

变更内容：

• 从内部改进了 /crazycrates migrate 命令。
  • ExcellentCrates 迁移器已发生重大变化，如发现任何 bug 请上报。它将把旧版颜色代码转换为 MiniMessage。
  • 如果输入的迁移类型无效，会正确地向玩家/发送者发出警告。
• 移除了当 Editor-Items、Commands 和 Items 均未找到时发放奖品的相关代码段。
  • 此前会将 DisplayItem、DisplayName、DisplayLore、DisplayEnchantments 和 DisplayAmount 作为奖品发放。
• 更新了 /crazycrates additem 命令
  • CrazyCrates 的 additem 命令现在支持 MiniMessage，无论使用何种物品格式。
  • 之所以有此更改，是因为旧版颜色已被移除，并且我进行了一些研究以改进相关功能。
• 更新了配置选项 use-old-editor，现已迁移为 use-new-editor
  • true 使用新编辑器，false 使用可读性更高的旧编辑器。该选项会在启动时自动迁移。
• 更新了 Vital API。

修复：

• 修复了部分命令未能正确校验虚拟密钥的问题

弃用

• 弃用了 PlayerPrizeEvent(player, crate, crateName, prize)
  • 请使用 PlayerPrizeEvent(player, crate, prize)，因为 crateName 已通过 crate 对象传递。

修复：

• 修复了使用 Data: 或 DisplayData: 时物质重构机的类转换异常

修复：

• 修复了 /crazycrates migrate ExcellentCrates 的问题
  • 添加了一个缺失的配置选项，该选项是我们的箱子配置中所必需的。

变更：

• 移除了所有用于检查 PersistentDataContainer 的 getItemMeta/hasItemMeta 调用
  • 现在我们改用 ItemStack#PersistentDataContainerView 进行检查，不再依赖 ItemStack#getItemMeta
  • 简而言之：性能提升

新增：

• 新增了一个开关，允许你撤销之前所做的几率更改。
  • crazycrates.open.<crate_name> -> crazycrates.deny.open.<crate_name>
• 该配置选项位于 config.yml 中，即 root.use-new-permission-system，默认值为 false
  • 此选项将来可能会被移除，目前以开关形式存在，false 表示恢复旧系统，即 crazycrates.open.<crate_name>。
  • 新方式 crazycrates.deny.open.<crate_name> 将在下一版 Minecraft 中移除！
  • 今后所有进一步的实验都将通过类似这样的开关进行控制。

新增：

• 支持从 ExcellentCrates 迁移板条箱配置。
  • ExcellentCrates 中的激活位置也会一并迁移！
• 新增一项功能，RequiredKeys 现在也可以指定钥匙数量 #755
  • 需要将 config.yml 中的 use-required-keys 设置为 true 才能生效。
• 为奖品和等级添加了 %chance% 占位符

板条箱配置变更：

• Crate.CrateName 已弃用，由 Crate.Name 取代
  • 这两个选项是重复的，其中一个从未被使用，让人很恼火。
  • Crate.CrateName 将在下一个 Minecraft 版本中移除！
  • 你可以运行 /crazycrates migrate CratesDeprecated 来迁移已弃用的选项。

Crate:
  # https://docs.crazycrew.us/docs/plugins/crazycrates/misc/crate-types

  # 如有此处未说明的内容，请务必查阅 wiki。
  # https://docs.crazycrew.us/docs/category/crazycrates

  # 寰宇板条箱（Cosmic Crate）类型的运作方式请参见 CosmicCrate.yml。
  CrateType: Casino
  # 如果是 GUI 板条箱，则为容器的名称。
  CrateName: "<dark_blue>Casino Crate" # 已弃用，但仍可使用
  # GUI 中物品的名称。
  Name: "<bold><dark_blue>Casino Crate</bold>" # 未找到 CrateName 时将使用此项
  # GUI 中物品的 Lore。
  Lore:
  - "<gray>这个板条箱装着奇怪的物品。"
  - "<gray>你有 <gold>%keys% 把钥匙 <gray>可以用来打开这个板条箱。"
  - "<gray>你已打开这个板条箱：<gold>%crate_opened% 次"
  - "<gray>(<yellow>!<gray>) 右键查看奖励。"

• Crate.Preview-Name 已弃用，由 Crate.Preview.Name 取代
  • 该选项本应始终位于 Crate.Preview 之下
  • Crate.Preview-Name 将在下一个 Minecraft 版本中移除！
  • 你可以运行 /crazycrates migrate CratesDeprecated 来迁移已弃用的选项。

  Preview:
    # 预览菜单容器的名称。
    Name: "<green>Basic Crate Preview" # 已移至 Preview 之下
    # 开启或关闭此板条箱的预览。
    Toggle: true
    # 板条箱预览应有多少行。包括顶部和底部（3 到 6 之间）
    ChestLines: 6
    Glass:
      # 开启或关闭预览中的玻璃边框。
      Toggle: true
      # 边框物品的名称。
      Name: " "
      # 显示在边框中的物品。可以是玻璃或任何其他物品。
      Item: "gray_stained_glass_pane"
      # 物品的自定义模型数据，-1 表示禁用。
      Custom-Model-Data: -1 

修复：

• 修复了偶尔无法打开快速板条箱（QuickCrate）的罕见问题
• 修复了寰宇板条箱（CosmicCrate）的复制问题
• 修复了可能无法检测到 CMI 的问题

变更：

• 右键现在也可以打开板条箱菜单。
• 改为检查位置字符串而非对象 id
• 简化了多个位置获取方法，如果不修改位置，就不需要获取同一个位置 3 次。
• 消息中的 {crate} 现在将返回 Crate.Name 而非文件名
  • 清理了内部有时会使用文件名以及不良命名方案的相关代码。
  • Crate#getName() 现改为 Crate#getFileName()，而 Crate#getCrateInventoryName() 现改为 Crate#getCrateName()
• 在打开板条箱前先检查奖品部分是否为空，避免不必要的几率计算。
• 全面改进了 /crazycrates migrate 命令，会发送更详细的迁移内容信息。
  • 显示为红色的文件迁移失败，绿色的文件迁移成功，
  • 它还会告诉你运行命令时选择的迁移类型，同时还会重载插件！
  • 只有在发现 CratesDeprecated 选项中存在需要迁移的内容时，才会保存到文件
  • 只有当 config.yml 中的 use-old-editor 设置为 false 时，才会迁移 Editor-Items
• 许多其他变更属于内部清理，我只是在当清洁工。功能应当不会有变化。
• 弃用了 config.yml 中的 use-minimessage，它将在下一个 Minecraft 大版本中移除
  • 该库（由我编写）现在拥有自己的目录，与 bStats 类似。每个使用它的插件都会在其中生成一个配置文件。
  • 在 use-minimessage 被移除后，你只需编辑那个文件即可，即 Vital/crazycrates-config.yml
  • 一旦 use-minimessage 选项被移除，将 is-legacy 设置为 false 即可启用 MiniMessage

新增：

• 将Minecraft版本升级至1.21.1
  • 请尽快更新到1.21.1，没有任何改动会阻止插件在1.21.1上使用
  • 这个Minecraft版本只是修复错误的小版本，即插即用，除非插件开发者异常地设置了一些硬编码限制。

变更：

• 正确重定位了命令框架
• CsgoCrate（CS:GO宝箱）现在在任务完成后，会在你赢得的奖励上方和下方各放置一个物品。
  • 未来这将可以配置，我只是不知道该叫它什么。
• 更新了权限描述
• 更新了 exclude.give-all，默认值改为 FALSE，#774
• 升级了CMI依赖

修复：

• 配置选项中的拼写错误
• Adventure API 问题 #770
• CsgoCrate 缺少2块玻璃板 #772
• CsgoCrate 的玻璃板没有播放动画

新增：

• 在插件的各处添加了缺失的配置性信息，现在所有信息都应可配置。
• 添加了一个新的配置选项，你可以选择在聊天栏还是动作栏中发送信息。
  • 在聊天栏中发送列表的信息默认永远不会发送到动作栏，因为这样显示效果不好。
• 为 crates.requirements.not-enough-keys 添加了一个新的占位符 {required_amount}
• 为 crates.requirements.not-enough-keys 添加了另一个新占位符 {key}，#756
  • 此占位符返回金钥匙的名称。
• 添加了一种新的迁移类型，可转换板条箱文件中已弃用的字段。
• 在 config.yml 中添加了 2 个新的切换设置，你可以在文件顶部找到它们。
  • use-old-editor 要求 use-minimessage 必须设为 false，因为它使用旧版颜色代码。
• 添加了按奖品单独设置的广播功能，这会向服务器上的每位玩家发送一条信息。

    '5':
      # 物品的显示名称。
      DisplayName: "<yellow>$1,000"
      # 在界面中展示的物品。
      # 附魔书在铁砧中可以正常使用其附魔。
      DisplayItem: "sunflower"
      # 奖品设置
      Settings:
        # 物品的自定义模型数据，-1 为禁用。
        Custom-Model-Data: -1
        # 向服务器广播一条信息
        Broadcast:
          # 是否应发送这些信息。
          Toggle: false
          # 要广播的信息。
          Messages:
            - '<red>%player% won the prize <yellow>%reward%.'
          # 如果玩家拥有此权限，则不会收到广播。
          Permission: 'your_permission' 

• 为 crazycrates debug 的 Player 参数添加了可选设置，以便你可以在终端中使用它。
• 添加了缺失的提示信息，用于通知物品已通过 /crates additem 添加

变更：

• 玩家能否打开板条箱的权限检查已更改。
  • crazycrates.open.<crate_name> 现在更改为 crazycrates.deny.open.<crate_name>
  • 板条箱名称区分大小写，因此必须与 crates 文件夹中的板条箱名称完全匹配
  • 如果文件名为 CrateBeans.yml，则必须为 crazycrates.deny.open.CrateBeans
• 如果 messages.yml 中的某条信息为空白，则不会发送该信息。
• 更新了 crates.crate-no-permission 的默认信息
• 由于语法问题，更新了部分注释。
• 更新了 CrateOpenEvent 被取消时的日志信息，使其更加详细。

修复：

• 转盘板条箱的动画现在可以正常旋转。#764
• 俄罗斯轮盘板条箱的容器大小现已恢复正常。#765
• 当编辑器物品不为空时，不再给出 2 个奖品。
• 赌场/宇宙板条箱的奖等预览会共享总物品数，导致容器未满时也出现分页。

弃用：

• 弃用了 {key_amount}，并在 crates.requirements.not-enough-keys 中用 {required_amount} 替代
  • {key_amount} 将在下一个 Minecraft 大版本中停止生效。

新增：

• 支持在 Items 中让物品发光

Items:
  - 'Item:spawner, Glowing:true'

修复：

• verbose-logging 配置项未应用到插件的某些部分。

变更：

• 执行 /crazycrates reload 时不再将 DisplayData 的内容添加到 Items 部分
• 将盾牌图案类型和颜色改为小写，同时修复了一个显示问题，因此之前的盾牌图案/颜色配置仍然有效。不再需要像 GRADIENT_UP:LIGHT_GRAY 这样输入，你可以直接输入 gradient_up:light_gray
• 弃用 Patterns，推荐使用 DisplayPatterns，前者将在下一个 Minecraft 大版本中移除。

    '6':
      # 在 GUI 中显示的物品名称。
      DisplayName: "<green>Fancy Shield"
      # 在 GUI 中显示的附魔。
      DisplayItem: "shield"
      # 图案列表：https://jd.papermc.io/paper/1.21/org/bukkit/block/banner/PatternType.html
      # 图案不需要大写，你可以使用小写输入图案和颜色。
      # 图案必须按照特定顺序排列，否则显示会不正确。
      # 这同样适用于 Items 部分。
      DisplayPatterns:
        - "base:white"
        - "gradient_up:light_gray"
        - "straight_cross:light_blue"
        - "flower:light_blue" 

新增：

• 支持在奖品中定义刷怪笼类型

    '1':
      # 在 GUI 中显示的物品名称。
      DisplayName: "<green>爬行者刷怪笼"
      # 在 GUI 中显示的附魔。
      DisplayItem: "spawner"
      # 奖品设置
      Settings:
        # 物品的自定义模型数据，-1 为禁用。
        Custom-Model-Data: -1
        # 刷怪笼的生物类型。
        Mob-Type: creeper
      # 在 GUI 中显示的数量。
      DisplayAmount: 1
      # 最大范围，例如 15/100 = 15% 的中奖概率。
      MaxRange: 100
      # 中奖概率，例如 15%。
      Chance: 23
      Items:
        - 'Item:spawner, Mob:creeper'

变更：

• 在没有所需按键时也会播放击退效果/声音。
• 移除了运行时依赖加载器。

Cosmic Crate：

• Cosmic Crate 在三月已改为在打开容器时处理等级计算，这样在选择神秘卡牌包时，你的选择才会真正生效！
• 我注意到可以使用客户端修改模组来作弊，此问题已解决，这些模组将无法再通过查看物品差异来作弊。
• 计算仍然会进行，但选择结果会以玩家的 UUID 为键缓存在内部，该缓存在玩家退出、容器关闭或抽奖任务因某种原因结束时清除。

修复：

• 修复首次安装时找不到文件的问题。
• 修复 examples 文件夹未能正确创建的问题。
• 修复盾牌无法获得颜色或图案的问题。
• 修复 奇迹 类型的容器从不播放循环声音的问题。
• 修复 轮子 类型的容器播放两次停止声音的问题。
• 修复 轮子 类型的容器不播放循环声音的问题，因为大多数玩家静音了客户端音乐。
• 修复 战争 类型的容器播放循环声音过早的问题。

修复：

• 修复了 /crazycrates migrate 命令的问题。
• 修复了命令中多处空值检查的问题。
• 修复了无效参数输出未显示正确语法的问题。

更改：

• 更新了迁移命令的格式。
• 更新了无效参数的输出，以更好地描述问题。

修复：

• 重构了物品/预览显示名称的处理方式，此格式现在可正常工作，并可与原版物品叠加。

    '1':
      # 在 GUI 中展示/给予的物品。
      DisplayItem: "diamond"
      # 展示/给予的数量
      DisplayAmount: 3
      # 最大范围，即 25/100 = 15% 的中奖概率。
      MaxRange: 100
      # 中奖概率，即 25%
      Chance: 25

• 为四合抽奖箱（Quad Crates）做了临时修补
• 当 /crazycrates set <crate> 中已存在抽奖箱位置时，为 {crate} 使用正确的抽奖箱名称
• 修复了 /keys view 的空指针异常，此前未提供玩家名称导致出错。
• 修复了消息中占位符解析的空指针异常。

变更：

• 优化了四合抽奖箱/快速抽奖箱上方奖励的显示

修复：

• 修复了 ItemBuilder 无法对 Oraxen 物品进行进一步修改的问题。

变更：

• 之前与板条箱交互时，会同时检查虚拟钥匙和实体钥匙，但使用哪一种全凭随机，现在交互的优先级逻辑与 /crates 一致……优先检查实体钥匙，再检查虚拟钥匙。
• 如果你手持的钥匙无法打开所注视的板条箱，且配置选项已启用，则会改为检查你的虚拟钥匙；如果找到可用钥匙……将使用虚拟钥匙打开板条箱。一如既往，请报告任何错误。

修复：

• 当检查发现玩家没有足够的钥匙时，取消钥匙检查事件。
• 简化钥匙检查逻辑，使虚拟钥匙能够正常工作，这移除了一次不必要的实体钥匙检查——因为我们之前重复检查了两次？何必呢……
• config.yml 中 physical-crate-accepts-physical-keys 和 virtual-crate-accepts-physical-keys 的配置注释有误。

变更：

• 以下修复要求预览只能通过左键点击打开，以便右击仅用于打开板条箱。

修复：

• 右击板条箱时的钥匙检查已生效，但我们之前没有告知玩家他们没有钥匙。

修复：

• 修复了文件管理器无法正确加载/重新加载文件的问题。

修复：

• 在使用 Player#addItem 时，将 MaxStackSize（最大堆叠数量）应用到玩家的物品栏中。现在给予 99 把钥匙或任何物品时，不会再在物品栏中直接堆叠 99 个，而是拆分为 64/35
  • Spigot 出于某种奇怪的原因，让 Player#addItem 使用了物品栏的最大堆叠数。#hardforkwhen

变更：

• 简化了内部使用占位符解析消息的方式