基本信息
我的世界Java版本
26.2
26.1.x
1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x
1.15.x
1.14.x
1.13.x
平台
Bukkit
运行环境

搬运团队
搬运资源声明
对于可进行 JAR 文件搬运的许可证,我们提供站内下载服务;其他资源会跳转到原帖下载。资源更新可能不及时,建议前往资源内提供的原帖链接下载最新版本。
详情信息
许可证 MIT
发布于 2024-11-30
更新于 2026-07-28
更新日志
⚠️ 此版本与任何使用 CommandAPI 8.X.X 或更低版本的插件不兼容!(详见文档获取更多信息)
新功能
- #360、#369:执行器方法现改用 CommandArguments,支持通过参数名称而非索引访问参数
- #162、#387、#393:新增可选参数支持
- #388:新增配置项
hook-paper-reload,用于控制 CommandAPI 是否挂钩/minecraft:reload命令 - 重构 ItemArgument 实现,确保 ItemStack 的数量正确反映,且 ItemMeta 被正确赋值
- TeamArgument 现在返回 Team 对象而非字符串
- ObjectiveArgument 现在返回 Objective 对象而非字符串
- #391:CommandAPI 仅当 plugin.yml 属于调用该 API 的插件时,才对其中注册的命令发出警告
- #422:执行器现可访问玩家输入的原始命令字符串
- #431:为 ListArgumentBuilder 构建列表提供更多可用信息
- 新增对记分板侧边栏队伍颜色的支持,使用 ScoreboardSlot 枚举实现
Kotlin DSL 变更
- 实现了返回型执行器(resulting executors)
- 实现了 FunctionArgument
- 对 CommandAPICommand DSL 进行多项改进
错误修复
- 修复 commandapi-preprocessor 出现在插件 JAR 及遮蔽(shaded)JAR 文件中的问题
- #390:修复
.executesNative()中 CommandSender 的getLocation()方法返回错误的俯仰角(pitch)与偏航角(yaw) - 修复 BiomeArgument 在不应显示标签时错误显示标签的问题
- 修复 BLOCK_POSITION 模式的 LocationArgument 在未加载区块中无法返回位置的问题
- 修复 IntegerRangeArgument 和 FloatRangeArgument 在 Minecraft 1.16.4 与 1.16.5 中失效的问题
- 修复 RecipeArgument 在 Minecraft 1.17 中失效的问题
- 修复 TeamArgument 在 Minecraft 1.17 中失效的问题
- 修复 AdventureChatArgument 在 Minecraft 1.17 中失效的问题
- 修复无执行器的命令未被 CommandAPI 捕获的问题
- 修复 ParticleArgument 在 Minecraft 1.16.5 及更低版本中产生“无效粒子数据类型”警告的问题
- 修复 FunctionArgument 在 Minecraft 1.17.x 与 1.18.x 中失效的问题
- 修复 NamespacedKeyArgument 在 Minecraft 1.18 中失效的问题
- 修复 FunctionArgument 在 Minecraft 1.17+ 中无法正确检索数据包(函数)标签的问题
- 移除一段冗余的振动粒子处理代码(该代码在任何情况下均不会被执行)
文档变更
- #384:修复 ParticleArgument 文档页面中多种粒子数据未被记录的问题
- 修复文档中的失效链接(使用 Michael-F-Bryan/mdbook-linkcheck 工具)
- 统一重构文档中各参数页面的命名规范
- 新增 Kotlin DSL 使用示例
其他变更
- 移除所有此前已弃用的构造器、类和方法
- 对整个 CommandAPI 项目进行彻底重构,以更好地支持其他平台
- 新增文档实时开发版,地址为 commandapi-live-docs.jorel.dev
- 提升 CommandAPI 主页的移动端适配效果
- 在 CommandAPI 主页添加 社区 下载链接
- 停止支持 Minecraft 1.13 至 1.14.4 版本。请改用旧版 CommandAPI,或在 GitHub 上提交 Issue 请求重新支持这些版本



