CustomCommands - Плагин для кастомных команд с продвинутыми возможностями

Если вы админ сервера на Paper или Folia, и вам надоело вручную писать кучу плагинов для каждой мелочи вроде /discord или /kick - CustomCommands как раз то, что надо. Этот плагин позволяет создавать сколько угодно своих команд с вложенными подкомандами, аргументами, автодополнением, проверкой игроков и даже выполнением консольных команд. Всё настраивается в одном конфиге, без перезагрузки сервера.

Скачайте плагин CustomCommands для Майнкрафт и преобразите управление своим сервером. Он решает главную проблему: кастомные команды часто требуют кучи отдельных плагинов или костылей, а тут всё в одном флаконе.

Что умеет CustomCommands

Кастомные команды

• Создавайте сколько угодно своих команд с правами доступа, алиасами и кулдаунами
• Для каждой команды можно задать отдельное permission
• Алиасы работают как обычно: /dc для /discord
• Кулдауны спасают от спама
• Полная поддержка Folia (с версии 1.1.0)

Вложенные подкоманды

• К любой команде можно добавить подкоманды с таб-комплитом
• Глубина вложенности не ограничена - подкоманды могут иметь свои подкоманды
• У каждого уровня свои права доступа
• Система автодополнения работает умно
• Пример: /admin player kick, /admin server restart

Система аргументов

• Добавляйте аргументы к командам и подкомандам
• Используйте {args} в сообщениях и консольных командах
• Белый список разрешённых аргументов
• Аргументы могут быть обязательными или опциональными
• Поддержка аргументов с пробелами
• Пример: /say hello, /kick Steve, /teleport Player 100 64 200

Проверка игроков (player-args)

• Можно пометить определённые аргументы как имена игроков
• Автоматическая валидация - плагин проверит, существует ли игрок и онлайн ли он
• Умное автодополнение - показываются только онлайн игроки
• Понятные сообщения об ошибках
• Работает с вложенными подкомандами
• Пример: /kick Steve (проверит, что Steve онлайн)

Выполнение консольных команд

• Любая серверная команда может выполняться через кастомную команду
• Выбор типа выполнения: "Console" (от имени сервера) или "Player" (от имени игрока)
• Переменные для подстановки:
  • {player} - имя игрока
  • {displayname} - отображаемое имя
  • {world} - мир игрока
  • {x}, {y}, {z} - координаты
  • {online_players} - количество игроков онлайн
  • {max_players} - максимальное количество игроков
  • {args} - аргументы команды

Кликабельные ссылки

• Поддержка кликабельных ссылок в сообщениях
• Синтаксис: (Текст ссылки)[<URL>]
• Открывает URL в браузере игрока
• Работает как в основных командах, так и в подкомандах

Современное форматирование текста

• Полная интеграция с Kyori Adventure API
• Поддержка HEX цветов (&#FF8800)
• Старые цветовые коды (&6, &c, и т.д.)
• JSON tellraw с кликабельными элементами

Продвинутые фишки

• Горячая перезагрузка конфига без остановки сервера
• Собственная система логов с цветным выводом в консоль
• Ротация файлов логов
• Обработка ошибок и асинхронное выполнение команд

Примеры конфигов и использования

Вложенные подкоманды с аргументами

admin:
  permission: "customcommands.admin"
  subcommands:
    player:
      permission: "customcommands.admin.player"
      subcommands:  # Вложенные подкоманды!
        kick:
          permission: "customcommands.admin.player.kick"
          arguments:
            player-args: [0]  # Первый аргумент - имя игрока
            no-arguments: false
          commands:
            - "kick {args} Kicked by {player}"
        ban:
          permission: "customcommands.admin.player.ban"
          arguments:
            player-args: [0]
            no-arguments: false
          commands:
            - "ban {args} Banned by {player}"

Использование:

• /admin player kick Steve - Кикнет Steve (проверит, что он онлайн)
• /admin player ban Steve - Забанит Steve (проверит, что он онлайн)

Команда Discord с подкомандами

discord:
  permission: "customcommands.discord"
  alias: ["dc"]
  subcommands:
    send:
      commands:
        - "msg {player} &6Discord: &bhttps://discord.gg/example"
    invite:
      message:
        - "&7Click here: (Join Discord)[<https://discord.gg/example>]"

Команда с аргументами и белым списком

say:
  permission: "customcommands.say"
  arguments:
    whitelist: ["hello", "goodbye", "help"]
    whitelist-only: true
    no-arguments: true
  commands:
    - "say {player}: {args}"

Использование:

• /say hello - Пройдёт (есть в белом списке)
• /say goodbye - Пройдёт
• /say test - Не пройдёт (нет в белом списке)

Команда с проверкой игрока

kick:
  permission: "customcommands.kick"
  arguments:
    player-args: [0]  # Первый аргумент должен быть именем игрока
    no-arguments: false
  commands:
    - "kick {args} Kicked by {player}"

Использование:

• /kick Steve - Сработает, если Steve онлайн
• /kick InvalidPlayer - Ошибка: "Игрок InvalidPlayer не в сети или не существует!"

Установка

1. Скачайте JAR-файл плагина
2. Поместите его в папку plugins вашего сервера
3. Перезапустите сервер
4. Настройте команды в plugins/CustomCommands/config.yml
5. Используйте /customcommands reload для перезагрузки конфига

Команды

• /customcommands - Основная команда
• /customcommands reload - Перезагрузить конфиг
• /customcommands help - Помощь
• /customcommands version - Информация о версии

Permissions

• customcommands.* - Все права
• customcommands.use - Базовое использование
• customcommands.reload - Перезагрузка
• customcommands.commandname - Использование конкретной команды
• customcommands.commandname.subcommand - Использование подкоманды
• customcommands.commandname.subcommand.nested - Использование вложенной подкоманды

Совместимость и требования

Полностью протестировано:

• Folia 1.21.x (с версии 1.1.0)
• Paper 1.21.4+

Вероятно работает:

• Paper 1.21.0-1.21.3 (тестировалось на 1.21.2-1.21.3)
• Paper 1.20.x (не тестировалось)
• Paper 1.19.x (возможны мелкие проблемы)

Не поддерживается:

• Spigot - плагин использует paper-plugin.yml и требует Paper API
• Кастомные форки Paper - используйте на свой страх и риск
• PlugMan - не загружайте плагин через PlugMan (он всё равно не работает с Paper плагинами)

Важно знать

• Разработчик не несёт ответственности за краши на кастомных форках
• Плагин создан для Paper и Folia (v1.1.0+)
• Не используйте PlugMan
• Всегда делайте бэкап перед установкой
• Сначала тестируйте на дев-сервере, а потом на проде

Файлы конфига (config.yml, messages.yml) содержат подробную документацию: цветовые коды, переменные, примеры консольных команд, синтаксис кликабельных ссылок, создание подкоманд, систему аргументов, вложенные подкоманды, фичу player-args. Всё это сразу в комментариях - редактируй и перезагружай.

Плагин CustomCommands - реально удобная штука для администраторов, которые хотят гибкости без кучи лишних плагинов. На Folia работает на ура, так что если у вас сервер на новом Paper или Folia - берите, не пожалеете.