变更 🔨

• 优化了通过 PlaceholderAPI 检查占位符时的性能
  • 同时也降低了内部维护负担！
• 优化了 examples 文件夹的更新流程。
• 移除了 LegacyItemBuilder，因同时维护两个 ItemBuilder 并不愉快。
  • 除非您启用了 HideItemFlags: true，否则无需修改配置
  • 若您确实使用了 HideItemFlags，请点击此处查看说明
• 通过遍历文件夹而非依赖 FileManager 缓存来改进迁移类型，避免了不必要的检查。
• 全面优化了插件的日志输出详细程度。
• 改进了配置迁移器中的占位符迁移逻辑。
• 优化了 /crazycrates teleport <crate_id> 命令。
• 全面优化了插件中占位符的解析逻辑。
• 将“钥匙不足”消息中的 {key_amount} 替换为 {amount}。
  • {key_amount} 已不再可用。
• 原本仅可在物品显示名称（DisplayName）中使用的占位符，现也可用于显示描述（DisplayLore）。
• 清理了与向玩家发送消息或向服务器广播消息相关的代码。
• 移除了 Cosmic Crate 中一段不必要的奖品循环——只要初始计算无误，该循环便无存在必要。
• 切换为使用 StringUtils#tryParseInt 方法（返回 Optional 类型），以提供更清晰的错误提示，替代原先的 Integer#parseInt。
• 更新了默认配置文件。

奖励箱变更

• 优化了奖励箱的追踪代码。
• 提升了构建奖励箱对象时的性能与可读性。
• 优化了加载/添加奖励箱位置时的性能。
• 在奖励箱开启结束时，改进了相关任务及各类缓存的清理逻辑。
  • 此项修复应能解决若干其他异常问题。

钥匙变更

• 修复了使用 /crazycrates mass-open 或在 QuickCrate 上潜行点击领取奖品后扣除钥匙时的逻辑错误：正确顺序应为先发放奖品、再扣除钥匙，从而最大限度减少因异常情况导致的免费战利品获取。
  • 此外，若因背包已满等任何原因未能成功扣除钥匙，系统将自动为您退款。

奖励箱类型

• CrateOnTheGo 现在也会调用 openCrate 方法，因此诸如“必需钥匙”等其他奖励箱所支持的功能现已一并生效。

物品布局

• 默认启用 use-different-items-layout（即启用独立物品布局）。
  • 已更新配置文件的现有服务器无需进行任何更改。

物品变更

• 移除了对刷怪笼预览图的配置选项。
  • 此选项已无意义，因所有刷怪笼在奖励箱菜单中外观完全一致。
• 更新了发光效果配置：Glowing 现支持 "add_glow"、"remove_glow" 或 "none" 等取值。
  • 当前使用的 true/false 仍可兼容，但建议尽快更新。

移除内容

权限系统

• 移除了 use-new-permission-system 开关，回归大家普遍喜爱的原始权限行为。

新增功能

钥匙占位符

• 为钥匙占位符新增简写格式支持，例如 1,000 将自动显示为 1k，依此类推。

插件支持

注意：请将 <item_id> 替换为对应自定义物品插件中的正确标识符。
第二条注意：凡支持输入 diamond_axe 的位置，均可使用以下格式。
第三条注意：您仍可继续直接使用 emerald_helmet 等原生物品 ID。

• 新增对 HMCWraps 的支持。
  • DisplayItem: hmcwraps@<item_id>
• 同时为 Oraxen、Nexo、CraftEngine 和 ItemsAdder 等插件引入新格式支持：
  • DisplayItem: nexo@<item_id>
  • DisplayItem: oraxen@<item_id>
  • DisplayItem: itemsadder@<item_id>
  • DisplayItem: craftengine@<item_id>

新增命令

• 新增 /crates version 命令，显示当前 Git 提交哈希、上一版本提交哈希及当前插件版本。
  • 若任一信息无法获取，则显示 “N/A”。

其他新增

• 在此前未支持自定义物品的区域新增了自定义物品支持。
• 为 FancyHolograms 新增文字阴影支持。
  • #890

配置变更

发光效果

• Glowing 不再仅接受 true/false，但旧版 true/false 配置仍将兼容（内部已做适配）。

  # 物品是否发光？  
  # 可选值：add_glow、remove_glow、none  
  Glowing: "none"  

隐藏组件

若您此前在配置中使用了 Hidden-Components 或 Components，现已被 flags.components 所替代；旧配置仍可正常运行。

已修复漏洞 🐛

• 修复了部分场景下错误消息被误用，或变量未被正确替换的问题。
• 修复了日志方法在 UUID 为空时引发控制台报错的问题。
• getPrize 方法未能正确过滤无效权重，导致奖品抽取结果异常。
  • 我们虽已对 totalWeight 变量做了正确校验，但在遍历奖品列表时，权重为 -1 的奖品仍会被保留。
  • 若将 -1 加入数值计算，反而会增大该数值，进而干扰奖品概率分配。
  • 所有值为 0.0、0 或小于 0 的奖品，现统一视为填充类奖品。
• 分页式 GUI 会在物品数量不足时错误生成第二页。
• 日志消息可能未被正确保存。
• 更新了 ExcellentCrates 迁移器，修复了若干迁移相关 Bug。
• 修复了 /crazycrates transfer 命令的一项关键问题。
  • 若暂无法升级，建议禁用该命令的使用权限。
• 通过限制数量为所需值，修复了 /crazycrates take/give 与 /crazycrates mass-open 命令的问题。
• CMI 在近期更新中（无论是 CMI Lib 还是 CMI API）发生了接口断裂；我已将其 Fork、编译并发布至个人仓库……目前运行正常。
  • 看来我将长期维护它，直至宇宙热寂。
    • #876
    • #9919 Zrips 仓库中 CMI 的相关 Issue，已被某愚蠢机器人草率关闭。
• /crazycrates debug 命令此前未能正常工作。
• 日志消息中使用了正确的变量。
• 修复了多个自定义头颅/骷髅无法正确生成的问题。
• 当玩家执行 /keys 命令却无任何钥匙时，现在会显示正确的提示消息。
• 修复了 mass-open 功能中，若某行为空或层级为空时导致钥匙被错误扣除且未退款的问题；现钥匙将被全额退还。
• 命令执行后的消息响应未能正确发送至控制台的问题。

一如既往，欢迎前往 https://github.com/Crazy-Crew/CrazyCrates/issues 提交漏洞报告 🐛