#631 修复在执行 minecraft:reload 后未注册命令重新出现的问题。此修复还伴随若干有关命令注册与注销的重要变更，详情请参阅文档中的“命令注销”页面。
#608 RecipeArgument 在 Spigot 上不再抛出任何异常
#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 前缀，其返回类型将依平台而异
ChatArgument 在 Paper 平台上返回 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

CommandAPI 11.0.0 (Spigot)

on 2026 Jul 17

下载

Minecraft 版本变更

新增对 Minecraft 1.21.9 和 1.21.10 的支持
移除对 Paper 平台上 Minecraft 1.20.5 及更低版本的支持

错误修复

#631 修复在执行 minecraft:reload 后未注册命令重新出现的问题。此修复还附带了若干关于命令注册与注销的重要变更，详情请参阅文档中的“命令注销”页面。
#608 RecipeArgument 在 Spigot 上不再抛出任何异常
#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 前缀，且其返回类型依平台而异
ChatArgument 在 Paper 上返回 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

CommandAPI 11.0.0 (Velocity)

on 2026 Jul 17

下载

Minecraft 版本变更

新增对 Minecraft 1.21.9 和 1.21.10 的支持
移除对 Paper 平台上 Minecraft 1.20.5 及更低版本的支持

错误修复

#631 修复在执行 minecraft:reload 后未注册命令重新出现的问题。此修复还附带了若干关于命令注册与注销的重要变更，详情请参阅文档中的“命令注销”页面。
#608 RecipeArgument 在 Spigot 上不再抛出任何异常
#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 前缀，且返回类型将依平台而异
ChatArgument 在 Paper 上返回 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）