CommandAPI

Minecraft 版本变更

• 新增支持 Minecraft 1.21.9 和 1.21.10
• 停止支持 Paper 平台上的 Minecraft 1.20.5 及更早版本

问题修复

• #631 修复了在执行 minecraft:reload 后已注销命令重新出现的问题。此修复还带来了一些关于命令注册与注销的重要变更，详情请参阅文档中的“命令注销”页面。
• #608 修复了 Spigot 上 RecipeArgument 抛出异常的问题
• #494、#503 修复了运行时注册/注销命令时可能发生的 ConcurrentModificationException

模块变更

• #414、#517 将 CommandAPI 拆分为针对 Paper 和 Spigot 的独立模块：
  • 移除 commandapi-bukkit-shade 模块和 commandapi-bukkit-shade-mojang-mapped 模块
  • 新增专用于 Paper 的 commandapi-paper-core 和 commandapi-paper-shade 模块
  • 新增专用于 Spigot 的 commandapi-spigot-core 和 commandapi-spigot-shade 模块
  • 新增 commandapi-paper-test-toolkit 和 commandapi-spigot-test-toolkit，分别取代原有的 commandapi-bukkit-test-toolkit（用于 Paper 和 Spigot）
  • 调整并新增若干 Kotlin DSL 模块：
    • commandapi-core-kotlin -> commandapi-kotlin-core
    • commandapi-bukkit-kotlin -> commandapi-kotlin-bukkit
    • commandapi-velocity-kotlin -> commandapi-kotlin-velocity
    • 新增：commandapi-kotlin-paper
    • 新增：commandapi-kotlin-spigot

新功能

• 在 Paper 上现在可以在启动引导阶段注册命令

API 变更

• 将 CommandAPIBukkitConfig 类改为抽象类，取而代之的是根据所用模块选择新的 CommandAPIPaperConfig 或 CommandAPISpigotConfig 类
• FloatRangeArgument 已重命名为 DoubleRangeArgument，现返回 DoubleRange 类型
• PlayerArgument 和 OfflinePlayerArgument 已被 PlayerProfileArgument 替代，返回 List<PlayerProfile>。PlayerProfile 类的具体实现取决于你使用的是 Paper 还是 Spigot。若需获取 Player 对象，请使用 EntitySelectorArgument.OnePlayer
• AsyncOfflinePlayerArgument 已被 AsyncPlayerProfileArgument 替代
• ChatArgument、ChatComponentArgument 和 ChatColorArgument 不再包含任何 Adventure 前缀，其返回类型根据平台不同而有所差异
• 在 Paper 上，ChatArgument 返回一个 SignedMessage 对象。同时解决 #381
• BlockStateArgument 现在返回 BlockState 对象而非 BlockData 对象

配置变更

• 使用新的 fallback-to-latest-nms 配置项替代原有的 use-latest-nms-version 和 be-lenient-for-minor-versions 选项：
  • 加载 CommandAPI 时，若该选项设为 true，会优先检查当前版本是否受支持，并使用对应版本
  • 若当前版本不受支持，则 CommandAPI 将尝试使用最新的 NMS 版本，但该版本可能无法完全正常工作
  • 此配置项在 Paper 上默认为 true，在 Spigot 上默认为 false