CrazyCrates 5.0.0
on 2026 Jan 15变更内容 🔨
新增 API
CrazyCrates API 已升级至 0.9.0
新增一个类
钥匙管理器类(Key Manager class),允许你检查玩家手持的物品是否为钥匙。
可通过 CratesProvider#get()#getKeyManager() 获取。
/**
* 钥匙管理器类,用于处理实体钥匙的检测,以及未来可能需要的其他功能。
*
* @author Ryder Belserion
* @version 0.9.0
* @since 0.9.0
*/
public abstract class KeyManager<I> {
/**
* {@link KeyManager<I>} 的默认构造函数。
*
* @author Ryder Belserion
* @since 0.9.0
*/
public KeyManager() {}
/**
* 检查该物品是否为有效钥匙。
*
* @param item ItemStack
* @return true 或 false
* @since 0.9.0
*/
public abstract boolean isKey(@NotNull final I item);
/**
* 检查一个物品是否与另一个物品匹配。
*
* @param item 初始 ItemStack
* @param comparing 要比较的 ItemStack
* @return true 或 false
* @since 0.9.0
*/
public abstract boolean isMatchingKey(@NotNull final I item, @NotNull final I comparing);
/**
* 获取钥匙所属宝箱的名称。
*
* @param item ItemStack
* @return 宝箱名称
* @since 0.9.0
*/
public abstract String getKey(@NotNull final I item);
}
配置变更
- 宝箱配置文件中的
ChestLines已重命名为Rows,5eec53b- 所有现有配置仍可正常运行。你可以运行
/crazyrates migrate -mt CratesDeprecated进行转换,或直接使用查找替换功能。
- 所有现有配置仍可正常运行。你可以运行
其他变更
- 新增自定义返回/下一页和菜单按钮所在行/列的功能。
- 新增对 CSGO 动画的自定义选项,可设置顶部/底部为静态或动态。95de51e
- 若运行
/crazycrates migrate -mt CratesDeprecated,所需选项将自动生成。 - 请参考
examples/crates/CrateExample.yml文件夹获取完整示例。 - 支持与文档中
Items部分相同的新物品结构。
- 若运行
- 在宝箱菜单中改为点击时执行命令,而非打开时执行。
- 在奖励/默认消息中新增 %chance% / %weight% 占位符。
- 为所有现有命令添加命令语法建议。
- 若文件为空,则返回 "N/A",因为 files#getFirst() 在无元素时会抛出错误。
- 利用 CMI/DecentHolograms 内置方法处理消息着色,以提高与其插件的兼容性。
- 这也可能支持其他插件特定功能,例如 CMI 的全息图众多特性。
- 移除 QuickCrate 上方显示物品的自定义名称中的括号。
- 使用空气填充底部边框,防止按钮导致物品溢出。
- 新增切换选项以禁用开启追踪宝箱功能。
已修复的漏洞 🐛
- 修复首次安装时 WonderCrate.yml 的错误,因某个奖励缺少
Items部分。 - 修复由双大括号初始化引起的潜在内存泄漏问题。
- 修复 PlaceholderAPI 支持中的多个漏洞。
- 修复 CosmicCrateManager 中的拼写错误。#873
- 修复 %crate_opened_raw% 中的拼写错误。
- 修复 Folia 上物品掉落的问题。#856
- 修复问题:改用 #runNow 而非 #run 来调用内部 void 方法。
- 修复多种迁移类型的问题。
- 修复因未在需要时使用调度器而导致的 Folia 上的多个问题。
- 修复新物品部分中药水颜色未正确应用的问题。
- 修复盾牌旗帜使用新物品格式时的问题。
- 修复每个奖励的等级几率未正确显示的问题。
- 修复宝箱调试命令。
一如既往,请前往 https://github.com/Crazy-Crew/CrazyCrates/issues 报告 🐛
1.21.8-fde1b0e
on 2025 Nov 15fde1b0e 更新消息中 {prefix} 的替换方式
1.21.8-2e73bce
on 2025 Nov 152e73bce 将所有双大括号初始化替换为不可变映射,或在需要时使用新的 HashMap/列表
1.21.8-b92b47f
on 2025 Nov 15b92b47f 修复占位符需要玩家名称的问题
1.21.8-5cfc069
on 2025 Nov 145cfc069 首次启动时为奖品#2添加缺失的物品奖励
1.21.8-1ef6553
on 2025 Nov 141ef6553 修复占位符拼写错误
1.21.8-496e4d0
on 2025 Nov 121.21.8-e3d85d5
on 2025 Nov 12e3d85d5 更新占位符API支持
1.21.8-6c580b1
on 2025 Nov 126c580b1 使用 GUI 自定义功能时,将命令执行时机从打开时改为点击时。
1.21.8-f99bb83
on 2025 Nov 05f99bb83 为奖励/默认消息添加 %chance% / %weight% 占位符
1.21.8-f2c5fbd
on 2025 Nov 05f2c5fbd 暂时禁用 CMI 支持,因为当前可用的 API 似乎与新版 CMI 不兼容
1.21.8-c0b8105
on 2025 Oct 13c0b8105 修复了由于使用了未去除格式代码的名称,导致玩家默认无法打开宝箱的问题。
1.21.7-1efdceb
on 2025 Oct 081efdceb 当值小于或等于 0.0 时始终中断
1.21.7-876f3a7
on 2025 Oct 08876f3a7 修复 CosmicCrateManager 中的拼写错误 (#873)
1.21.7-68ecd37
on 2025 Oct 081.21.7-bc92cef
on 2025 Sep 07bc92cef 当玩家使用过多或过少参数时发送消息
1.21.7-3af2d36
on 2025 Sep 063af2d36 为所有命令添加命令语法注释
这允许一种更好的方式来处理告知玩家无效命令用法。
1.21.7-ecef83e
on 2025 Sep 06ecef83e 添加了自定义后退/下一步和菜单按钮的行/列的功能。
1.21.7-91507b3
on 2025 Sep 0491507b3 通过将 isEmpty 检查移入循环来精简 if else 检查。
1.21.7-95de41e
on 2025 Sep 0395de41e 添加了将 csgo 动画自定义为顶部/底部为静态或动态的功能。
如果你运行 /crazycrates migrate -mt CratesDeprecated,将生成你需要的现有选项。
请参考 examples/crates/CrateExample.yml 文件夹,以获取关于如何执行此操作的完整示例。
它支持与文档中 Items 部分中用于执行项目的新方式相同的结构。



