CrazyCrates 3.5
on 2026 Sep 02变更：
- 所有文件读取/写入操作实际上已移出主线程。
CrazyCrates 3.4.9
on 2026 Sep 02移除：
- 不再需要
console_prefix配置选项。
变更：
- 使用组件日志器处理启动依赖。
修复：
- 修复了 PlaceholderAPI 的问题。
CrazyCrates 3.4.8
on 2026 Sep 02更改：
- 更新了与集市板条箱交互的处理方式。
修复：
- 防止可放置的方块被放置在绊线钩或蜡烛等方块上。
CrazyCrates 3.4.7
on 2026 Sep 02新增：
- 一种为物品应用
CustomModelData的新方式，此更新避免了一个并非错误的“错误”出现。-1表示不会应用自定义模型数据！- 我们的文档将于本周末更新为新格式，但你可以继续使用旧格式。
- 旧格式
tripwire_hook#custom_model_data仍可继续使用，但请注意这已是弃用通知。 - 请尽量使用新格式，你可以在
examples文件夹中查看该格式的一些应用示例。
CrazyCrates 3.4.6
on 2026 Sep 02更改：
Lore->DisplayLore的弃用警告现在更加详细，它会告诉你奖品名称和奖励箱文件。
CrazyCrates 3.4.5
on 2026 Sep 02变更：
config.yml中的verbose_logging现在适用于包括错误在内的一切内容，如果某些功能无法正常工作，请将其开启。
CrazyCrates 3.4.4
on 2026 Sep 02修复：
- 之前玩家头颅无法堆叠，现在可以正常堆叠了。
CrazyCrates 3.3.1
on 2026 Sep 02修复：
/crazycrates giveall命令没有权限要求。- 通过
Items获取的物品无法与原版物品堆叠。
往期更新
新增：
- 1.20.6 支持
移除：
- 1.20.4 支持
修复：
- 战争板条箱在关闭容器时不再出现 Bug。
- 文件在 Linux 上无法正常加载的问题。
- 将默认文件中的玩家名称改为大写，以避免某些愚蠢的错误。
- 虚拟钥匙无法从离线玩家身上扣除的问题。
- 在 /crazycrates open-others 中添加 {key} 占位符
- /crates mass-open 中缺少占位符 {key}
- 暂时注释掉了直接支持 ItemsAdder 的代码，直到 LoneDev 完成他们想要的更改为止。
- 当配置选项 Crate.StartingKeys 不为 0 时，新玩家无法获得钥匙的问题。
- 从 crates 文件夹中删除文件后运行 /crazycrates reload 时会报文件未找到的错误。
- 使用 /crates additem 时 Lore 未被正确处理的问题。
- 更新了命令中的消息，不再使用 misc.no-virtual-keys，而是使用 misc.no-keys 消息。
- 使用 /crates forceopen 时，将消息发送给命令执行者而不是玩家。
- b25b867 修复赌场/寰宇等级的预览无法正常工作的问题 (#726)
- 46e6dba 重新添加 /crazycrates forceopen 命令 (#715)
- 5940d29 修复工作流的编译问题 (#724)
- d9a9f49 寰宇板条箱 (#716)
- 854efe6 修复玩家退出时的错误 (#719)
- 修复 QuickCrate 中全息图堆叠的问题。
- 修复 QuickCrate 上方物品的显示名称被 [] 包围的问题，例如 [钻石头盔]
- open-others 不应被所有人使用的问题。
- 默认赌场板条箱。
- 更新了后备音效。
新增：
- 支持 Arcaniax 的 HeadDatabase 中的头颅！查看 examples/crates 文件夹中的 CrateExample.yml 了解如何使用 HeadDatabase 头颅。
API：
- 将 crazycrates api 升级到 0.7
破坏性更改：
- 所有用于药水、材料、方块、盔甲纹饰材料/图案以及音效等的物品 ID 均已更改。
- 附魔不再使用
PROTECTION_ENVIRONMENTAL和DAMAGE_ALL，而是使用protection和sharpness
更改：
- 更新至 2.2.0 FancyHolograms，他们在 api 中进行了破坏性更改，因此所有旧版本的 FancyHolograms 将无法继续使用。
- 命令/常规权限已更新！
- 更新了部分 if 判断的顺序，以避免在不必要时进行可能开销较大的调用。
- 从示例 config.yml 中移除了 unsupported-settings
- 战争/寰宇板条箱的 PlayerCloseEvent 监听器已被合并，并减少了不必要的方法调用。
- 可以设置全息图的更新间隔，-1 表示禁用。
- /crazycrates migrate <crate> <type> 用于将材料/附魔/盔甲纹饰材料更新为 Mojang 映射的 ID。
- 在已被占用的位置上执行 /crazycrates set <crate> 会提示该位置已存在。
- 允许对通过 /crazycrates set Menu 创建的位置进行左/右键点击。
- 更新了 /crazycrates additem 命令，支持你在游戏中制作的任何物品，你仍然可以对添加的物品应用其他配置，例如你自己的自定义 Lore。
- 此更改需要对其他一些地方进行调整，因此如发现任何异常，请通过我们的 Github Issues 页面报告。
'7':
DisplayName: '<red>This is a name.'
DisplayLore:
- '<yellow>This is a lore.'
DisplayEnchantments:
- 'sharpness:5'
DisplayData: H4sIAAAAAAAA/53PQQrCMBAF0N8mQo0giEtv4sqFZ3Bb0iRiaDNTkhS8vTaI1KV0OfDfzB8FCOyuOuubi8kzAftXg9pbnIInZ6K+53M3aNO36TENvYttx0+BjeGJMoBKQRkOI5OjnLY4LswwZT1PUc05KSDTwIVAQfrswufOYQHW68Bkf7ZfSr+vq1a6eqUT/7umvPUGDbb6oU0BAAA=
MaxRange: 100
Chance: 10
- 注意：所使用的物品仍然有各自的限制，例如潜影盒不会发光。如果你无法在原版 Minecraft 中通过 /minecraft:give 做到，我们的插件也无法做到。
- 弃用奖品中的
Lore，改用DisplayLore，如果仍在使用，控制台会给出警告。Lore将在下一个 Minecraft 主版本 (1.22) 中被移除。
CrazyCrates 3.4.3
on 2026 Sep 02修复：
/crazycrates giveall此前没有权限要求。
之前的更新
新增：
- 1.21 支持
移除：
- 1.20.6 支持
变更：
- 修复了通过
Items给予的物品无法与通过原版方式获得的物品堆叠的问题。 - 修复了 /crates additem 未在
Items部分添加Data:，导致插件将其误认为是附魔的问题。 - 再次更新了
/crazycrates additem的输出，以便根据你手中持有的物品创建带有Item的Items部分。 - 你的奖品中所有已存在的选项如果带有
DisplayData，将会创建一个Items部分。 DisplayData的用途应仅限于箱子预览中显示的内容，不过如果你希望现有选项同时也作为奖品生效，你仍然可以移除Items。
'7':
DisplayName: '<red>这是一个名称。'
DisplayLore:
- '<yellow>这是一条描述信息。'
DisplayEnchantments:
- 'sharpness:5'
# 这仅作为基础显示物品，正如你在上方直接看到的，之后仍可以对其进行修改。
DisplayData: H4sIAAAAAAAA/53PQQrCMBAF0N8mQo0giEtv4sqFZ3Bb0iRiaDNTkhS8vTaI1KV0OfDfzB8FCOyuOuubi8kzAftXg9pbnIInZ6K+53M3aNO36TENvYttx0+BjeGJMoBKQRkOI5OjnLY4LswwZT1PUc05KSDTwIVAQfrswufOYQHW68Bkf7ZfSr+vq1a6eqUT/7umvPUGDbb6oU0BAAA=
MaxRange: 100
Chance: 10
# 这是赢得该奖品时插件将尝试给予的物品。
Items:
- 'Data:H4sIAAAAAAAA/53PQQrCMBAF0N8mQo0giEtv4sqFZ3Bb0iRiaDNTkhS8vTaI1KV0OfDfzB8FCOyuOuubi8kzAftXg9pbnIInZ6K+53M3aNO36TENvYttx0+BjeGJMoBKQRkOI5OjnLY4LswwZT1PUc05KSDTwIVAQfrswufOYQHW68Bkf7ZfSr+vq1a6eqUT/7umvPUGDbb6oU0BAAA='
CrazyCrates 2.1.6
on 2026 Sep 02快速提示：
将你的配置迁移到 MiniMessage！，此更改已在版本 2.1中完成，请查看我们之前的更新日志，如有需要帮助，请随时联系支持团队。
修复：
- Editor-Items（物品编辑器）的迁移器在全新安装时会导致错误。
CrazyCrates 2.1.5
on 2026 Sep 02修复：
- 物品编辑器现在会在启动时迁移至新格式，以防止错误。
CrazyCrates 2.1.4
on 2026 Sep 02修复：
- 修复了文件在 Linux 上无法正常加载的问题。
- 修复了使用 QuickCrate 时全息图重复的问题。
- 修复了悬停在 QuickCrate 上方的奖品名称带有 [] 符号的问题。
CrazyCrates 2.1.3
on 2026 Sep 02新增
- 为材料添加了翻译键，因此会遵循客户端的语言设置。
修复
- 修复了阻止使用插件的启动错误。
CrazyCrates 2.1.2
on 2026 Sep 02修复：
- 对已存在的奖品执行 /crates additem 时出现的不可变错误。
CrazyCrates 2.1.1
on 2026 Sep 02修复：
- /crazycrates debug/additem 不再允许将菜单作为参数使用。
CrazyCrates 2.1
on 2026 Sep 02之前的破坏性变更：
-
添加了对 MiniMessage 的支持，用于替换 &7 或 &c 等旧版颜色代码
- CMI/DecentHolograms 不支持 MiniMessage，因此你仍需使用旧版颜色代码。
-
b290d54 更新了 /cc additem，使其更加精确和友好 -> 这在 CrazyCrates 面向 1.20.6 的下一个版本中可能会再次更改，物品的内部结构已经改变。
先前添加的奖励目前仍然可用。新的 /cc additem 目前一次只支持 1 个物品，但相比之前已经有了改进。DisplayAmount 用于告诉插件要给予多少物品，因此是必需的。它将默认为 1！
如果你添加了
Items:部分，它将改用该部分作为奖励，并将 NBT 标签视为纯粹用于展示。
之前的新增内容：
- 添加了对 folia 的支持。
- 添加了使用十六进制颜色为全息图背景着色的功能。它仅适用于 CMI 和 FancyHolograms。
- 你可以在 examples/crates 文件夹的 Hologram 部分查看如何添加颜色的示例。
transparent也是一个可用的选项，用于实现透明全息图，这是默认设置。
- 为填充玻璃和板条箱预览物品添加了 HideItemFlags 选项。
- 添加了关闭 examples 文件夹自动更新的配置选项。
额外的物品选项：
1:
DisplayName: '<red>Porkchop'
DisplayItem: 'PORKCHOP'
DisplayAmount: 4
Chance: 60
如果你只是想给予基础物品而无需使用
Items:或Commands:，你可以像这样配置奖励，它将给予 4 个猪排。DisplayAmount 定义给予多少物品，DisplayItem 定义给予玩家的材料。
使用这种给予物品的格式时，你不能同时使用
commands或items。
移除：
- 移除了配置选项 crate.unsupported-settings.old-key-checks，因为我修复的一个 bug 导致此设置失去了原有用途。
之前的变更：
- 更新了全息图的处理方式。FancyHolograms 应该不再那么难以相处，CMI 应该表现更好。
- 可以将板条箱字段中的
Chance设置为 -1 以使用填充物品。
插件支持：
- 为每个板条箱文件中的广播消息添加了占位符 API 支持。
- 添加了对 Oliver 开发的 FancyHolograms 的支持。
- 在钥匙的显示名称/描述信息中添加了对 PlaceholderAPI 的支持。
之前的修复：
- 修复了 DecentHolograms 出现双行的问题。
- 修复了列表消息末尾多出一行的问题。
- 修复了材料无法被识别的问题。
- 修复了钥匙没有描述信息的 bug。
- 修复了当显示名称匹配时不会给予正确奖励的问题。
- 修复了赌场板条箱（casino crate）在没有钥匙的情况下也能打开的问题。
- 临时修复了使用副手中的钥匙尝试打开板条箱时消息重复显示的问题。这意味着目前，实体板条箱无法使用副手中的钥匙。
CrazyCrates 2.0.5
on 2026 Sep 02修复：
- 抽取奖品时错误地通过比对奖品的显示名称来判断，现已修复。
CrazyCrates 2.0.4
on 2026 Sep 02修复：
- 修复了娱乐箱无需钥匙即可打开的问题。
CrazyCrates 2.0.3
on 2026 Sep 02修复：
- 皮革套装无法染色的问题。
CrazyCrates 2.0.2
on 2026 Sep 02修复：
- 通过使用正确的配置路径，修复了 /key 等命令中的占位符问题。
- 修复了在配置中找不到钥匙名称时会抛出 NPE 的问题。