3. Discord
Conecte o bot oficial do Saba-chan e escolha os servidores e as permissões de comando de cada servidor do Discord.
3. Discord
O bot do Saba-chan no Discord é um bot oficial que roda na nuvem do Saba-chan. Você não precisa criar um bot nem cuidar de token, nem usar encaminhamento de portas (uma configuração do roteador que repassa conexões de fora para o seu PC). O Saba-chan do seu PC se conecta à nuvem e busca lá os comandos do Discord.
A configuração tem três passos: conectar o bot (pareamento), escolher quais servidores cada servidor do Discord pode usar e definir quem pode usar quais comandos.
Passo 1: conectar o bot (pareamento)
- Na tela Discord do app, abra Conexão e clique em
Conectar um servidor do Discord. - Se o bot do Saba-chan ainda não estiver no seu servidor do Discord, convide-o antes com
Convidar o bot. - Quando aparecerem o código e o comando a digitar (
/saba connect code:…), clique emCopiar. - Cole num canal do Discord e envie. Só quem tem a permissão Gerenciar servidor naquele servidor do Discord pode usar esse comando.
- Se for a primeira vez dessa conta do Discord no Saba-chan, o bot orienta o cadastro antes. Clique em
Cadastrar, confira os termos no site e cadastre-se, e essa resposta vira a confirmação da conexão. O código espera durante esse tempo. - Quando o bot perguntar se deve conectar, clique em
Conectar. Só clique se o código foi obtido por você mesmo no aplicativo Saba-chan. Se foi um código dado por outra pessoa, o PC dela será conectado à sua conta. - O bot avisa que a conexão terminou e o app muda para
Conectado.
Um código vale por 5 minutos. Depois disso, clique em Gerar novo código. Se a sua conta do Discord já foi conectada, você pode conectar outro servidor do Discord sem código: enviando lá só /saba connect, todos os PCs da sua conta passam de imediato a esse servidor do Discord. Isso também exige a permissão Gerenciar servidor nesse servidor do Discord, e, como no início nenhum servidor de jogo aparece num servidor do Discord conectado assim, escolha no app quais servidores abrir (passo 2 abaixo). Um servidor do Discord conectado com um código segue a opção Abrir meus servidores de imediato em novos servidores do Discord, na tela Discord → Conexão do app.
Você pode conectar vários PCs a uma conta do Discord. Se enviar um código novo de uma conta que já tem um PC, o bot mostra os botões Conectar como PC novo e Reconectar <nome do PC>. Escolha Conectar como PC novo para um PC que você está conectando pela primeira vez, ou escolha o PC se estiver reconectando um que já conectou antes (a conexão antiga dele para de valer). Veja seus PCs, renomeie ou remova com /mysaba my-pcs.
Um servidor do Discord também pode ter vários PCs. Quando um amigo conecta o próprio PC ao mesmo servidor do Discord, os servidores dos dois PCs aparecem juntos, e cada comando vai para o PC que tem aquele servidor. Se os nomes de servidor coincidirem, o servidor do PC que entrou depois ganha -nomeDoPC no fim do nome. Configurações comuns, como idioma, prefixo, Saba-chan cantora e atribuição de canais, são alteradas pelo dono do primeiro PC conectado e pelo dono do servidor do Discord. Os servidores e permissões de cada PC são definidos pelo dono daquele PC.
Passo 2: escolher os servidores de cada servidor do Discord
Os servidores do Discord conectados aparecem em Discord → Servidores do Discord. Escolha um e as abas dele abrem.
Na aba Instâncias você define quais servidores de jogo este servidor do Discord pode usar. Uma instância é um servidor de jogo registrado no Saba-chan.
- Todas as instâncias: todos os servidores, atuais e futuros, ficam visíveis.
- Só as que eu escolher: só os servidores que você ativar ficam visíveis e utilizáveis neste servidor do Discord. Serve para dar servidores diferentes a grupos de amigos diferentes.
Um servidor não liberado não aparece em lugar nenhum daquele servidor do Discord: nem em comandos, nem em listas, nem em comandos de barra.
Passo 3: definir as permissões de comando
São cinco níveis de permissão. Os níveis são cumulativos: cada nível usa todos os comandos que os níveis abaixo dele podem usar.
| Nível | Quem |
|---|---|
| Dono (3) | Quem conectou este servidor do Discord. Pode usar todos os comandos e não pode ser rebaixado |
| Admin (2) | Pessoas a quem você confia até comandos perigosos |
| Usuário (1) | Pessoas que podem ligar e desligar servidores. No início, é o nível padrão de todos os membros |
| Convidado (0) | Pessoas que só podem usar comandos seguros, como ver o status |
| Banido (-1) | Não pode usar nenhum recurso do bot, incluindo a Saba-chan cantora e a Saba-chan falante |
As permissões abrem ao clicar num servidor (instância) na aba Instâncias. Com Permissões de todas as instâncias você vê todos os servidores de uma vez. Há duas telas.
- Comandos por nível: uma escada em que os comandos são chips. Cada chip fica no menor nível que pode usar aquele comando. Arraste o chip para outro degrau, ou toque nele, para mudar o nível exigido. A predefinição de comandos no alto (Flexível, Padrão, Rígido) posiciona os comandos de uma vez conforme o risco (Seguro, Cuidado, Perigo). A predefinição padrão é Seguro = Convidado, Cuidado = Usuário, Perigo = Admin. Ao trocar de predefinição, até os chips que você havia movido voltam à posição da predefinição. O Limite da Saba-chan falante, na parte de baixo, é o nível que os pedidos que passam pela Saba-chan falante não podem ultrapassar (Convidado no início).
- Níveis por membro: defina o nível padrão (o que quem não tem nível próprio segue) e dê um nível a cada membro. Em
Editar níveisvocê pode renomear os níveis, acrescentar degraus e mudar a ordem.
Os níveis dos membros e a predefinição valem para todos os servidores desse servidor do Discord. Mover um comando geral do servidor (que não pertence a um servidor específico) muda a tela de permissões de todos os servidores. Ajuda e lista podem ser usadas por qualquer pessoa que não esteja banida.
- Na janela aberta ao clicar num chip, também dá para mudar, por comando, o nível de confirmação no Discord (Seguro, Cuidado, Perigo). Esse nível só é usado para comparar com a configuração de confirmação abaixo, e não muda o nível exigido nem a confirmação do app e da CLI.
- No Discord, o dono também pode mudar os níveis dos membros e o nível padrão com
/saba permission. Com um usuário escolhido, é o nível desse membro (escolher Remover na lista de níveis o devolve ao nível padrão); sem usuário, é o nível padrão. A predefinição, o Limite da Saba-chan falante e os níveis por comando só mudam no app.
Confirmar de novo antes de executar
Se o bot pede um botão de confirmação antes de executar um comando pedido pelo Discord, isso é definido no cartão Confirmação, na aba Configurações do bot do servidor do Discord. Só quem pediu pode clicar no botão.
| Item | Etapas disponíveis | Valor inicial |
|---|---|---|
| Pedido direto ao bot (comandos com prefixo e de barra) | Todos os comandos · Cuidado ou acima · Só comandos perigosos · Nunca perguntar | Só comandos perigosos |
| Saba-chan falante | Todos os comandos · Cuidado ou acima · Só comandos perigosos · Nunca perguntar | Todos os comandos |
- Ações de administração escolhidas pela Saba-chan falante e pedidos com várias pessoas misturadas sempre pedem confirmação, seja qual for essa configuração.
- O app, o web e a CLI sempre pedem confirmação para comandos perigosos, parar e reiniciar, seja qual for essa configuração.
- Na CLI, veja e mude com
saba-chan-cli bot confirm.
Testando no Discord
Os comandos por mensagem seguem prefixo servidor comando. O prefixo é a palavra que inicia um comando. O prefixo padrão de um servidor do Discord em que o bot responde em português é Saba-chan; você pode mudá-lo ou adicionar outros, para cada servidor do Discord, na aba Configurações do bot, em Prefixo dos comandos.
| O que você quer | O que enviar |
|---|---|
| Lista de servidores e status | Saba-chan list |
| Iniciar / parar / status | Saba-chan mc start · Saba-chan mc stop · Saba-chan mc status |
| Ver a ajuda | Saba-chan help |
Para chamar um servidor, use o nome dele, uma palavra de chamada definida na aba Discord da tela do servidor e, quando for o único servidor daquele jogo, o nome do jogo (por exemplo mc ou minecraft). Se você tiver vários servidores do mesmo jogo, chame-os pelo nome ou pela palavra definida para cada um. Comandos perigosos não rodam pelo nome do jogo, então use o nome do servidor ou uma palavra definida. Cada servidor também ganha seu próprio comando de barra /nome-do-servidor.
Na mesma aba Configurações do bot, em Comandos de barra, você escolhe se os comandos levam saba na frente, como /saba status (desligado, aparecem direto, como /status), se o nome do comando do servidor é o nome do servidor ou a primeira palavra de chamada, e se o resultado de consultas aparece só para quem pediu.
Para mexer em mais coisas com botões pelo celular, abra o Saba-chan web com /saba web.