CommandAPI 11.1.0 (Paper)
on 2025 Dec 16Minecraft 版本更新
- 添加了对 Minecraft 1.21.11 的支持
问题修复
- 修复了在某些情况下调用
CommandAPI.unregister()替换命令无效的问题 - 修复了自定义命名空间无法使用的问题
- 修复了在运行时注册或注销大量命令可能导致服务器超时的问题
新功能
- #642 添加了
enable-networking和make-networking-exceptions-warning配置选项。你可以在文档中阅读更多相关内容
CommandAPI 11.1.0 (Spigot)
on 2025 Dec 16Minecraft 版本更新
- 添加了对 Minecraft 1.21.11 的支持
问题修复
- 修复了在某些情况下调用
CommandAPI.unregister()替换命令时无法正常工作的问题 - 修复了自定义命名空间无法使用的问题
- 修复了在运行时注册或注销大量命令可能导致服务器超时的问题
新功能
- #642 添加了
enable-networking和make-networking-exceptions-warning配置选项。你可以在文档中阅读有关它们的更多信息
CommandAPI 11.1.0 (Velocity)
on 2025 Dec 16Minecraft 版本更新
- 添加了对 Minecraft 1.21.11 的支持
错误修复
- 修复了在某些情况下调用
CommandAPI.unregister()替换命令无效的问题 - 修复了自定义命名空间无法使用的问题
- 修复了在运行时注册或注销大量命令可能导致服务器超时的问题
新功能
- #642 添加了
enable-networking和make-networking-exceptions-warning配置选项。你可以在文档中阅读有关它们的更多信息
CommandAPI 11.0.0 (Paper)
on 2025 Oct 08Minecraft 版本变更
- 新增支持 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-corecommandapi-bukkit-kotlin -> commandapi-kotlin-bukkitcommandapi-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.OnePlayerAsyncOfflinePlayerArgument已被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
- 加载 CommandAPI 时,若该选项设为
CommandAPI 11.0.0 (Velocity)
on 2025 Oct 08Minecraft 版本变更
- 添加对 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-corecommandapi-bukkit-kotlin -> commandapi-kotlin-bukkitcommandapi-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.OnePlayerAsyncOfflinePlayerArgument已被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
- 加载 CommandAPI 时,若该选项设为
CommandAPI 11.0.0 (Spigot)
on 2025 Oct 08Minecraft 版本变更
- 添加对 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-corecommandapi-bukkit-kotlin -> commandapi-kotlin-bukkitcommandapi-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.OnePlayerAsyncOfflinePlayerArgument已被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
- 当加载 CommandAPI 时,若该配置设为
CommandAPI 10.1.2 (Mojang-Mapped)
on 2025 Jul 21Minecraft 版本更改
- 为 Minecraft 1.21.8 添加支持
CommandAPI 10.1.2 (Spigot-Mapped)
on 2025 Jul 21我的世界版本更改
- 增加对我的世界 1.21.8 的支持
CommandAPI 10.1.1 (Mojang-Mapped)
on 2025 Jul 04Minecraft 版本变更
- 增加对 Minecraft 1.21.7 的支持
CommandAPI 10.1.1 (Spigot-Mapped)
on 2025 Jul 04Minecraft 版本更改
- 为 Minecraft 1.21.7 添加支持
CommandAPI 10.1.0 (Mojang-Mapped)
on 2025 Jun 27CommandAPI 10.1.0 (Spigot-Mapped)
on 2025 Jun 27Minecraft 版本变更
- 增加对 Minecraft 1.21.6 的支持
CommandAPI 10.1.0 (Velocity)
on 2025 Jun 27我的世界版本更改
- 为我的世界 1.21.6 添加支持
CommandAPI 10.0.1
on 2025 May 12漏洞修复
- 修复了在Paper服务器上注销命令不起作用的问题
- 645号问题 忽略空发送者的前置条件
CommandAPI 10.0.1
on 2025 May 12漏洞修复
- 修复了在Paper服务器上命令注销不起作用的问题
- 645号问题 忽略对空发送者的前置要求
CommandAPI 10.0.1
on 2025 May 12漏洞修复
- 修复了在Paper上命令注销不起作用的问题
- 645号 忽略对空发送者的前置要求
CommandAPI 10.0.1
on 2025 May 12漏洞修复
- 修复了在Paper服务器上注销命令不起作用的问题
- 645号问题 忽略空发送者的前置条件
CommandAPI 10.0.0 (Networking Plugin)
on 2025 Apr 04《我的世界》版本变更
- 增加对《我的世界》1.21.5版本的支持
- 不再支持《我的世界》1.16.5 - 1.19.4版本
Java版本变更
- 将CommandAPI的Java版本从Java 16变更为Java 17(长期支持版)
新特性
- #633 添加了一个
AsyncOfflinePlayerArgument,以允许异步获取离线玩家
漏洞修复
- #477 修复了
NativeProxyCommandSender无法运行原版(以及CommandAPI)命令的问题 - #578、#583、#629 修复了在Paper的Brigadier API变更后
Bukkit#dispatchCommand()无法工作的问题 - 修复了在某些版本中
PotionEffectArgument.NamespacedKey没有提示的问题
新变更
- #636 默认命名空间已从
minecraft更新为插件名称。如果您未进行混淆处理,默认命名空间将是commandapi。如果您进行了混淆处理,默认命名空间将是您的插件名称。 - 将数据包重新加载步骤的配置默认值更新为可选加入而非可选退出。
- CommandAPI现在除了会输出混乱的错误信息外,还会告知您是否弄错了映射关系。
- #634 使用
Component的函数现已更改为使用ComponentLike。 - 增加了对Velocity的支持!
网站变更
- CommandAPI的新主页是https://commandapi.dev/(目前指向文档)
- 文档已迁移至https://docs.commandapi.dev/
- Java文档已迁移至https://javadocs.commandapi.dev/
- CommandAPI已从
github.com/JorelAli/CommandAPI迁移至其自身组织下的github.com/CommandAPI/CommandAPI
CommandAPI 10.0.0 (Velocity)
on 2025 Apr 04CommandAPI 10.0.0 (Mojang-Mapped)
on 2025 Apr 04《我的世界》版本变更
- 增加对《我的世界》1.21.5版本的支持
- 不再支持《我的世界》1.16.5 - 1.19.4版本
Java版本变更
- 将CommandAPI的Java版本从Java 16变更为Java 17(长期支持版)
新特性
- #633 添加了一个
AsyncOfflinePlayerArgument,以允许异步获取离线玩家
漏洞修复
- #477 修复了
NativeProxyCommandSender无法运行原版(以及CommandAPI)命令的问题 - #578、#583、#629 修复了在Paper的Brigadier API变更后
Bukkit#dispatchCommand()无法工作的问题 - 修复了在某些版本中
PotionEffectArgument.NamespacedKey没有提示的问题
新变更
- #636 默认命名空间已从
minecraft更新为插件名称。如果您没有进行混淆处理,默认命名空间将是commandapi。如果您进行了混淆处理,默认命名空间将是您插件的名称。 - 将数据包重新加载步骤的配置默认值更新为可选加入而非可选退出。
- CommandAPI现在除了会输出混乱的错误信息外,还会告知您是否弄乱了映射关系。
- #634 使用
Component的函数现已更改为使用ComponentLike。 - 增加了对Velocity的支持!
网站变更
- CommandAPI的新主页是https://commandapi.dev/(目前指向文档)
- 文档已迁移至https://docs.commandapi.dev/
- Java文档已迁移至https://javadocs.commandapi.dev/
- CommandAPI已从
github.com/JorelAli/CommandAPI迁移至其自身组织下的github.com/CommandAPI/CommandAPI


