3. Discord

Подключите официального бота Saba-chan и задайте для каждого сервера Discord доступные серверы и права на команды.

3. Discord

Бот Saba-chan для Discord — официальный бот, работающий в облаке Saba-chan. Не нужно создавать бота, хранить токен или использовать проброс портов (настройку роутера, которая передаёт внешние подключения на ваш ПК). Saba-chan на вашем ПК сам подключается к облаку и забирает оттуда команды из Discord.

Настройка состоит из трёх шагов: подключить бота (сопряжение), выбрать серверы для каждого сервера Discord и решить, кто какие команды может использовать.


Шаг 1: подключение бота (сопряжение)

Saba-chan
СерверыDiscordНастройки
ДемонБот выключен
ПодключениеНе подключено
Серверы Discord
Основные
Подключение к DiscordПолучите код и введите его на своём сервере Discord. После подключения вы сможете запускать и останавливать игровые серверы оттуда через бота.
Подключить сервер DiscordПригласить бота
#общийНаш сервер
kimchi12:00
Бота пригласил!
Написать в #общий
  1. На экране Discord вверху приложения откройте Подключение и нажмите Подключить сервер Discord.
  2. Если бота Saba-chan ещё нет на вашем сервере Discord, сначала пригласите его кнопкой Пригласить бота.
  3. Когда появятся код подключения и команда для ввода (/saba connect code:…), нажмите Копировать.
  4. Вставьте её в канал Discord и отправьте. Эту команду могут использовать только люди с правом Управлять сервером на этом сервере Discord.
  5. Если вы впервые пользуетесь Saba-chan с этим аккаунтом Discord, бот сначала предложит зарегистрироваться. Нажмите Зарегистрироваться, ознакомьтесь с условиями на сайте и зарегистрируйтесь, после чего этот ответ сменится подтверждением подключения. Код всё это время ждёт.
  6. Когда бот спросит, подключать ли, нажмите Подключить. Нажимайте, только если код получен прямо в приложении Saba-chan: если код дал кто-то другой, ПК этого человека подключится к вашему аккаунту.
  7. Бот сообщит о завершении подключения, а приложение переключится на Подключено.

Код действует 5 минут. Потом нажмите Получить новый код. Если ваш аккаунт Discord уже подключался, на другом сервере Discord достаточно отправить просто /saba connect без кода, и все ПК вашего аккаунта сразу подключатся к этому серверу Discord. Для этого тоже нужно право Управлять сервером на этом сервере Discord. К серверу Discord, подключённому таким образом, сначала не привязан ни один игровой сервер, поэтому выберите в приложении, какие серверы открыть (шаг 2 ниже). Сервер Discord, подключённый по коду, подчиняется настройке Сразу открывать мои серверы для нового сервера Discord на экране Discord → Подключение приложения.

К одному аккаунту Discord можно подключить несколько ПК. Если отправить новый код с аккаунта, у которого уже есть ПК, бот покажет кнопки Подключить как новый ПК и Переподключить <имя ПК>. Для ПК, который вы подключаете впервые, выберите Подключить как новый ПК; если подключаете заново ПК, который уже подключали, выберите его (его прежнее подключение перестанет работать). Свои ПК можно посмотреть, переименовать или удалить командой /mysaba my-pcs.

К одному серверу Discord тоже можно подключить несколько ПК. Когда друг подключает свой ПК к тому же серверу Discord, серверы обоих ПК показываются вместе, а каждая команда уходит на ПК, где находится этот сервер. Если имена серверов совпадают, к имени сервера ПК, подключённого позже, добавляется -имяПК. Общие настройки, такие как язык, префикс, Поющая Saba-chan и назначение каналов, меняют владелец первого подключённого ПК и владелец сервера Discord. Серверы и права каждого ПК задаёт владелец этого ПК.


Шаг 2: выбор серверов для каждого сервера Discord

Подключённые серверы Discord перечислены в Discord → Серверы Discord. Выберите один — откроются его вкладки.

Saba-chan
СерверыDiscordНастройки
ДемонБот в сети
ПодключениеПодключено
Серверы Discord
GНаш сервер
Основные
Наш сервер
ЭкземплярыУчастникиКомандыСловаКаналыНастройки бота
Экземпляры, доступные этому серверу Discord
Все экземпляры
Новые экземпляры появляются сразу
Только выбранные
В Discord видны только включённые вами экземпляры

На вкладке Экземпляры вы решаете, какими игровыми серверами может пользоваться этот сервер Discord. Экземпляр — это один игровой сервер, зарегистрированный в Saba-chan.

  • Все экземпляры: видны все серверы, нынешние и будущие.
  • Только выбранные: на этом сервере Discord видны и доступны только включённые вами серверы. Удобно, чтобы дать разным компаниям друзей разные серверы.

Не разрешённый сервер нигде не появляется на этом сервере Discord: ни в командах, ни в списках, ни в слэш-командах.


