CrazyCrates 2.0.1
on 2026 Sep 02修复：
- 设置板条箱类型的界面尝试创建全息显示器。
CrazyCrates 2.0
on 2026 Sep 02重大变更：
- 将所有 NBT-API 实例替换为 PersistentDataContainer。旧的键名将不再有效。
- 在检查你是否拥有有效钥匙时，不再检查钥匙是否有知识/名称，因为这会使 PersistentDataContainer 的存在失去意义。
- ItemBuilder 已更新为略微更现代的版本，为支持 MiniMessage 做准备。
移除：
- 由于钥匙无法被扣除的奇怪问题，暂时禁用了将钥匙记录到控制台/文件的功能，处理日志记录的部分正在等待重写
新增：
- 如果 server.properties 中的重生点保护不为 0，启动时会显示警告。
- 为所有信息添加了额外占位符。messages.yml 将更新新的注释，说明每条信息可以使用的内容。
- 新增一个开关，允许针对特殊用例进行旧版钥匙检查。
- 新增类似
Prize-Messages的功能：当未找到奖品命令时，每个储物箱可运行默认命令。 - 新增 %reward_stripped%，返回去除格式后的奖励版本，供 DiscordSRV 等插件使用。
- 新增为 QuadCrates（四重储物箱）选择自定义粒子和颜色的功能。
- 新增为 ENCHANTED_BOOK（附魔书）添加附魔的功能，使其能在铁砧中生效。
变更：
- 更新了 examples 文件夹中的示例文件
- config.yml 和 messages.yml 中使用的所有内部占位符均已更改。
- %player% 改为 {player}
- %crate% 改为 {crate}
- %amount% 改为 {amount}
- %key% 改为 {key}
- %keys% 改为 {keys}
- %page% 改为 {page}
- %prefix% 改为 {prefix}
- %world% 改为 {world}
- %cratetype% 改为 {cratetype}
- %prize% 改为 {prize}
- %number% 改为 {number}
- %keytype% 改为 {keytype}
- %usage% 改为 {usage}
- %key-amount% 改为 {key_amount}
- %crates_opened% 改为 {crates_opened}
- %id% 改为 {id}
- 修复了玩家使用 /cc open 时没有钥匙所显示的错误信息。
优化：
- 防止活塞移动作为储物箱的方块。
- 在 /crazycrates admin 中，当玩家获得虚拟/实体钥匙时播放音效。
- 将 /crazycrates admin 的信息发送方式从聊天栏改为动作栏。
- 优化了物品元数据检查。
- 如果储物箱主菜单已关闭，尝试执行 /crates set menu 时会发送一条提示信息，告知你无法这样做。
- 如果储物箱主菜单已禁用，/crates 将直接打开帮助信息。
- 仅在配置选项启用时才检查玩家是否拥有实体钥匙。
API：
CrazyCratesService和ICrazyCrates已被弃用并标记为即将移除。
修复：
- 在容器关闭事件中，将玩家从储物箱/页面/预览数组中移除（此前未做到）。
- 修复了当你执行 /crates reload 时，不在预览中的玩家仍持续收到预览信息的问题。
- 修复了 CrateOnTheGo 中事件会触发两次并消耗你两个储物箱的问题。
- 修复了扣除钥匙失败时会多次触发的问题。
- 修复了批量开启相关的问题：玩家被添加到开启列表后，若未找到钥匙则不会被移除。
- 修复了容器中钥匙检查方式的多个问题。
- 修复了 QuadCrates 的问题：当你将
structure.random设为 false 时，结构仍然是随机的。
CrazyCrates 1.22
on 2026 Sep 02新增内容：
- 现在可以通过 DeluxeMenus 或其他任意 GUI 插件，将菜单按钮的功能覆盖为你自己的菜单。
变更内容：
- 重做了 /crate admin 处理钥匙给予的方式，它会将容器大小扩展至 54 格，并在底部添加一个按钮，说明如何获取钥匙。
CrazyCrates 1.21
on 2026 Sep 02新增：
- 新增名为
Casino的箱子类型。（由 slimemcstew 提出想法） - 支持按文件夹对文件进行分类。
- 战争箱子（War Crate）作为默认生成的箱子。
- 支持配置由 CMI 或 DecentHolograms 创建的全息图具有可配置的“方块”范围。
- 支持为每个箱子配置音效。
- 可配置箱子播放动画时的循环音效以及箱子结束时播放的音效。
- 可调节音效的音量和速度。
更改：
- 宇宙箱子（Cosmic Crate）配置新增了选项，点击查看！
Color已被Item取代，因为你一直都可以使用任意物品，所以将其命名为Color具有误导性。- 如果找不到
Item，它将回退为 LIME_STAINED_GLASS_PANE。 - 你可以为每一行选择一个预定义的等级，也可以让它在可用等级中随机选择。
- 宇宙箱子在初次选取箱子时，所有 ??? 箱子都会绑定一个等级，因此你在选取时它才真正有意义。
- 更新了菜单物品的槽位检查，改为依赖 PersistentDataContainer。
- 重新整理了默认的 /crates 界面。
- 四重箱子会话改为检查 uuid 而不是玩家对象。
- 更新 /crates additem 以接受等级输入，该输入仅对宇宙箱子/赌场箱子有效：/crates additem <crate_name> <prize_number> [tier]
- 再次更新 /crates additem 以接受自定义概率输入，注意：默认最大范围仍为 100，因此请保持在 100 以内。/crates additem <crate_name> <prize_number> <chance> [tier]。
- 在检查 InventoryHolders 时不再创建持有者的快照。
- 新增配置选项以切换到更快的随机数选取实现。默认为
false，即旧的随机方式。 - 所有聊天消息、预览物品的描述、界面名称甚至填充物品都支持
PlaceholderAPI。
修复：
- 修复了箱子在世界插件创建的世界中被破坏的问题。
- 修复了退款事件需要在同步状态下触发的问题。
- 修复了展示伤害的问题：如果输入无法解析为整数的值（如 50f），将不再是空的耐久度。
- 修复了游戏内编辑器无法为赌场箱子/宇宙箱子添加等级的问题。
- 修复了为 PDC 存储了错误值导致使用四重箱子时报错的问题。
CrazyCrates 1.20.2
on 2026 Sep 02变更：
- 移除了通配符 crazycrates.open.*
- 启动时将 crazycrates.open.<crate_name> 注册为服务器权限。
- 每个板条箱都会注册一个权限，如果你移除了板条箱，该权限在服务器重启前不会被从服务器上移除。
- 更新了存储簇 API 版本。
修复：
- 权限检查不准确。
CrazyCrates 1.20.1
on 2026 Sep 02修复：
- 玩家离开服务器时的错误。
CrazyCrates 1.20
on 2026 Sep 02变更：
- 我们不再通过 plugin.yml 中的库功能在运行时下载 Adventure API。
修复：
- 玩家离开时移除其已打开的板条箱的所有相关数据。
CrazyCrates 1.19.3
on 2026 Sep 02新增：
- 添加了星体盒超时功能的开关。
Settings.Cosmic-Crate-Timeout将自动添加到你的配置文件中。
修复：
- 星体盒超时功能此前未按预期正常工作。
CrazyCrates 1.19.2
on 2026 Sep 02修复：
- 玩家退出游戏后未从开启的板条箱中移除，导致板条箱卡在“该玩家已在开启板条箱”的状态
CrazyCrates 1.19.1
on 2026 Sep 02修复：
- 物质重构机会在控制台抛出错误的问题。
CrazyCrates 1.19
on 2026 Sep 02移除：
- 移除了 plugin-config.yml，因为它实在有些奇怪，其中的选项会自动迁移到 config.yml 中。
变更：
- 版本升级至 1.20.4
- 升级了 NBT API
- 嵌套占位符现在可以正常工作
%crazycrates_<player>_<crate>_opened%必须写成%crazycrates_{player_name}_your_crate_opened%的形式- {player_name} 几乎可以替换为来自 https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders 的任何玩家变量
- 移除了 /crazycrates admin-help。
- /crazycrates help 现在会检查玩家是否拥有 crazycrates.admin-access 权限
- crazycrates.command.player.help 权限已更名为 crazycrates.help，默认为 TRUE（启用）
- 终端现在可以使用 /crazycrates help 命令。
完整更新日志：https://github.com/Crazy-Crew/CrazyCrates/compare/v1.18.5...v1.19
CrazyCrates 1.18.5
on 2026 Sep 02修复：
- 荧光灯无法生效的问题。
CrazyCrates 1.18.4
on 2026 Sep 02修复：
- CSGO板条箱动画顺序错误。
CrazyCrates 1.18.3
on 2026 Sep 02变更：
- 发放全部4个奖品后，10秒自动关闭宙速运气 (Cosmic Crate) 菜单。
- 在需要时自动清理。
修复：
- 自定义头颅 (Player Heads) 和自定义物品 (Custom Items) 无法正常工作的问题。
CrazyCrates 1.18.2
on 2026 Sep 02修复：
- 运行命令时 QuadCrate（四重储物箱）/CrateOnTheGo（随身储物箱）无法打开的问题。
CrazyCrates 1.18.1
on 2026 Sep 02更改：
- 更好地支持自定义物品。
修复：
- 修复了在 /crates admin 中点击物品栏中已有的钥匙时仍会获得钥匙的问题。
CrazyCrates 1.18
on 2026 Sep 02新增：
- 新增简单警告，提示计划仅从 Spigot 迁移到 Paper。
- 新增配置选项，可隐藏 QuickCrate 物品。
更改：
- 现在会尊重客户端的声音设置。
- CosmicCrate 已重新编写代码并进行了优化。
- 重新编写了板条箱的处理方式，以支持新的板条箱类型。
- 开发者 API 已更新。
修复：
- 修复了 CosmicCrate 的一个错误。
- 修复了 CrateOpenEvent 被触发两次的问题。
- 修复了 Spigot 兼容性问题。
CrazyCrates 1.17.1
on 2026 Sep 02更改：
- %Player% 不再有效，必须使用 %player%。这适用于我们所有的内部占位符。
修复：
- QuadCrate、QuickCrate 或 CrateOnTheGo 此前虽位于实体世界，却被标记为虚拟储物箱。
CrazyCrates 1.17
on 2026 Sep 02新增：
- 跟踪已打开的板条箱，用于 /crates mass-open。
- 新增了管理员从玩家处收取钥匙时的提示消息（无论玩家在线或离线）。
- 每次启动和执行 /crates reload 时都会重新生成名为 examples 的目录，以确保在需要时始终能获得最新的示例文件。
变更：
- 如果板条箱配置的奖励部分中没有显示名称选项，则 %reward% 将使用材料名称。
- 不再通过视图是否匹配来检查容器，此前这导致你可以将物品栏命名为"附魔"，从而使附魔台无法使用。
- 从管理菜单取出钥匙时使用可自定义的消息。
- 如果你使用 /crates give/take 命令时输入任何小于或等于 0 的数字，系统将提示该数字无效。
- /crates mass-open 现在允许你在实体钥匙和虚拟钥匙之间进行选择。
修复：
- /crates set 无法正常工作的问题。
- Menu Crate 未出现在 Tab 补全中的问题。
- QuadCrate 提示无法用作虚拟板条箱的问题。
- 当用户存在追踪记录时，不再清除没有钥匙的玩家的玩家数据。
CrazyCrates 1.16.4
on 2026 Sep 02- 修复：物品被添加了额外数据，导致它们无法叠加。