Comandos
A lista completa de comandos de servidores de jogo e comandos próprios do Saba-chan (incluindo os comandos de barra), além de como cadastrar apelidos como atalhos pessoais.
Comandos de servidores de jogo
Sintaxe básica
Saba-chan <server> <command> [args…]
- O prefixo padrão é
Saba-chan. Você pode mudá-lo para cada servidor do Discord no aplicativo, em servidor do Discord → aba Configurações do bot, em Prefixo dos comandos. O padrão segue o idioma do bot desse servidor do Discord (se não definido, o idioma do app no PC) (coreano사바쨩, japonêsサバちゃん, nos demaisSaba-chan). - O prefixo precisa ser seguido de um espaço. Algo como
Saba-chanxnão é reconhecido como comando. <server>é um nome de instância, uma palavra de chamada do servidor, ou um nome ou apelido de módulo. O bot os procura na ordem nome da instância → palavra de chamada do servidor → apelido de módulo. Exemplos:minecraft,mc,마크, …- Se você roda vários servidores do mesmo jogo, um apelido de módulo não consegue apontar para um só, então use o nome da instância ou uma palavra de chamada do servidor.
<command>é uma ação definida por módulo. Exemplos:start,시작,say,말, …- Alguns comandos funcionam sem servidor (comandos globais). Veja Comandos globais abaixo.
Maiúsculas e minúsculas são ignoradas.
START,Startestartsão a mesma coisa.
O bot interpreta uma mensagem nesta ordem:
- Verifica o prefixo + espaço.
- Confere primeiro os easter eggs e os comandos da Saba-chan cantora (tratados diretamente no relay).
- Envia todo o resto ao Saba-chan no seu PC. Ele confere primeiro os comandos globais (
help,list); caso contrário, trata a mensagem como<server> <command>. - Se o Saba-chan não reconhecer a entrada e a Saba-chan falante estiver ligada neste servidor, ela a transforma em um comando exato e tenta mais uma vez.
Os mesmos comandos também estão disponíveis como comando de barra,
/<nome do servidor>. No campocommand, escolha um dos comandos que podem ser usados nesse servidor e preencha os campos de argumento que aparecem em seguida. O Discord mostra os comandos e os candidatos de argumento que o seu nível permite.
Comandos globais
Comandos que você pode digitar sem indicar um servidor. Qualquer pessoa que não esteja banida pode usá-los.
| Comando | Ação |
|---|---|
Saba-chan help / Saba-chan 도움 / Saba-chan 도움말 | Mostra o uso e os módulos e apelidos disponíveis neste servidor do Discord |
Saba-chan list / Saba-chan 목록 | Lista os servidores que o bot pode controlar, com status |
Saba-chan <server> | Mostra os comandos disponíveis para aquele servidor |
Você pode restringir quais instâncias ficam visíveis por servidor do Discord (nó). Em um servidor restrito, até o
listmostra apenas as instâncias permitidas. Configure isso no aplicativo, em Discord → Servidores do Discord → aba Instâncias.
Comandos comuns a todos os módulos
Três comandos que o Saba-chan trata por padrão, independentemente do tipo de módulo.
| Inglês | Ação | Apelidos coreanos (incluídos) |
|---|---|---|
start | Inicia o servidor | 시작, 실행, 켜기 |
stop | Para o servidor | 정지, 끝내기, 끄기 |
status | Estado atual | 상태, 상황, 확인 |
Exemplos:
Saba-chan minecraft start
Saba-chan 마크 시작
Saba-chan palworld stop
Saba-chan 팰월드 상태
Comandos por módulo (comandos do console do jogo)
Cada módulo de jogo define seus próprios comandos em [[commands.fields]] no module.toml e lhes dá apelidos em [aliases.commands]. Esses comandos passam pelo Saba-chan no seu PC até o console do servidor de jogo (stdin); o Palworld usa a REST API dele.
O risco de um comando decide o nível de que ele precisa (predefinição padrão: Seguro = Convidado, Cuidado = Usuário, Perigo = Admin). Se um botão de confirmação aparece antes da execução depende da configuração de confirmação do servidor do Discord (no início, só os comandos perigosos; Bot do Discord §5).
Abaixo estão os comandos dos quatro jogos oficiais. Os apelidos coreanos são padrões que vêm nos pacotes de módulo; os usuários podem adicionar mais (veja Criando seus próprios atalhos).
Minecraft (apelidos de módulo: 마인크래프트, 마크, mc, minecraft)
| Comando | Apelidos coreanos | Descrição | Risco |
|---|---|---|---|
say | 말, 채팅, 메시지 | Mensagem para todo o servidor | Seguro |
give | 지급, 줘, item | Dar um item | Perigo |
save-all | 저장 | Salvar o mundo | Seguro |
save-flush | Nenhum | Gravar no disco | Seguro |
save-off | Nenhum | Desligar o salvamento automático | Cuidado |
save-on | Nenhum | Ligar o salvamento automático | Seguro |
list | Nenhum | Listar jogadores conectados | Seguro |
weather | 날씨, 웨더 | Mudar o clima | Perigo |
difficulty | 난이도, 어려움 | Mudar a dificuldade | Perigo |
gamemode | 겜모드, 게임모드 | Mudar o modo de jogo | Perigo |
time | 시간 | Definir o horário | Perigo |
tp | 텔레포트, 이동 | Teletransportar | Perigo |
kick | 킥, 추방 | Expulsar um jogador | Perigo |
ban | 밴, 차단 | Banir um jogador | Perigo |
pardon | 언밴, 해제 | Desbanir | Perigo |
op | 오피 | Dar privilégios de operador | Perigo |
deop | 디옵 | Remover privilégios de operador | Perigo |
whitelist | 화이트리스트, 화리 | Gerenciar a whitelist | Perigo |
seed | Nenhum | Mostrar a seed do mundo | Seguro |
Exemplos:
Saba-chan 마크 say Hello!
Saba-chan minecraft give FriendName minecraft:diamond 64
Saba-chan mc tp FriendName 0 100 0
Palworld (apelidos de módulo: 팰월드, 팔월드, pw, palworld)
| Comando | Apelidos coreanos | Descrição | Risco |
|---|---|---|---|
announce | 공지, 공지사항, 알림 | Transmitir um aviso | Seguro |
info | 정보, 인포 | Informações do servidor | Seguro |
players | 플레이어, 접속자, 유저 | Lista de jogadores | Cuidado |
metrics | Nenhum | Métricas do servidor | Seguro |
settings | Nenhum | Ver as configurações do servidor | Seguro |
save | 저장 | Salvar o mundo | Seguro |
shutdown | 종료, 셧다운 | Desligar o servidor | Perigo |
kick | 킥, 강퇴, 추방 | Expulsar | Perigo |
ban | 밴, 차단, 영구밴 | Banir | Perigo |
unban | 언밴, 차단해제 | Desbanir | Perigo |
Exemplos:
Saba-chan 팰월드 공지 10분 뒤 저장합니다
Saba-chan pw players
Project Zomboid (apelidos de módulo: 좀보이드, 프로젝트 좀보이드, 프좀, pz, zomboid, project zomboid)
| Comando | Apelidos coreanos | Descrição | Risco |
|---|---|---|---|
servermsg | 공지, 공지사항, 알림, 메시지 | Mensagem do servidor | Seguro |
players | 플레이어, 접속자, 유저 | Jogadores | Seguro |
save | 저장, 세이브 | Salvar | Seguro |
kick | 킥, 강퇴, 추방 | Expulsar | Perigo |
banuser | 밴, 차단, 영구밴 | Banir | Perigo |
unbanuser | 언밴, 차단해제 | Desbanir | Perigo |
adduser | 유저추가, 계정추가 | Adicionar um usuário | Perigo |
setaccesslevel | Nenhum | Definir o nível de acesso | Perigo |
teleport | Nenhum | Teletransportar até um jogador | Cuidado |
teleportto | Nenhum | Teletransportar até coordenadas | Cuidado |
createhorde | Nenhum | Gerar uma horda | Perigo |
godmod | Nenhum | Modo deus | Perigo |
invisible | Nenhum | Invisibilidade | Perigo |
startrain | Nenhum | Iniciar a chuva | Cuidado |
stoprain | Nenhum | Parar a chuva | Cuidado |
chopper | Nenhum | Evento do helicóptero | Cuidado |
gunshot | Nenhum | Som de tiro | Cuidado |
additem | Nenhum | Dar um item | Perigo |
addxp | Nenhum | Dar XP | Perigo |
showoptions | Nenhum | Mostrar as opções do servidor | Seguro |
reloadoptions | Nenhum | Recarregar opções | Perigo |
changeoption | Nenhum | Alterar opções | Perigo |
quit | 종료, 셧다운 | Desligar | Perigo |
Terraria (apelidos de módulo: 테라리아, 테라, terraria)
| Comando | Apelidos coreanos | Descrição | Risco |
|---|---|---|---|
help | Nenhum | Ajuda | Seguro |
playing | 접속자, 플레이어, 목록 | Lista de jogadores | Seguro |
clear | Nenhum | Limpar o console | Seguro |
save | 저장 | Salvar o mundo | Seguro |
say | 말, 공지, 채팅 | Aviso | Seguro |
version | Nenhum | Versão | Seguro |
time | Nenhum | Hora do jogo | Seguro |
port | Nenhum | Porta | Seguro |
maxplayers | Nenhum | Máximo de jogadores | Seguro |
motd | Nenhum | Mensagem do dia | Seguro |
password | Nenhum | Ver a senha | Cuidado |
dawn | Nenhum | Amanhecer | Cuidado |
noon | Nenhum | Meio-dia | Cuidado |
dusk | Nenhum | Entardecer | Cuidado |
midnight | Nenhum | Meia-noite | Cuidado |
settle | Nenhum | Estabilizar a água | Cuidado |
seed | Nenhum | Mostrar a seed | Seguro |
kick | 킥, 추방 | Expulsar um jogador | Perigo |
ban | 밴, 차단 | Banir um jogador | Perigo |
exit-nosave | Nenhum | Desligar sem salvar | Perigo |
Módulos próprios funcionam do mesmo jeito. Se o desenvolvedor de um módulo registrar comandos no
module.tomlconforme o Guia de módulos, eles aparecem automaticamente na ajuda do bot, nos comandos de barra e nos apelidos.
Criando seus próprios atalhos
As palavras que chamam um servidor e seus comandos são definidas por servidor. Altere-as no aplicativo, na tela do servidor → aba Discord; ao salvar, valem na hora, sem reiniciar. As palavras de chamada pertencem ao servidor, então todos os servidores do Discord conectados o chamam pelas mesmas palavras.
Palavras que chamam o servidor
Acrescente palavras em Palavras que chamam o servidor. Mesmo sem definir nada, você chama o servidor pelo nome dele e, se for o único servidor desse jogo, também pelo nome do jogo (por exemplo, 마크) e pelos apelidos do módulo (na tela aparecem como Padrão:).
- Cada palavra tem de 1 a 32 caracteres sem espaços, até 10 por item.
- Se uma palavra coincidir com o nome ou ID de outro servidor, com palavras de chamada de outro servidor, com nome de módulo, nome de jogo ou apelido de módulo, ou com palavras reservadas como
help,도움말,liste목록, ela não é salva e a tela mostra o motivo.
Palavras que chamam um comando
Na mesma tela, acrescente palavras para cada comando. Elas vêm antes dos apelidos que já estão no módulo, e o nome original do comando sempre funciona. Os apelidos dos comandos da Saba-chan cantora não podem ser alterados aqui.
Quando há vários servidores do mesmo jogo
Com vários servidores do mesmo jogo, o nome do jogo não indica qual deles é, então é prático dar a cada servidor palavras de chamada diferentes.
Apelidos no nível do pacote (para desenvolvedores de módulos)
Para embutir apelidos coreanos padrão em um módulo que você criou, adicione o seguinte ao module.toml. Os apelidos só podem apontar para comandos definidos em [[commands.fields]] (ou para os embutidos start/stop/status).
[aliases]
module_aliases = ["내게임", "ig", "mygame"]
[aliases.commands]
start = { aliases = ["시작", "켜기"], description = "Start the server" }
custom_thing = { aliases = ["뭐시기", "그거"], description = "Do the thing" }
Mantenha cada apelido como uma única palavra, sem espaços. Os comandos de chat separam as palavras por espaços, então um apelido com espaço não pode ser usado. Para todos os detalhes de desenvolvimento de módulos, veja o Guia de desenvolvimento de módulos.
Permissões de instância por nó
Quando vários servidores do Discord (= nós do relay) se conectam ao mesmo Saba-chan, você pode restringir quais instâncias cada servidor do Discord pode controlar.
No aplicativo, em Discord → Servidores do Discord → aba Instâncias, escolha Só as que eu escolher. Isso é guardado em nodeSettings como uma lista de IDs de instância:
{
"relay": {
"nodeSettings": {
"<guildId>": {
"allowedInstances": ["<instance ID>", "<instance ID>"]
}
}
}
}
Em um servidor do Discord restrito, o comando list mostra apenas as instâncias permitidas, os comandos de barra só são criados para elas, e servidores fora da lista recebem a resposta de que não foram encontrados.
Comandos do Saba-chan
Comandos de barra do Saba-chan
São os comandos próprios do Saba-chan que aparecem quando você digita / no Discord. Para os comandos /<servidor> que controlam servidores de jogo, veja Comandos de servidores de jogo acima. Onde cada comando pode ser usado depende do estado de conexão do servidor.
Se você desligar o prefixo
sabanas configurações do servidor do Discord, os subcomandos de/saba …abaixo passam a aparecer direto na raiz, como/statuse/permission. Os comandos de gerenciamento do servidor continuam visíveis só para quem tem a permissão Gerenciar servidor. O formato é alterado por servidor do Discord, nas configurações do servidor do Discord no aplicativo (ou combot slashna CLI).
Em servidores conectados (/saba …)
| Comando | Quem | Ação |
|---|---|---|
/saba status | Qualquer pessoa | Status do PC conectado a este servidor |
/saba connect [code] | Permissão Gerenciar servidor | Conecta o PC com o código de pareamento obtido no aplicativo. Deixe o código vazio para conectar de imediato todos os PCs ligados a esta conta (os servidores a usar são escolhidos no aplicativo). Se for a primeira vez da conta, o cadastro vem antes |
/saba disconnect | Quem conectou ou dono do servidor | Desconecta este servidor do PC |
/saba permission <level> [user] | Quem conectou | Com um usuário, define o nível de comando dele; vazio, define o nível padrão do servidor. Ao escolher um usuário, também dá para escolher Remover |
/saba sleep | Quem conectou | Põe o Saba-chan para dormir neste servidor (ignora todas as mensagens) |
/saba wake | Quem conectou | Acorda o Saba-chan |
/saba assign kind | Quem conectou e dono do servidor | Define o canal atual como um de Saba-chan falante, Saba-chan cantora, Alertas, Chat do jogo ou Status board. Repetir num canal já atribuído remove a atribuição |
/saba language language | Quem conectou | Idioma em que o Saba-chan responde neste servidor (Automático = segue o idioma do app/servidor) |
/saba big-emoji state | Quem conectou e dono do servidor | Liga ou desliga a ampliação de emojis personalizados (desligado por padrão) |
/saba settings | Quem conectou | Configurações da Saba-chan falante deste servidor |
/saba reading | Quem conectou | Volume, velocidade e tom da Saba-chan leitora neste servidor, e a opção de chamar pelo nome |
/saba web | Qualquer pessoa | Link do Saba-chan web (5 minutos, uso único, só você vê) |
/saba update | Quem conectou | Atualiza o Saba-chan do PC conectado |
/saba help | Qualquer pessoa | Como usar e a lista de comandos disponíveis neste lugar |
sleep só aparece na lista com o bot acordado, e wake só com ele dormindo. Num servidor sem PC conectado, aparecem apenas connect, assign, language, settings, reading, web, big-emoji e help, e no lugar de "quem conectou" quem usa é o dono do servidor do Discord ou quem tem a permissão Gerenciar servidor (assign só para a Saba-chan falante e a Saba-chan cantora; veja Bot do Discord §2.5).
Menu de clique direito em membros: clique com o botão direito num membro do servidor → Apps → Change Saba-chan level para escolher o nível de comando dessa pessoa (só em servidores com PC conectado, e só para quem conectou).
Ampliação de emojis (/settings › Language & commands › Emoji upscale)
Quando ligado, uma mensagem que tem só um emoji personalizado, sem texto, é apagada pelo Saba-chan e republicada como uma imagem grande, com o nome e a foto de perfil de quem enviou. Se era uma resposta, a imagem também é publicada como resposta à mesma mensagem. Se forem enviados só dois emojis personalizados, eles saem juntos numa única imagem, sem espaço entre eles, na ordem em que foram enviados. Se um deles for animado, vira um GIF animado, e o mais curto se repete quando as durações diferem (máximo de 10 segundos). Emojis comuns (😀) e figurinhas ficam como estão. Como a mensagem original precisa ser apagada, o bot precisa das permissões Gerenciar mensagens e Anexar links nesse canal; sem elas, ele não faz nada.
Recursos de canal (/saba assign)
Ao digitar /saba assign kind:<tipo> num canal, esse canal passa a ser o canal desse recurso. Digitar o mesmo tipo de novo no mesmo canal remove a atribuição (também é possível escolher no aplicativo, em servidor do Discord → aba Gerenciar servidor, em Atribuição da Saba-chan). Alertas, chat do jogo e status board só podem ser atribuídos em servidores com PC conectado. Um canal só pode ter um tipo.
| Tipo | Canais | O que faz |
|---|---|---|
Saba-chan falante | Vários (até 20) | A Saba-chan entende o que se escreve nesse canal por IA e responde; a Saba-chan falante só conversa nesses canais |
Saba-chan cantora | Um | Comandos de música sem prefixo. Mensagens comuns são apagadas, então use um canal só de música (veja Canal da Saba-chan cantora abaixo) |
Alertas | Um | Avisa crash ou início inesperado do servidor, atualizações, resultado de backup e aviso de reinício agendado. Os alertas de crash têm um botão Reiniciar |
Chat do jogo | Um | Repassa para esse canal o chat de dentro do servidor de jogo. Só chega o chat dos servidores com o repasse ligado, e é enviado separado do canal de alertas |
Status board | Um | Mantém um cartão para cada servidor ligado e o atualiza a cada mudança de estado |
O status board tem um cartão para cada servidor ligado. O cartão mostra o banner do jogo (só nos jogos que têm), o nome do servidor, a indicação de ligado, o número de jogadores e o tempo ligado, e o nome do PC quando há vários. Só aparecem os servidores abertos para esse servidor do Discord (aba Instâncias do aplicativo); o cartão some quando o servidor desliga ou o PC fica offline. Se nenhum servidor estiver ligado, fica um único cartão "Nenhum servidor aberto". O tópico do canal (o status do canal, no caso de canais de voz) também mostra o jogo que está ligado agora (só se o bot tiver permissão de gerenciar canais). Como o bot administra os cartões, use um canal só para o status board. Quando o bot é reiniciado, ele apaga as mensagens dele nesse canal e publica os cartões de novo.
Comandos da sua conta (/mysaba …)
Depois de instalar o Saba-chan na sua conta do Discord (a resposta que conclui a conexão traz um botão com o link de instalação), você usa esses comandos em qualquer servidor e em qualquer DM. Como tratam do seu PC, não ficam no /saba do servidor, e a resposta aparece só para você.
| Comando | Ação |
|---|---|
/mysaba web | Link do Saba-chan web (5 minutos, uso único). O mesmo que /saba web |
/mysaba my-pcs | Lista os PCs conectados à sua conta. Renomear e remover |
/mysaba agent | Ver e desconectar os agentes de IA conectados à sua conta |
Na DM com o bot do Saba-chan, use /saba status, connect, web, my-pcs, agent e help (mesmo funcionamento).
Saba-chan cantora /music
/music query:<título ou link da faixa, ou uma ação>. Existe nos servidores em que a Saba-chan cantora está ligada. Para o uso detalhado, veja Comandos da Saba-chan cantora abaixo.
Estatísticas de jogos /stats
/stats game:<jogo> name:<apelido> [platform:<servidor ou plataforma>]. Busca as estatísticas, mostra um cartão-resumo e, em servidores com a Saba-chan falante ligada, ela acrescenta um comentário. Digitar nos campos de jogo e plataforma mostra os candidatos (os jogos usados recentemente vêm primeiro).
- Jogos suportados: League of Legends, Teamfight Tactics (TFT), PUBG: BATTLEGROUNDS, MapleStory, Lost Ark, FC Online, Sudden Attack, KartRider Rush+, Clash Royale, Clash of Clans, Brawl Stars, Fortnite, Apex Legends, Eternal Return, Overwatch 2, Dota 2, Genshin Impact e Roblox. Cada jogo também pode ser achado por apelidos (por exemplo,
롤). - O formato do campo
namevaria por jogo: LoL e TFT usamnome#tag, Overwatch usa a BattleTag, Genshin usa o UID e os jogos da Supercell usam#tag. - No LoL e no TFT, você pode pôr o servidor antes do
name:KR nome#tag,[kr] nome#tag,kr:nome#tag. Sem isso, é escolhido o servidor que combina com o seu idioma do Discord. - Se a opção Mostrar resultados de consulta só para mim do servidor estiver ligada, a resposta aparece só para quem chamou.
Saba-chan leitora /tts
Depois de entrar num canal de voz, envie /tts no canal de texto em que você vai escrever, e a Saba-chan lê no seu canal de voz o que você escrever nesse canal. Enviar de novo desliga, e sair do canal de voz também desliga. Não há campos a preencher.
- Se for ligado num canal de chat do jogo, ela também lê o chat de dentro do jogo que chega a esse canal.
- As mensagens lidas são apagadas (se o bot tiver permissão de gerenciar mensagens). Uma mensagem que começa com o prefixo só é lida quando não é um comando.
- Cada mensagem é lida até 100 caracteres, e cada pessoa tem até 500 caracteres por minuto e 15.000 por hora. O que passar do limite fica sem leitura, e só você é avisado.
- Volume, velocidade, tom e o "nome," falado antes de cada mensagem são definidos com
/saba readingou no aplicativo, em servidor do Discord → aba Saba-chan leitora.
Gerenciar o servidor do Discord /clear /autoclear /mute /lock /slowmode
Quem tem a permissão do Discord correspondente ao trabalho, ou, em servidores com PC conectado, quem tem nível de Saba-chan Admin ou superior, pode usar. O bot também precisa ter a mesma permissão. No aplicativo, a aba Gerenciar servidor do servidor do Discord faz as mesmas coisas.
| Comando | Permissão necessária | Ação |
|---|---|---|
/clear [count] [member] [period] | Gerenciar mensagens | Apaga as mensagens deste canal, das mais recentes para as mais antigas (sem count, até 1000). member apaga só as dessa pessoa, e period (de 10 minutos a 7 dias) só as desse período. Mensagens fixadas e painéis do Saba-chan (player, cartões do status board, avisos) ficam. Mensagens com mais de 14 dias são apagadas só até 50 por vez. O resultado aparece só para você |
/autoclear keep:<período> | Gerenciar mensagens | Apaga neste canal, a cada 15 minutos, as mensagens mais antigas que o período de retenção (1 hora, 6 horas, 12 horas, 1 dia, 3 dias, 7 dias). Desligue com Off |
/mute member:<membro> duration:<período> [reason] | Silenciar membros (timeout) | Com o timeout do Discord, impede mensagens, reações e voz do membro. O período vai de 10 minutos a 28 dias, além de Forever; Unmute libera. Se o membro estiver em um canal de voz, é removido dele. O motivo fica no registro de auditoria |
/lock [duration] | Gerenciar canais | Tranca este canal para @everyone não escrever. Sem período (10 minutos a 1 dia), vale até ser liberado; Unlock libera. Cargos com permissão própria e administradores continuam escrevendo |
/slowmode interval:<intervalo> | Gerenciar canais | Muda o modo lento deste canal (de 5 segundos a 6 horas). Desligue com Off |
O silenciamento também funciona por comando com prefixo: Saba-chan mute @membro 1h, Saba-chan mute forever (como resposta à mensagem da pessoa) e Saba-chan unmute.
Exclusivo do operador do Saba-chan /operator
Comando usado só pelo operador do Saba-chan (페이지, 차단, 해제, 목록). Não aparece para usuários comuns.
Comandos da Saba-chan cantora
A Saba-chan cantora (música) é um recurso do bot em nuvem. A reprodução de áudio é feita pelo servidor de música oficial ao lado do servidor de relay, não pelo seu PC, então funciona mesmo com o PC desligado. Ela vem ligada por padrão, e você pode desligá-la no aplicativo, em servidor do Discord → aba Saba-chan cantora.
Apelidos de módulo: music e dj funcionam em qualquer idioma; em servidores do Discord em que o idioma do bot é coreano, 음악, ㄴㄹ e ㅇㅇ também funcionam.
Saba-chan music <command> [args]
Saba-chan dj <command> [args]
Também há alguns atalhos práticos:
Saba-chan <link>: toca na hora, sem precisar de módulo. Links de faixas do YouTube e do SoundCloud tocam como estão; links de faixas, álbuns e playlists do Spotify e do Apple Music são procurados no YouTube pelo nome da faixa e do artista (da lista, as primeiras 100 faixas, procuradas uma a uma na hora de tocar). Playlists do SoundCloud (/sets/) ainda não são aceitas.- Se a primeira palavra for um comando da Saba-chan cantora, você pode omitir o nome do módulo, como em
Saba-chan play lofi,Saba-chan skip,Saba-chan pause. As exceções sãohelp,도움elist, que vão para os comandos globais, então useSaba-chan music helppara a ajuda da Saba-chan cantora. - Se depois do módulo vier algo que não é um comando, como em
Saba-chan music <termos de busca>, isso é tratado como uma busca e tocado.
Comando de barra /music query:<título ou link da faixa, ou uma ação>: existe só nos servidores em que a Saba-chan cantora está ligada. Se o texto digitado for um comando da Saba-chan cantora (stop, volume 50 …), ele executa essa ação; senão, toca direto o que foi digitado. Com o campo vazio, aparece a lista de ações possíveis no estado atual de reprodução (pausar, retomar, próxima, parar …), e ao digitar aparecem as ações que combinam, seguidas de "tocar agora" e "buscar e escolher".
A lista completa de comandos (inglês / apelidos coreanos). Os apelidos coreanos só são reconhecidos em servidores do Discord em que o idioma do bot é coreano.
| Inglês | Apelidos universais | Apelidos coreanos | Descrição |
|---|---|---|---|
play | p | 재생, ㅈㅅ | Toca na hora o primeiro resultado da busca ou um link |
search | find | 검색, ㄱㅅ | Escolhe entre 5 resultados de busca para adicionar |
pause | Nenhum | 일시정지, ㅇㅅㅈㅈ | Pausa |
resume | Nenhum | 계속, ㄱㅅㄱ | Retoma |
skip | s, next | 다음, ㄷㅇ | Próxima faixa |
previous | prev, back | 이전 | Faixa anterior |
stop | leave, disconnect, dc | 정지, ㅈㅈ | Para e sai do canal de voz |
queue | q, list | 대기열, ㄷㄱㅇ | Mostra a fila |
np | nowplaying, now | 지금, ㅈㄱ | Tocando agora |
volume [0~200 | +n | -n] | vol, v | 볼륨, ㅂㄹ | Mostra ou ajusta o volume (valores relativos como +10/-10 também funcionam) |
shuffle | random | 섞기, ㅅㄱ | Embaralha a fila |
loop | repeat | 반복, ㅂㅂ | Ativa a repetição (para desativar, use loopoff) |
loopoff | unloop | 반복해제, ㅂㅂㅎㅈ | Desativa a repetição |
radio | autoplay | 라디오, ㄹㄷㅇ | Preenche automaticamente com recomendações |
normalize | norm, loudnorm | 정규화, 볼륨평탄화, ㅈㄱㅎ | Alterna a normalização de volume entre faixas |
help | Nenhum | 도움, ㄷㅇ말 | Ajuda da Saba-chan cantora |
Exemplos:
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
Canal da Saba-chan cantora
Quando alguém executa /saba assign kind:Saba-chan cantora num canal (ou o escolhe no aplicativo, em servidor do Discord → aba Gerenciar servidor, em Atribuição da Saba-chan), esse canal vira o canal da Saba-chan cantora. Nele, as mensagens são interpretadas diretamente como comandos da Saba-chan cantora, sem precisar de prefixo. Tudo o que não for um comando é tratado como uma busca e tocado.
play lofi
skip
stop
https://youtu.be/xxxxx
O bot mostra no canal da Saba-chan cantora uma tela de player com a faixa atual e a fila (desligue-a na aba Saba-chan cantora do aplicativo). Mensagens comuns nesse canal são apagadas, então escolha um canal usado só para música.
Para tocar uma faixa ou escolher uma entre os resultados da busca, quem envia o comando precisa já estar em um canal de voz.
Easter eggs
O bot tem algumas reações ocultas de uma linha que aparecem quando você digita uma determinada palavra única depois do prefixo. Elas funcionam mesmo com o PC desligado. Não vamos dar spoiler aqui, porque metade da graça é descobri-las sozinho.
Checklist rápido quando os comandos não funcionam
| Sintoma | O que verificar primeiro |
|---|---|
| O bot fica em silêncio | Confira o prefixo (padrão Saba-chan + espaço). O pareamento precisa estar concluído, a Retransmissão de comandos precisa estar ligada no aplicativo e o bot não pode estar dormindo (/saba sleep). |
| Resposta "servidor não encontrado" | A ordem é <server> <command>. Se você roda vários servidores do mesmo jogo, use o nome da instância ou uma palavra de chamada do servidor. |
| Resposta "sem permissão" | Seu nível é baixo demais para o risco daquele comando. Peça ao dono do nó que use /saba permission para lhe dar um nível. |
| Os comandos da Saba-chan cantora não respondem | A Saba-chan cantora está ligada neste servidor do Discord? Você está em um canal de voz? Você está usando apelidos de um idioma diferente do idioma do bot? |
| Você adicionou um apelido e ele não dispara | Confira se você o salvou no aplicativo e se ele não se sobrepõe ao apelido de outro módulo. |
| Comandos bloqueados em apenas um servidor do Discord | A instância pode estar fora das instâncias permitidas daquele servidor (aba Instâncias). |
Para diagnósticos mais profundos, veja Solução de problemas e, para a configuração do próprio bot, veja Bot do Discord e relay em nuvem.