CommandAPI - современный инструмент для работы с командами в Minecraft

CommandAPI представляет собой мощный API для серверов Bukkit/Spigot, который полностью реализует функциональность пользовательского интерфейса команд, появившегося в обновлении Minecraft 1.13.

Основные возможности

Данная библиотека кардинально упрощает процесс создания и управления командами, предлагая разработчикам следующие преимущества:

• Интеллектуальная валидация аргументов - автоматическая проверка и преобразование входящих данных в нужные типы
• Расширенная поддержка исполнителей команд - возможность выполнения команд от имени различных сущностей через /execute
• Интеграция с функциями Minecraft - совместимость с системой функций и тегов игры
• Упрощенная регистрация - больше не требуется указывать команды в файле plugin.yml
• Автономная работа - не требует дополнительных зависимостей вроде Brigadier
• Конфиденциальность - полное отсутствие сбора статистики и отслеживания

Автоматическое преобразование типов

Забудьте о ручной проверке типов аргументов! 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();

Библиотека поддерживает более 40 различных типов аргументов, включая зачарования, типы сущностей, местоположения, предметы, эффекты зелий и многое другое!

Проверка типа отправителя команды

Больше не нужно вручную проверять, является ли отправитель команды игроком:

new CommandAPICommand("mycommand")
    .withArguments(arguments)
    .executesPlayer((player, args) -> {
        player.sendMessage("Привет " + player.getDisplayName());
    })
    .register();

Дополнительные функции

CommandAPI также предлагает:

• Ограничение числовых значений определенными диапазонами
• Обработка координат с поддержкой относительных значений (~)
• Парсинг JSON в объекты BaseComponent[]
• Предложения игроков на основе онлайн-списка
• Создание пользовательских аргументов
• Применение прав доступа к отдельным аргументам
• Конвертация команд других плагинов для работы с /execute
• Обработка результатов выполнения команд
• Контекстные подсказки на основе введенных данных

Встроенный конвертер плагинов

Специальная система преобразования позволяет сделать команды любых плагинов совместимыми с системой /execute и датапаками Minecraft, даже если изначально они не были разработаны с использованием CommandAPI.