Shortcut

Shortcut — это плагин для Minecraft, позволяющий создавать собственные сокращённые команды без необходимости установки дополнительных модулей.

Важная информация: Плагин полностью безопасен при использовании команды /reload. Все команды будут корректно отключены и восстановлены в соответствии с изменениями в конфигурации.

Настройка плагина

Каждая команда настраивается индивидуально через конфигурационный файл YAML. Вот базовая структура:

# Название команды, которое будет использоваться в игре (например, /название_команды)
название_команды:
  # Опциональное разрешение — любой текст
  # Без этого разрешения команда недоступна
  permission: пример.разрешения
  # Опционально: только для игроков
  # Для не-игроков команда сразу завершится
  playerOnly: false
  # Опционально: описание использования команды
  usage: /название_команды <значение>
  # Основной блок, определяющий действия команды
  executions:
    - {
        # Команда для выполнения
        # %%0 заменяется на первый аргумент, %%1 — на второй и т.д.
        # Можно использовать плейсхолдеры
        run: say %%0,
        # От чьего лица выполнять команду
        # Допустимые значения: "sender" или "console"
        as: sender
    }
    - {
        # Сообщение, которое увидит пользователь
        # Поддерживает форматирование и плейсхолдеры
        display: Пример сообщения с §aформатированием!
    }

Практический пример

Пример конфигурации для команды "gmc":

В этом примере используются плейсхолдеры — убедитесь, что установлен PlaceHolderAPI, если хотите их применять

# Название команды
gmc:
  # Необходимое разрешение
  # Не обходит проверки оригинальной команды!
  # Плейсхолдеры здесь не работают
  permission: command.gamemode
  # Только для игроков
  # Плейсхолдеры здесь не работают
  playerOnly: true
  # Сообщение при неправильном использовании
  # Плейсхолдеры здесь не работают
  usage: /gmc
  executions:
    # Выполняет команду "gamemode creative" от лица консоли
    # Плейсхолдеры работают здесь
    - { run: gamemode creative %player_name%, as: console }
    # Показывает сообщение исполнителю
    # Плейсхолдеры работают здесь
    - { display: "§0[§a✓§0]§r Вы переключились в креативный режим" }

Разберём ключевые элементы:

Первое действие выполнения

Переключает режим игры игрока на креативный. Плейсхолдер %player_name% подставляется автоматически.

Второе действие выполнения

Отображает подтверждающее сообщение с цветовым оформлением.