Minecraft 版本更新

• 新增对 Minecraft 1.20.3 和 1.20.4 的支持

错误修复

• 修复了在 1.19+ 版本中调用 SimpleFunctionWrapper.getTag() 会抛出错误的问题
• #499 修复冒险模式方法中工具提示相关的拼写错误
• 修复 executesFeedbackForwarding() 未能正确检查 FeedbackForwardingCommandSender，导致任意执行者均可执行该命令的问题
• #473 修复 CustomArgument.CustomArgumentException#fromString 中 RGB 颜色解析错误，导致生成颜色不正确的问题

新增功能

• 为 Kotlin DSL 添加 ExecutionInfo 执行器
• #497 新增对 RemoteConsoleCommandSender 的支持

已知问题

• 由 FunctionArgument 生成的函数在执行时始终返回值 1，无论该函数执行成功、失败或实际返回了其他结果
• 通过 FunctionArgument 生成的函数在获取其内部命令列表时，始终返回空数组

新功能

• #487 为位置参数添加了禁用整数居中功能的支持
• #482 为委托属性添加了 Kotlin 领域特定语言（DSL）支持

错误修复

• #488 修复了在 Paper 服务端上使用 Bukkit.createCommandSender() 调用 CommandAPI 命令失效的问题
• 修复了一个错误：当某命令名称以 : 结尾时，取消注册该命令会导致 CommandAPI 抛出异常

Minecraft 版本更新

• 新增对 1.20.2 版本的支持

新功能

• #459 增加了在命令执行器中访问原始参数的功能
• #469 新增 AdventureChatColorArgument
• #417 支持在服务器运行期间动态注册与注销命令

错误修复

• 修复了 CommandAPI 在 1.20.1 版 Paper 服务器上误判为 Folia 服务器，从而导致数据包被禁用的问题

Minecraft 版本更新

• 新增对 1.20.1 版本的支持

新功能

• #455 重构了 MapArgument，新增多项特性，包括：
  • 键与值可选择性地使用引号包裹
  • 键名中允许使用任意字符（此前仅支持字母、数字和下划线）
  • 可自定义键值对之间的字符串分隔符（不再仅限于空格）

错误修复

• 修复 use-latest-nms-version 未指向正确版本的问题

Minecraft 版本更新

• 新增对 Minecraft 1.20 的支持

新功能

• 新增通过节点名称检索 LiteralArgument 和 MultiLiteralArgument 的能力
• #363 新增 withUsage() 方法，用于自定义命令用法说明
• #371 更新默认简短描述，现会注明创建该命令的插件

错误修复

• 修复了命令转换过程中字面量参数因解析问题导致的错误

错误修复

• 修复了 MapArgument 不允许玩家名称作为键的问题，原因是遗漏了对 _ 字符的支持
• 修复了 /execute as ... 命令无法正常工作的问题，原因是我们错误地将发送者强制转换为了玩家而非代理发送者
• 修复了 IntegerArgument 在某些情况下无法编译的问题

新功能

• 新增 CommandArguments.count() 工具方法，用于获取参数数量
• 新增 CommandArguments.getOptional() 方法族
• 新增 CustomArgumentException 静态工厂方法，支持接收 Spigot/Paper 文本组件

平台支持变更

• 新增对 Folia 的基础支持

⚠️ 此版本与任何使用 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 请求重新支持这些版本

8.7.6 版本新增改进：

• 增加对 Minecraft 1.19.4 的支持

8.7.5 版本新增改进：

• 修复了命令 API 加载后阶段偶尔出现的空指针异常

8.7.3 版本新增改进：

• 修复了注解系统未能正确处理 @AWorldArgument 的问题
• 修复了 LootTableArgument 在 1.17 至 1.19.3 版本中无法正常工作的问题

8.7.2 版本新增改进：

• #397 修复了 WorldArgument 在 1.16.5 中无法正常工作的问题

8.7.1 版本新增改进：

• 修复了在 1.19.3 版本中多个参数无法正常工作的问题（函数、配方、音效、进度、生物群系、实体列表、战利品表）
• 修复了在 1.19.3 版本中 WorldArgument 参数无法正常工作的问题

8.7.0 版本新增改进：

• 修复了 ParticleArgument 在 1.19.3 中无法正常工作的问题
• 修复了 EnchantmentArgument 在 1.19.3 中无法正常工作的问题
• 紧急修复了权限检查错误（当权限系统初始化不当时）
• 紧急修复了通过重定向命令触发自动补全时发生的空指针异常
• 修复了使用 commandapi-shade 时，JavaDoc 在 IDE 中无法显示的问题

8.6.0 版本新增改进：

• 增加对 Minecraft 1.19.3 的支持
• 移除了部分参数对泛型和参数类型参数的需求

8.5.1 版本新增改进：

• #307 新增 CommandArgument，允许用户将命令作为参数提交
• #334 在 CommandAPI.fail() 中增加对聊天组件的支持
• #338 新增通过 instance.copy() 方法克隆 CommandAPICommand 实例的功能
• #351 新增基于 TextArgument 后端的 ListArgument，支持内联列表
• #358 新增 WorldArgument 参数，用于获取 Minecraft 世界维度列表
• 新增 SoundArgument 支持，可通过 NamespacedKey 返回基于字符串的声音
• #352 为 LiteralArgument 新增若干辅助方法，便于通过静态导入方式使用
• #357 新增 Kotlin DSL，支持在 Kotlin 中注册命令！

8.5.0 版本新增改进：

• 新增对 Minecraft 1.19.2 的支持
• 修复了在 1.19+ 版本中启用带颜色的聊天预览时玩家被踢出游戏的 Bug
• 防止开发者创建存在重复参数节点名称的异常命令，避免客户端在尝试执行这些命令时崩溃
• 修复父命令注册时子命令内部信息在运行时被覆盖的问题
• 修复 1.17+ 版本中时间参数无法正常工作的问题
• 修复 1.17 版本中命名空间键参数无法正常工作的问题
• 修复 1.17 与 1.18 版本中命令无法正常工作的问题
• 修复 Spigot 服务器重载时抛出异步相关异常的问题
• 修复当子命令节点名称与参数节点名称相同时，参数建议无法正常显示的问题
• 改进 1.17+ 版本中聊天颜色、附魔与药水参数的后端代码
• 优化 1.19+ 版本的代码体积
• 改进列表参数：仅对最后一项显示建议，并阻止列表参数接受未列出的项目

Minecraft 版本更新

• 新增对 Minecraft 26.1 的支持

错误修复

• 修复了启动时命令注册的多个问题

Minecraft 版本更新

• 新增对 Minecraft 26.1 的支持

错误修复

• 修复了启动时命令注册相关的多个问题

Minecraft 版本更新

• 新增对 Minecraft 26.1 的支持

错误修复

• 修复了启动时命令注册的多个问题

Minecraft 版本更新

• 添加了对 Minecraft 1.21.11 的支持

问题修复

• 修复了在某些情况下调用 CommandAPI.unregister() 替换命令无效的问题
• 修复了自定义命名空间无法使用的问题
• 修复了在运行时注册或注销大量命令可能导致服务器超时的问题

新功能

• #642 添加了 enable-networking 和 make-networking-exceptions-warning 配置选项。你可以在文档中阅读更多相关内容