Команды
Полный список команд игровых серверов и собственных команд Saba-chan (включая слэш-команды) и способ зарегистрировать псевдонимы как личные сокращения.
Команды игровых серверов
Базовый синтаксис
Saba-chan <server> <command> [args…]
- Префикс по умолчанию —
Saba-chan. Его можно изменить для каждого сервера Discord на вкладке Настройки бота (Префикс команд) в разделе «Серверы Discord» приложения. Значение по умолчанию зависит от языка бота на этом сервере Discord (если не задан — от языка приложения на ПК) (корейский사바쨩, японскийサバちゃん, иначеSaba-chan). - После префикса обязательно должен идти пробел. Что-то вроде
Saba-chanxне распознаётся как команда. <server>— это имя экземпляра, псевдоним сервера либо имя или псевдоним модуля. Бот ищет их в порядке имя экземпляра → псевдоним сервера → псевдоним модуля. Примеры:minecraft,mc,마크, …- Если у вас несколько серверов одной игры, псевдоним модуля не может указать на какой-то один из них, поэтому используйте имя экземпляра или псевдоним сервера.
<command>— действие, определённое в модуле. Примеры:start,시작,say,말, …- Некоторые команды работают без указания сервера (глобальные команды). См. Глобальные команды ниже.
Регистр букв не учитывается.
START,Startиstart— одно и то же.
Бот разбирает сообщение в таком порядке:
- Проверяет префикс + пробел.
- Сначала проверяет пасхалки и команды Поющей Saba-chan (они обрабатываются прямо на ретрансляторе).
- Всё остальное отправляет в Saba-chan на вашем ПК. Он сначала проверяет глобальные команды (
help,list), а иначе трактует сообщение как<server> <command>. - Если Saba-chan не распознал ввод, а на этом сервере Discord включена Говорящая Saba-chan, она превращает его в точную команду и пробует ещё раз.
Те же команды доступны и как слэш-команды,
/<имя сервера>. В полеcommandвыберите команду, доступную на этом сервере, затем заполните появившееся полеargs. Discord сам показывает команды и варианты аргументов, доступные вашему уровню.
Глобальные команды
Команды, которые можно выполнить без указания сервера. Их может использовать любой, у кого не уровень «Запрещён».
| Команда | Действие |
|---|---|
Saba-chan help / Saba-chan 도움 / Saba-chan 도움말 | Показывает справку, а также модули и псевдонимы, доступные на этом сервере Discord |
Saba-chan list / Saba-chan 목록 | Список серверов, которыми может управлять бот, с их состоянием |
Saba-chan <server> | Показывает команды, доступные для этого сервера |
Можно ограничить, какие экземпляры видны на каждом сервере Discord (узле). На сервере с ограничением даже
listпоказывает только разрешённые экземпляры. Настраивается на вкладке Discord → Серверы Discord → Экземпляры приложения.
Команды, общие для всех модулей
Три команды, которые Saba-chan обрабатывает по умолчанию, независимо от типа модуля.
| Английская | Действие | Корейские псевдонимы (встроенные) |
|---|---|---|
start | Запуск сервера | 시작, 실행, 켜기 |
stop | Остановка сервера | 정지, 끝내기, 끄기 |
status | Текущее состояние | 상태, 상황, 확인 |
Примеры:
Saba-chan minecraft start
Saba-chan 마크 시작
Saba-chan palworld stop
Saba-chan 팰월드 상태
Команды модулей (команды игровой консоли)
Каждый игровой модуль определяет собственные команды в [[commands.fields]] файла module.toml и задаёт им псевдонимы в [aliases.commands]. Эти команды проходят через Saba-chan на вашем ПК в консоль игрового сервера (stdin); Palworld использует свой REST API.
Уровень риска команды определяет нужный для неё уровень прав (пресет по умолчанию: Безопасная = Гость, Осторожно = Пользователь, Опасная = Админ). Нужна ли кнопка подтверждения перед выполнением, определяют настройки уточняющих вопросов сервера Discord (сначала — только для опасных команд, Discord-бот §5).
Ниже — сводка по четырём играм с официальными модулями. Корейские псевдонимы — это значения по умолчанию из пакетов модулей; пользователи могут добавлять свои (см. Собственные сокращения).
Minecraft (псевдонимы модуля: 마인크래프트, 마크, mc, minecraft)
| Команда | Корейские псевдонимы | Описание | Риск |
|---|---|---|---|
say | 말, 채팅, 메시지 | Объявление | Безопасная |
give | 지급, 줘, item | Выдать предмет | Опасная |
save-all | 저장 | Сохранить мир | Безопасная |
save-flush | Нет | Сбросить на диск | Безопасная |
save-off | Нет | Выключить автосохранение | Осторожно |
save-on | Нет | Включить автосохранение | Безопасная |
list | Нет | Список игроков | Безопасная |
weather | 날씨, 웨더 | Сменить погоду | Опасная |
difficulty | 난이도, 어려움 | Сменить сложность | Опасная |
gamemode | 겜모드, 게임모드 | Сменить режим игры | Опасная |
time | 시간 | Установить время | Опасная |
tp | 텔레포트, 이동 | Телепортация | Опасная |
kick | 킥, 추방 | Выгнать игрока | Опасная |
ban | 밴, 차단 | Забанить игрока | Опасная |
pardon | 언밴, 해제 | Разбанить | Опасная |
op | 오피 | Назначить оператором | Опасная |
deop | 디옵 | Снять оператора | Опасная |
whitelist | 화이트리스트, 화리 | Белый список | Опасная |
seed | Нет | Показать сид | Безопасная |
Palworld (псевдонимы модуля: 팰월드, 팔월드, pw, palworld)
| Команда | Корейские псевдонимы | Описание | Риск |
|---|---|---|---|
announce | 공지, 공지사항, 알림 | Объявление | Безопасная |
info | 정보, 인포 | Информация | Безопасная |
players | 플레이어, 접속자, 유저 | Список игроков | Осторожно |
metrics | Нет | Метрики | Безопасная |
settings | Нет | Просмотр настроек | Безопасная |
save | 저장 | Сохранить мир | Безопасная |
shutdown | 종료, 셧다운 | Остановка | Опасная |
kick | 킥, 강퇴, 추방 | Выгнать игрока | Опасная |
ban | 밴, 차단, 영구밴 | Забанить игрока | Опасная |
unban | 언밴, 차단해제 | Разбанить | Опасная |
Project Zomboid (псевдонимы модуля: 좀보이드, 프로젝트 좀보이드, 프좀, pz, zomboid, project zomboid)
| Команда | Корейские псевдонимы | Описание | Риск |
|---|---|---|---|
servermsg | 공지, 공지사항, 알림, 메시지 | Объявление | Безопасная |
players | 플레이어, 접속자, 유저 | Список игроков | Безопасная |
save | 저장, 세이브 | Сохранить мир | Безопасная |
kick | 킥, 강퇴, 추방 | Выгнать игрока | Опасная |
banuser | 밴, 차단, 영구밴 | Забанить игрока | Опасная |
unbanuser | 언밴, 차단해제 | Разбанить | Опасная |
adduser | 유저추가, 계정추가 | Добавить пользователя | Опасная |
setaccesslevel | Нет | Установить уровень доступа | Опасная |
teleport | Нет | Телепортация | Осторожно |
teleportto | Нет | Телепортация по координатам | Осторожно |
createhorde | Нет | Создать орду зомби | Опасная |
godmod | Нет | Режим бога | Опасная |
invisible | Нет | Невидимость | Опасная |
startrain | Нет | Начать дождь | Осторожно |
stoprain | Нет | Остановить дождь | Осторожно |
chopper | Нет | Событие с вертолётом | Осторожно |
gunshot | Нет | Звук выстрела | Осторожно |
additem | Нет | Выдать предмет | Опасная |
addxp | Нет | Выдать опыт | Опасная |
showoptions | Нет | Показать параметры | Безопасная |
reloadoptions | Нет | Перезагрузить параметры | Опасная |
changeoption | Нет | Изменить параметр | Опасная |
quit | 종료, 셧다운 | Остановка | Опасная |
Terraria (псевдонимы модуля: 테라리아, 테라, terraria)
| Команда | Корейские псевдонимы | Описание | Риск |
|---|---|---|---|
help | Нет | Справка | Безопасная |
playing | 접속자, 플레이어, 목록 | Список игроков | Безопасная |
clear | Нет | Очистить консоль | Безопасная |
save | 저장 | Сохранить мир | Безопасная |
say | 말, 공지, 채팅 | Объявление | Безопасная |
version | Нет | Версия | Безопасная |
time | Нет | Игровое время | Безопасная |
port | Нет | Порт | Безопасная |
maxplayers | Нет | Максимум игроков | Безопасная |
motd | Нет | Сообщение дня | Безопасная |
password | Нет | Показать пароль | Осторожно |
dawn | Нет | Рассвет | Осторожно |
noon | Нет | Полдень | Осторожно |
dusk | Нет | Закат | Осторожно |
midnight | Нет | Полночь | Осторожно |
settle | Нет | Успокоить воду | Осторожно |
seed | Нет | Показать сид | Безопасная |
kick | 킥, 추방 | Выгнать игрока | Опасная |
ban | 밴, 차단 | Забанить игрока | Опасная |
exit-nosave | Нет | Остановка без сохранения | Опасная |
Собственные модули работают так же. Если разработчик модуля регистрирует команды в
module.tomlсогласно руководству по модулям, они автоматически появляются в справке бота, слэш-командах и системе псевдонимов.
Собственные сокращения
Слова, которыми называют сервер и его команды, задаются для каждого сервера отдельно. Меняйте их на вкладке Discord экрана сервера в приложении; после сохранения они действуют сразу, перезапуск не нужен. Эти слова принадлежат серверу, поэтому на всех подключённых серверах Discord сервер называется одними и теми же словами.
Слова для названия сервера
Добавляйте слова в поле Слова для названия сервера. Сервер можно называть по его имени и без этого; если это единственный сервер данной игры, его можно называть также по названию игры (например, 마크) и по псевдонимам модуля (в приложении они показаны как По умолчанию:).
- Слово — от 1 до 32 символов без пробелов, не более 10 слов в каждом поле.
- Если слово совпадает с именем, ID или словом другого сервера, с именем модуля, названием игры или псевдонимом модуля либо с зарезервированным словом вроде
help,도움말,list,목록, оно не сохраняется, а в приложении показывается причина.
Слова для названия команды
На том же экране добавляйте слова для каждой команды. Они ставятся перед псевдонимами из модуля, а исходное имя команды работает всегда. Псевдонимы команд Поющей Saba-chan здесь изменить нельзя.
Если у вас несколько серверов одной игры
Если серверов одной игры несколько, по названию игры нельзя определить, какой из них имеется в виду, поэтому удобно задать каждому серверу свои слова.
Псевдонимы на уровне пакета (для разработчиков модулей)
Чтобы встроить корейские псевдонимы по умолчанию в созданный вами модуль, добавьте в module.toml следующее. Псевдонимы могут указывать только на команды, определённые в [[commands.fields]] (или на встроенные start/stop/status).
[aliases]
module_aliases = ["내게임", "ig", "mygame"]
[aliases.commands]
start = { aliases = ["시작", "켜기"], description = "Start the server" }
custom_thing = { aliases = ["뭐시기", "그거"], description = "Do the thing" }
Каждый псевдоним должен быть одним словом без пробелов. Текстовые команды делятся на слова по пробелам, поэтому псевдоним с пробелом использовать нельзя. Подробности о разработке модулей — в руководстве по разработке модулей.
Права на экземпляры для отдельных узлов
Когда к одному Saba-chan подключено несколько серверов Discord (= узлов ретранслятора), можно ограничить, какими экземплярами может управлять каждый сервер Discord.
На вкладке Discord → Серверы Discord → Экземпляры приложения выберите Только выбранные. Это сохраняется в nodeSettings как список ID экземпляров:
{
"relay": {
"nodeSettings": {
"<guildId>": {
"allowedInstances": ["<instance ID>", "<instance ID>"]
}
}
}
}
На сервере Discord с ограничением команда list показывает только разрешённые экземпляры, слэш-команды создаются только для них, а на серверы вне списка бот отвечает, что они не найдены.
Команды Saba-chan
Слэш-команды Saba-chan
Это собственные команды Saba-chan, которые появляются, когда в Discord ввести /. Команды /<server> для управления игровыми серверами описаны выше, в разделе Команды игровых серверов. Где их можно использовать, зависит от состояния подключения сервера.
Если в настройках сервера Discord отключить префикс
saba, подкоманды/saba …ниже разворачиваются в корневые команды:/status,/permissionи так далее. Даже в развёрнутом виде команды управления сервером видны только тем, у кого есть права управления сервером. Вид меняется для каждого сервера в настройках сервера Discord в приложении (или командой CLIbot slash).
На подключённом сервере (/saba …)
| Команда | Кто | Действие |
|---|---|---|
/saba status | Все | Состояние ПК, подключённого к этому серверу |
/saba connect [code] | Право управления сервером | Подключает ПК по коду сопряжения из приложения. Если код не указан, сразу подключает все ПК, привязанные к этому аккаунту (какие серверы использовать, выбирается в приложении). Если аккаунт новый, сначала регистрация |
/saba disconnect | Подключивший, владелец сервера | Отключает ПК от этого сервера |
/saba permission level [user] | Подключивший | Если выбрать пользователя, задаёт его уровень команд; если нет, задаёт уровень сервера по умолчанию. Для выбранного пользователя можно также выбрать Снять |
/saba sleep | Подключивший | Усыпляет Saba-chan на этом сервере (игнорирует все сообщения) |
/saba wake | Подключивший | Будит уснувшую Saba-chan |
/saba assign kind | Подключивший, владелец сервера | Назначает текущий канал одним из типов: Говорящая Saba-chan, Поющая Saba-chan, Оповещения, Игровой чат, Status board. Повторный запуск в уже назначенном канале снимает назначение |
/saba language language | Подключивший | Язык, на котором Saba-chan отвечает на этом сервере (авто = язык приложения или сервера) |
/saba big-emoji state | Подключивший, владелец сервера | Включает или выключает увеличение пользовательских эмодзи (по умолчанию выключено) |
/saba settings | Подключивший | Настройки Говорящей Saba-chan на этом сервере |
/saba reading | Подключивший | Громкость, скорость и высота голоса Читающей Saba-chan на этом сервере и обращение по имени |
/saba web | Все | Ссылка на Saba-chan веб (5 минут, одноразовая, видна только вам) |
/saba update | Подключивший | Обновляет Saba-chan на подключённом ПК |
/saba help | Все | Как пользоваться и список команд, доступных здесь |
sleep показывается в списке только пока бот бодрствует, а wake — только пока спит. На сервере, к которому ещё не подключён ПК, видны только connect, assign, language, settings, reading, web, big-emoji и help, причём вместо «подключившего» их используют владелец сервера Discord или участник с правами управления сервером (assign — только для Говорящей и Поющей Saba-chan, Discord-бот §2.5).
Контекстное меню участника: щёлкните участника сервера правой кнопкой → Приложения → Изменить уровень Saba-chan, чтобы выбрать уровень команд этого человека (только на сервере с подключённым ПК и только подключивший).
Увеличение эмодзи (/settings › Language & commands › Emoji upscale)
Когда функция включена, сообщение, в котором есть только одно пользовательское эмодзи без текста, Saba-chan удаляет и публикует заново как крупную картинку с именем и аватаром отправителя. Если сообщение было ответом, картинка публикуется как ответ на то же сообщение. Если отправлены ровно два пользовательских эмодзи, они публикуются одной картинкой, склеенной без зазора в порядке отправки. Если среди них есть анимированные, получается GIF, где они движутся вместе, а более короткое повторяется (до 10 секунд). Обычные эмодзи (😀) и стикеры остаются как есть. Поскольку исходное сообщение приходится удалять, у бота должны быть права Управлять сообщениями и Прикреплять ссылки в этом канале; без них ничего не происходит.
Функции каналов (/saba assign)
Если выполнить /saba assign kind:<тип> в канале, этот канал становится каналом соответствующей функции. Повторный запуск с тем же типом в том же канале снимает назначение (выбрать тип можно и на вкладке Управление сервером → Назначения Saba-chan сервера Discord в приложении). Оповещения, игровой чат и панель состояния назначаются только на сервере с подключённым ПК. У канала может быть только один тип.
| Тип | Каналов | Что делает |
|---|---|---|
Говорящая Saba-chan | Несколько (до 20) | Saba-chan понимает сообщения в этом канале с помощью ИИ и отвечает; Говорящая Saba-chan общается только в таких каналах |
Поющая Saba-chan | Один | Музыкальные команды вводятся без префикса. Обычные сообщения удаляются, поэтому используйте канал только для музыки (см. Канал Поющей Saba-chan ниже) |
Оповещения | Один | Сообщает о сбоях сервера и неожиданных запусках, обновлениях, результатах бэкапов и предупреждениях о плановых перезапусках. К оповещению о сбое добавляется кнопка Перезапустить |
Игровой чат | Один | Пересылает в этот канал чат внутри игрового сервера. Приходит чат только тех серверов, у которых включена пересылка чата; отправляется отдельно от канала оповещений |
Status board | Один | Держит по одной карточке на каждый запущенный сервер и обновляет её при каждой смене состояния |
Панель состояния (Status board) держит по одной карточке на каждый запущенный сервер. На карточке видны баннер игры (только у игр с баннером), имя сервера, индикатор «запущен», число игроков и время работы; если ПК несколько, добавляется имя ПК. Показываются только серверы, открытые для этого сервера Discord (вкладка Экземпляры в приложении); когда сервер останавливается или ПК уходит в офлайн, карточка удаляется. Если запущенных серверов нет, остаётся одна карточка «Нет открытых серверов». Название запущенной игры показывается также в теме канала (для голосового канала — в статусе канала), если у бота есть право управлять каналом. Карточками в канале панели состояния управляет бот, поэтому используйте его только для этого. При перезапуске бота он удаляет свои сообщения в этом канале и публикует карточки заново.
Команды моего аккаунта (/mysaba …)
Если установить Saba-chan в свой аккаунт Discord (к ответу об успешном подключении прилагается кнопка со ссылкой на установку), команды работают на любом сервере и в любом ЛС. Они относятся к вашему ПК, поэтому не вынесены в серверную /saba, а ответ виден только вам.
| Команда | Действие |
|---|---|
/mysaba web | Ссылка на Saba-chan веб (5 минут, одноразовая). То же, что /saba web |
/mysaba my-pcs | Список ПК, привязанных к вашему аккаунту. Переименование и удаление |
/mysaba agent | Просмотр и отключение ИИ-агентов, подключённых к вашему аккаунту |
В ЛС с ботом Saba-chan используются /saba status, connect, web, my-pcs, agent и help (с тем же действием).
Поющая Saba-chan /music
/music content:<название или ссылка на трек, либо действие>. Есть на серверах, где включена Поющая Saba-chan. Подробности — ниже, в разделе Команды Поющей Saba-chan.
Статистика игроков /stats
/stats game:<игра> name:<ник> [platform:<сервер или платформа>]. Находит статистику и показывает сводную карточку; на серверах с включённой Говорящей Saba-chan добавляет короткий комментарий. В полях игры и платформы при вводе букв появляются подходящие варианты (недавно использованные игры — первыми).
- Поддерживаемые игры: League of Legends, Teamfight Tactics (TFT), PUBG: BATTLEGROUNDS, MapleStory, Lost Ark, EA SPORTS FC Online, Sudden Attack, KartRider Rush+, Clash Royale, Clash of Clans, Brawl Stars, Fortnite, Apex Legends, Eternal Return, Overwatch 2, Dota 2, Genshin Impact, Roblox. Игру можно найти и по псевдониму (например,
롤для League of Legends). - Формат поля
nameзависит от игры: для League of Legends и TFT —Имя#Тег, для Overwatch — BattleTag, для Genshin Impact — UID, для игр Supercell —#Тег. - Для League of Legends и TFT перед
nameможно указать сервер:KR Имя#Тег,[kr] Имя#Тег,kr:Имя#Тег. Если не указать, выбирается сервер, подходящий вашему языку Discord. - Если на сервере включён параметр Результаты поиска видны только мне, ответ видит только тот, кто вызвал команду.
Читающая Saba-chan /tts
Зайдите в голосовой канал и отправьте /tts в канале, где собираетесь писать: Saba-chan будет читать ваши сообщения из этого канала в вашем голосовом канале. Повторная отправка выключает чтение, оно выключается и когда вы выходите из голосового канала. Заполнять ничего не нужно.
- Если включить её в канале игрового чата, она читает и игровой чат, приходящий в этот канал.
- Прочитанные сообщения удаляются (если у бота есть право управлять сообщениями). Сообщение, начинающееся с префикса, читается, только если оно не является командой.
- Читается не более 100 символов в сообщении, а на одного человека — не более 500 символов в минуту и 15000 символов в час. Сообщения сверх лимита остаются в канале, и вас уведомляют об этом так, что видите только вы.
- Громкость, скорость, высоту голоса и добавление «Имя, » перед текстом настраивают командой
/saba readingили на вкладке Читающая Saba-chan сервера Discord в приложении.
Управление сервером Discord: /clear /autoclear /mute /lock /slowmode
Эти команды доступны тем, у кого есть соответствующие права Discord, или тем, чей уровень Saba-chan не ниже администратора на сервере с подключённым ПК. Такие же права должны быть у бота. То же самое можно делать на вкладке Управление сервером сервера Discord в приложении.
| Команда | Нужные права | Действие |
|---|---|---|
/clear [count] [member] [period] | Управление сообщениями | Удаляет сообщения этого канала, начиная с последних (если count не указан — до 1000). member удаляет только сообщения этого человека, period (последние 10 минут – 7 дней) — только сообщения за этот период. Закреплённые сообщения и панели Saba-chan (плеер, карточки панели состояния, объявления) остаются. Сообщения старше 14 дней удаляются не более 50 за раз. Результат виден только вам |
/autoclear keep:<период> | Управление сообщениями | Каждые 15 минут удаляет в этом канале сообщения, старше срока хранения (1 час, 6 часов, 12 часов, 1 день, 3 дня, 7 дней). Выключить отключает |
/mute member:<участник> duration:<период> [reason] | Тайм-аут участников | Тайм-аутом Discord запрещает участнику писать, ставить реакции и говорить в голосовом канале. Срок — от 10 минут до 28 дней, а также Навсегда; Снять отменяет. Если участник в голосовом канале, его отключают от него. Причина записывается в журнал аудита |
/lock [duration] | Управление каналами | Запрещает @everyone писать в этом канале. Если срок (10 минут – 1 день) не указан, замок действует до снятия; Снять отменяет. Роли с отдельным разрешением и администраторы продолжают писать |
/slowmode interval:<интервал> | Управление каналами | Меняет медленный режим канала (от 5 секунд до 6 часов). Выключить отключает |
Заглушить можно и текстовой командой с префиксом: Saba-chan mute @участник 1 hour, Saba-chan mute forever (ответом на сообщение этого человека), Saba-chan unmute.
Только для операторов Saba-chan /operator
Команда только для операторов ретранслятора (page, block, unblock, list). Обычным пользователям она не видна.
Команды Поющей Saba-chan
Поющая Saba-chan (музыка) — функция облачного бота. Воспроизведением звука занимается официальный музыкальный сервер рядом с сервером-ретранслятором, а не ваш ПК, поэтому музыка работает даже при выключенном ПК. По умолчанию она включена; выключить её можно на вкладке Поющая Saba-chan сервера Discord в приложении.
Псевдонимы модуля: music и dj работают на любом языке; на серверах Discord, где язык бота — корейский, работают также 음악, ㄴㄹ и ㅇㅇ.
Saba-chan music <command> [args]
Saba-chan dj <command> [args]
Есть и несколько удобных сокращений:
Saba-chan <ссылка>: сразу воспроизводит, модуль указывать не нужно. Ссылки на треки YouTube и SoundCloud воспроизводятся как есть, а ссылки на треки, альбомы и плейлисты Spotify и Apple Music — через поиск того же трека на YouTube по названию и исполнителю (из списка берутся первые 100 треков, каждый ищется при воспроизведении). Плейлисты SoundCloud (/sets/) пока не поддерживаются.- Если первое слово — команда Поющей Saba-chan, имя модуля можно опустить:
Saba-chan play lofi,Saba-chan skip,Saba-chan pause. Исключения —help,도움иlist, которые уходят в глобальные команды, поэтому для справки по музыке используйтеSaba-chan music help. - Если после модуля идёт не команда, как в
Saba-chan music <поисковый запрос>, это считается поиском, и найденное воспроизводится.
Слэш-команда /music content:<название или ссылка на трек, либо действие>: есть только на серверах, где включена Поющая Saba-chan. Если введённый текст — команда Поющей Saba-chan (stop, volume 50 …), выполняется это действие, иначе по тексту сразу запускается воспроизведение. Если поле пустое, в списке появляются действия, доступные при текущем состоянии воспроизведения (пауза, продолжить, следующий, стоп …), а если вводить буквы, после подходящих действий появляются варианты «воспроизвести сразу» и «найти и выбрать».
Полный список команд (английские / корейские псевдонимы). Корейские псевдонимы распознаются только на серверах Discord, где язык бота — корейский.
| Английская | Универсальные псевдонимы | Корейские псевдонимы | Описание |
|---|---|---|---|
play | p | 재생, ㅈㅅ | Сразу воспроизводит первый результат поиска или ссылку |
search | find | 검색, ㄱㅅ | Выбрать из 5 результатов поиска для добавления |
pause | Нет | 일시정지, ㅇㅅㅈㅈ | Пауза |
resume | Нет | 계속, ㄱㅅㄱ | Продолжить |
skip | s, next | 다음, ㄷㅇ | Следующий трек |
previous | prev, back | 이전 | Предыдущий трек |
stop | leave, disconnect, dc | 정지, ㅈㅈ | Остановить и выйти из голосового канала |
queue | q, list | 대기열, ㄷㄱㅇ | Показать очередь |
np | nowplaying, now | 지금, ㅈㄱ | Что играет сейчас |
volume [0~200 | +n | -n] | vol, v | 볼륨, ㅂㄹ | Показать или изменить громкость (работают и относительные значения вроде +10/-10) |
shuffle | random | 섞기, ㅅㄱ | Перемешать очередь |
loop | repeat | 반복, ㅂㅂ | Включить повтор (выключить — loopoff) |
loopoff | unloop | 반복해제, ㅂㅂㅎㅈ | Выключить повтор |
radio | autoplay | 라디오, ㄹㄷㅇ | Автоматически пополнять очередь рекомендациями |
normalize | norm, loudnorm | 정규화, 볼륨평탄화, ㅈㄱㅎ | Переключить выравнивание громкости между треками |
help | Нет | 도움, ㄷㅇ말 | Справка по музыке |
Примеры:
Saba-chan music play lofi hip hop
Saba-chan dj search ado 우주미아
Saba-chan music volume 50
Saba-chan skip
Saba-chan https://youtu.be/xxxxx
Канал Поющей Saba-chan
Если выполнить в канале /saba assign kind:Поющая Saba-chan (или выбрать его на вкладке Управление сервером → Назначения Saba-chan сервера Discord в приложении), этот канал становится каналом Поющей Saba-chan. В нём сообщения сразу трактуются как команды Поющей Saba-chan, префикс не нужен. Всё, что не является командой, считается поисковым запросом и воспроизводится.
play lofi
skip
stop
https://youtu.be/xxxxx
В канале Поющей Saba-chan бот показывает экран плеера с текущим треком и очередью (выключается на вкладке Поющая Saba-chan в приложении). Обычные сообщения в этом канале удаляются, поэтому выбирайте канал, который используется только для музыки.
Чтобы воспроизвести трек или выбрать его из результатов поиска, отправитель команды должен уже находиться в голосовом канале.
Пасхалки
У бота есть несколько скрытых однострочных реакций, которые появляются, если после префикса ввести определённое слово. Они работают даже при выключенном ПК. Здесь мы их не раскрываем, потому что половина удовольствия в том, чтобы найти их самому.
Быстрый чек-лист, если команды не работают
| Симптом | Что проверить в первую очередь |
|---|---|
| Бот молчит | Проверьте префикс (по умолчанию Saba-chan + пробел). Сопряжение должно быть завершено, Передача команд в приложении — включена, а бот не должен спать (/saba sleep). |
| Ответ «сервер не найден» | Порядок — <server> <command>. Если у вас несколько серверов одной игры, используйте имя экземпляра или псевдоним сервера. |
| Ответ «нет прав» | Ваш уровень ниже уровня, нужного для этой команды. Попросите владельца узла выдать уровень командой /saba permission. |
| Команды Поющей Saba-chan не отвечают | Включена ли Поющая Saba-chan на этом сервере Discord? Находитесь ли вы в голосовом канале? Не используете ли вы псевдонимы на языке, отличном от языка бота? |
| Вы добавили псевдоним, но он не срабатывает | Проверьте, что вы сохранили его в приложении и что он не пересекается с псевдонимом другого модуля. |
| Команды заблокированы только на одном сервере Discord | Возможно, экземпляра нет среди разрешённых для этого сервера (вкладка Экземпляры). |
Более глубокая диагностика — в разделе Устранение неполадок, а настройка самого бота — в Discord-бот и облачный ретранслятор.