Шаг 3: права на команды

Уровней доступа пять. Уровни накопительные: верхний уровень может использовать все команды нижних.

УровеньКто
Владелец (3)Тот, кто подключил этот сервер Discord. Может всё и не может быть понижен
Админ (2)Те, кому вы доверяете даже опасные команды
Пользователь (1)Те, кто может запускать и останавливать серверы. Поначалу это уровень по умолчанию для всех участников
Гость (0)Те, кто может использовать только безопасные команды, например просмотр состояния
Запрещён (-1)Не может пользоваться ботом вовсе, включая Поющую и Говорящую Saba-chan

Права открываются нажатием на сервер (экземпляр) на вкладке Экземпляры. Кнопка Права для всех экземпляров показывает все серверы сразу. Экранов два.

  • Уровни команд: лестница, на которой команды лежат в виде чипов. Чип стоит на самом низком уровне, которому разрешена команда. Перетащите чип на другую ступень или нажмите на него, чтобы изменить требуемый уровень. Набор правил команд вверху (Свободно, По умолчанию, Строго) расставляет команды сразу по уровню риска (безопасная, осторожно, опасная). Набор по умолчанию: безопасная = Гость, осторожно = Пользователь, опасная = Админ. При смене набора и отдельно перенесённые чипы возвращаются к набору. Предел Говорящей Saba-chan внизу — это уровень, выше которого не могут подняться запросы, прошедшие через Говорящую Saba-chan (изначально Гость).
  • Уровни участников: задайте уровень по умолчанию (уровень, который получают участники без собственного уровня) и уровень каждому участнику. В Редактировать уровни можно переименовать уровни, добавить ступени и изменить порядок.

Уровни участников и набор правил действуют сразу для всех серверов этого сервера Discord. Если перенести команду всего сервера (не привязанную к конкретному серверу), она изменится на экранах прав всех серверов. Справку и список может использовать любой, кроме «Запрещён».

  • В окне, которое открывается по нажатию на чип, для каждой команды можно изменить и уровень уточняющих вопросов Discord (безопасная, осторожно, опасная). Он сравнивается только с настройкой уточняющих вопросов ниже и не меняет ни требуемый уровень, ни подтверждения в приложении и CLI.
  • В Discord владелец тоже может менять уровни участников и уровень по умолчанию командой /saba permission. Если выбрать пользователя, это уровень этого участника (пункт Снять в списке уровней возвращает уровень по умолчанию), если не выбирать — уровень по умолчанию. Набор правил, предел Говорящей Saba-chan и уровни отдельных команд меняются только в приложении.

Уточнять перед выполнением

Спрашивать ли ещё раз кнопкой перед выполнением команды, о которой попросили в Discord, определяется в карточке Уточняющие вопросы на вкладке Настройки бота сервера Discord. Нажать кнопку может только тот, кто попросил.

ПунктДоступные уровниИсходное значение
Прямой запрос боту (команды с префиксом, слэш-команды)Все команды · Осторожно и выше · Только опасные · Не спрашиватьТолько опасные
Говорящая Saba-chanВсе команды · Осторожно и выше · Только опасные · Не спрашиватьВсе команды
  • Административные действия, выбранные Говорящей Saba-chan, и просьбы, в которых участвует несколько человек, спрашиваются всегда, независимо от этой настройки.
  • Приложение, веб и CLI спрашивают про опасные команды, остановку и перезапуск независимо от этой настройки.
  • В CLI её можно посмотреть и изменить командой saba-chan-cli bot confirm.

Пробуем в Discord

#общийНаш сервер

Команды сообщением пишутся как префикс сервер команда. Префикс — это слово, с которого начинается команда. Префикс по умолчанию на серверах Discord, где бот отвечает по-русски, — Saba-chan; изменить его или добавить другие можно для каждого сервера Discord на вкладке Настройки бота (Префикс команд).

Что нужноЧто отправить
Список серверов и состояниеSaba-chan list
Запуск / остановка / состояниеSaba-chan mc start · Saba-chan mc stop · Saba-chan mc status
СправкаSaba-chan help

Чтобы назвать сервер, используйте его имя, слово, заданное на вкладке Discord экрана сервера, а если это единственный сервер этой игры — название игры (например mc или minecraft). Если серверов одной игры несколько, называйте их по имени или по слову, заданному для каждого. Опасные команды по названию игры не выполняются, поэтому называйте сервер по имени или заданным словом. У каждого сервера также появляется своя слэш-команда /имя-сервера.

На той же вкладке Настройки бота в разделе Слэш-команды вы решаете, добавлять ли saba перед командой, как в /saba status (если выключить, команда будет видна просто как /status), использовать ли для имени серверной команды имя сервера или первое слово-вызов и видны ли результаты запросов только тому, кто их вызвал.

Чтобы управлять подробнее кнопками с телефона, откройте Saba-chan веб командой /saba web.