变更内容 🔨

新增 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 部分相同的新物品结构。
• 在宝箱菜单中改为点击时执行命令，而非打开时执行。
  • 6c580b1
• 在奖励/默认消息中新增 %chance% / %weight% 占位符。
• 为所有现有命令添加命令语法建议。
• 若文件为空，则返回 "N/A"，因为 files#getFirst() 在无元素时会抛出错误。
• 利用 CMI/DecentHolograms 内置方法处理消息着色，以提高与其插件的兼容性。
  • 这也可能支持其他插件特定功能，例如 CMI 的全息图众多特性。
• 移除 QuickCrate 上方显示物品的自定义名称中的括号。
• 使用空气填充底部边框，防止按钮导致物品溢出。
• 新增切换选项以禁用开启追踪宝箱功能。
  • 76625ba

已修复的漏洞 🐛

• 修复首次安装时 WonderCrate.yml 的错误，因某个奖励缺少 Items 部分。
• 修复由双大括号初始化引起的潜在内存泄漏问题。
• 修复 PlaceholderAPI 支持中的多个漏洞。
• 修复 CosmicCrateManager 中的拼写错误。#873
• 修复 %crate_opened_raw% 中的拼写错误。
  • 1ef6553
• 修复 Folia 上物品掉落的问题。#856
• 修复问题：改用 #runNow 而非 #run 来调用内部 void 方法。
• 修复多种迁移类型的问题。
• 修复因未在需要时使用调度器而导致的 Folia 上的多个问题。
  • 0e139f6
• 修复新物品部分中药水颜色未正确应用的问题。
• 修复盾牌旗帜使用新物品格式时的问题。
• 修复每个奖励的等级几率未正确显示的问题。
• 修复宝箱调试命令。

一如既往，请前往 https://github.com/Crazy-Crew/CrazyCrates/issues 报告 🐛