3. Discord
Подключите официального бота Saba-chan и задайте для каждого сервера Discord доступные серверы и права на команды.
3. Discord
Бот Saba-chan для Discord — официальный бот, работающий в облаке Saba-chan. Не нужно создавать бота, хранить токен или использовать проброс портов (настройку роутера, которая передаёт внешние подключения на ваш ПК). Saba-chan на вашем ПК сам подключается к облаку и забирает оттуда команды из Discord.
Настройка состоит из трёх шагов: подключить бота (сопряжение), выбрать серверы для каждого сервера Discord и решить, кто какие команды может использовать.
Шаг 1: подключение бота (сопряжение)
- На экране Discord вверху приложения откройте Подключение и нажмите
Подключить сервер Discord. - Если бота Saba-chan ещё нет на вашем сервере Discord, сначала пригласите его кнопкой
Пригласить бота. - Когда появятся код подключения и команда для ввода (
/saba connect code:…), нажмитеКопировать. - Вставьте её в канал Discord и отправьте. Эту команду могут использовать только люди с правом Управлять сервером на этом сервере Discord.
- Если вы впервые пользуетесь Saba-chan с этим аккаунтом Discord, бот сначала предложит зарегистрироваться. Нажмите
Зарегистрироваться, ознакомьтесь с условиями на сайте и зарегистрируйтесь, после чего этот ответ сменится подтверждением подключения. Код всё это время ждёт. - Когда бот спросит, подключать ли, нажмите
Подключить. Нажимайте, только если код получен прямо в приложении Saba-chan: если код дал кто-то другой, ПК этого человека подключится к вашему аккаунту. - Бот сообщит о завершении подключения, а приложение переключится на
Подключено.
Код действует 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. Выберите один — откроются его вкладки.
На вкладке Экземпляры вы решаете, какими игровыми серверами может пользоваться этот сервер 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.