CommandClip

CommandClip представляет собой специализированный фреймворк для разработки команд в плагинах на платформе Bukkit.

CommandClip — это специализированный фреймворк, предназначенный для упрощения процесса создания и организации команд в плагинах для серверов Minecraft. Он предоставляет структурированный подход к обработке пользовательского ввода, позволяя разработчикам более эффективно управлять подкомандами, алиасами и проверками аргументов.

Библиотека предоставляет набор инструментов для стандартных задач обработки команд. К основным функциональным возможностям относятся:

• Регистрация базовых и подкоманд
• Настройка алиасов для команд
• Гибкая система проверки аргументов (testArgs)
• Встроенная поддержка прав доступа (permissions) с сообщениями об ошибках
• Удобная реализация автодополнения (tabCompletes)

Ниже приведен пример кода на Java, демонстрирующий базовый функционал фреймворка, включая создание основной команды с подкомандой, алиасом, проверкой аргументов и правами доступа:

new BaseCommand("hello", this)
    .subCommand(new SubCommand("there")
        .executes((commandSender, s, strings) -> {
            commandSender.sendMessage(s + " there " + strings[0]);
        })
        .tabCompletes((commandSender, s, strings) -> strings.length == 1 ? Bukkit.getOnlinePlayers().stream().map(Player::getName).toList(): List.of())
        .testArgs((commandSender, s, strings) -> {
            if (strings.length != 1)
                return "Please provide a valid playername";
            if (!Bukkit.getOnlinePlayers().stream().map(player -> player.getName()).toList().contains(strings[0]))
                return "Player is not online";
            return null;
        })
        .permission("hello.there", "You aren't allowed to get a Welcome :("))
    .alias("hi")
    .commandDescription("Welcomes you")
    .commandPermission("hello")
    .register();

Для включения фреймворка в проект можно использовать Gradle или Maven.

repositories {
    mavenCentral()
}

dependencies {
    compileOnly("io.github.nottamion:commandclip:1.1.0")
}

<dependency>
    <groupId>io.github.nottamion</groupId>
    <artifactId>commandclip</artifactId>
    <version>1.1.0</version>
</dependency>

Для уменьшения размера итогового файла плагина рекомендуется позволить серверу Spigot скачивать фреймворк автоматически, вместо того чтобы включать его в JAR-файл плагина (shading).

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

libraries:
  - io.github.nottamion:commandclip:1.1.0

Подробная документация по использованию фреймворка в данный момент находится в процессе разработки и доступна по адресу: https://github.com/notTamion/CommandClip/wiki