[API] CommandAPI - 命令界面开发库

CommandAPI 是一个用于 Minecraft 1.13 及以上版本的强大命令开发 API，它全面支持新版命令 UI，让开发者能够轻松创建功能丰富、提示完善且兼容性强的自定义命令。所有详细信息和资源均可在其 GitHub 页面找到。

💡什么是 CommandAPI？

CommandAPI 为 Minecraft 1.13 版本引入的全新命令 UI 提供了完整的支持。它旨在简化命令开发流程，提升玩家体验，并确保与现代 Minecraft 功能（如 /execute 命令和函数）的完全兼容。

想保持更新？我们现已开通 Discord 服务器！

✨核心特性概览

• 更优的命令：防止玩家执行无效命令，为开发者提供便利。
• 更优的参数：内置自动参数解析与验证机制。
• 支持代理命令发送者：可通过 /execute as ... run command 让其他实体执行你的命令。
• 支持 /execute 命令：允许你的命令被原版 /execute 命令调用。
• 支持 Minecraft 函数：允许你的命令从 Minecraft 函数和标签中执行。
• 无需 plugin.yml 注册：命令不再需要在 plugin.yml 文件中注册。
• 无其他依赖：无需在项目中导入 Brigadier 即可使用 CommandAPI。
• 无数据追踪：CommandAPI 不收集任何插件使用数据，完全透明。

🎮参数类型自动转换

无需再手动检查参数类型并处理异常。CommandAPI 能自动推断你所需的类型，让你直接使用。

传统方式示例：

onCommand(CommandSender sender, Command command, String label, String[] args) {
    try {
        int i = Integer.parseInt(args[0]);
        // 处理这个数字
    } catch (NumberFormatException e) {
        // 处理非数字的情况...
    }
}

使用 CommandAPI 的方式：

new CommandAPICommand("mycommand")
    .withArguments(new IntegerArgument("myint"))
    .executes((sender, args) -> {
        int i = (int) args.get("myint");
        // 直接处理这个数字
    })
    .register();

CommandAPI 提供了超过 40 种不同的参数类型，可满足各种需求！支持自动转换为 Enchantment、EntityType、Location、ItemStack、PotionEffect 等多种类型。

🎮命令发送者类型检查

无需再手动检查命令发送者是否为玩家。CommandAPI 为各种命令发送者提供了自动检查。

示例：

new CommandAPICommand("mycommand")
    .withArguments(arguments)
    .executesPlayer((player, args) -> {
        player.sendMessage("Hi " + player.getDisplayName());
    })
    .register();

🔧文档与资源

最新、最全面的文档可以在此处找到。相信我，你从未见过如此出色的文档。

⭐内置插件命令转换器

是否因你的插件命令无法与 /execute 命令兼容而烦恼，又不知如何编写代码？CommandAPI 为你提供了解决方案！通过其内置的插件命令转换系统，你可以让任何插件的命令都与 Minecraft 的 /execute 命令及数据包兼容！

❓还有更多功能？

• 自动范围解析：解析整数时自动强制限定在指定范围内。
• 灵活的位置参数：处理整数和浮点坐标位置，以及使用 ~ 符号的相对位置。
• 原始 JSON 解析：将原始 JSON 字符串直接解析为 BaseComponent[]。
• 在线玩家解析：基于当前在线玩家提供建议。
• 自定义参数：创建将字符串解析为自定义对象的参数。
• 参数级权限：为特定参数设置权限，玩家需要权限才能看到建议并执行。
• 插件兼容性：让未使用 CommandAPI 编写的插件命令也能与 /execute 命令兼容。
• 命令结果处理：像处理命令方块一样处理命令的成功与结果。
• 上下文感知建议：根据用户已输入的内容，动态提供参数建议。