更新内容 🔨

新 API

CrazyCrates API 已升级至 0.9.0

新增了一个类。

Key Manager（钥匙管理器）类，可用于检查玩家手持的物品。

你可以通过 CratesProvider#get()#getKeyManager() 获取该类。

/**
 * KeyManager 的类，用于处理实体钥匙的检查，以及我们不久后可能需要的其他功能。
 *
 * @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);

    /**
     * 获取钥匙所属的箱子（Crate）名称。
     *
     * @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

已修复的 Bug 🐛

• 修复了首次安装时 WonderCrate.yml 出现错误的问题，原因是某个奖品缺少 Items 部分。
• 修复了使用双括号初始化导致的潜在内存泄漏。
• 修复了 PlaceholderAPI 支持中的多个 bug。
• 修复了 CosmicCrateManager 中的一个拼写错误。#873
• 修复了 %crate_opened_raw% 中的拼写错误。
  • 1ef6553
• 修复了 Folia 上物品掉落的问题。#856
• 通过使用 #runNow 而非 #run（后者调用内部 void 方法）修复了一个问题。
• 修复了迁移类型相关的多个问题。
• 修复了 Folia 上因未在需要时使用调度器而导致多个问题的出现。
  • 0e139f6
• 修复了药水颜色在新物品部分中无法生效的问题。
• 修复了盾牌旗帜在使用新物品格式时出现的问题。
• 修复了每个奖品的品质概率未能正确显示的问题。
• 修复了箱子调试命令。

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