Melius Commands

Melius Commands

Данный Fabric-мод для сервера предоставляет возможность создания пользовательских команд и модификации существующих игровых команд.

Создание собственных команд

Для добавления собственных команд необходимо создать JSON-файл в директории ./config/melius-commands/commands. Примеры конфигурационных файлов доступны на странице проекта. После внесения изменений выполните команду /reload в игре для применения настроек.

Структура JSON-файла

Формат файла поддерживает комментарии для удобства настройки (не копируйте символы // в ваши конфигурационные файлы).

Элемент команды (литерал или аргумент)

Для упрощения создания пользовательских команд рекомендуется использовать онлайн-генератор, который обеспечивает корректность синтаксиса.

Корневой элемент должен всегда быть литеральным узлом.

{
  "id": "...",
  // Идентификатор команды (имя команды для литеральных узлов) (обязательно)
  "type": "...",
  // Тип аргумента, смотрите ниже. (только для узлов аргументов, обязательно)
  "executes": [
    // Список исполнений команды, смотрите ниже.
  ],
  "require": {
    // Проверка условий для доступа к команде
  },
  "literals": [
    // Список дочерних литеральных узлов
  ],
  "arguments": [
    // Список дочерних узлов аргументов
  ],
  "redirect": "..."
  // Если указано, команда скопирует исполнение, требования и дочерние элементы из указанного узла.
  // Это позволяет создать псевдоним для другой команды
}

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

Может представлять собой простую строку, которая будет выполнена тихо, от имени консоли с уровнем привилегий 4, или может быть настроена вручную:

{
  "command": "...",
  // Команда для выполнения (может ссылаться на значения аргументов через ${id})
  "silent": false,
  // Отключить вывод команды, если установлено true
  "as_console": false,
  // Выполнять ли команду от имени консоли
  "op_level": 4
  // Уровень оператора источника команды (необязательно) (возможные значения: 0 - 4)
}

А самое интересное - значение command может использовать заполнители из аргументов команды и глобальные плейсхолдеры используя формат ${ЗАПОЛНИТЕЛЬ}, где ЗАПОЛНИТЕЛЬ может быть либо идентификатором аргумента, либо глобальным заполнителем, например, значением из других плагинов.

Типы аргументов

Полный список всех типов аргументов доступен в соответствующем разделе Minecraft Wiki. Некоторые типы аргументов требуют дополнительных параметров, которые должны быть добавлены через пробелы.

Модификаторы команд

Для добавления требований к командам создайте JSON-файл в директории ./config/melius-commands/modifiers.

Структура JSON-файла

Используйте онлайн-генератор для быстрого и удобного создания модификаторов команд с гарантией корректности синтаксиса.

Модификатор команд

Ключевая особенность: существует два типа сопоставителей команд:

• Сопоставители узлов соответствуют узлам команд (структура, используемая Brigadier для представления команд внутренне) по их пути (например, teleport.location соответствует командам вида /teleport 0 100 0)
• Сопоставители команд соответствуют строке, используемой при выполнении команды (например, warp end соответствует /warp end)

Определение путей командных узлов

Используйте команду /melius-commands path <cmd> для определения путей командных узлов любой команды. Например, для проверки пути команды /tp DrexHD 0 100 0 введите /melius-commands path tp DrexHD 0 100 0 и получите teleport.targets.location, который можно использовать в модификаторах команд.

Заполнители

• %melius-commands:cooldown [id]% / %melius-commands:cooldown [id] [formatting]% - Отслеживание времени восстановления команд для игрока.
  • [id] - идентификатор, указанный в модификаторе времени восстановления.
  • [formatting] - форматирование длительности исполнения.