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)

Saba-chan
ServidoresDiscordConfigurações
DaemonBot desligado
ConexãoNão conectado
Servidores do Discord
Geral
Conectar ao DiscordGere um código e digite-o no seu servidor do Discord. Depois de conectar, você pode iniciar e parar servidores de jogo por esse servidor através do bot.
Conectar um servidor do DiscordConvidar o bot
#geralNosso servidor
kimchi12:00
Bot convidado!
Conversar em #geral
  1. Na tela Discord do app, abra Conexão e clique em Conectar um servidor do Discord.
  2. Se o bot do Saba-chan ainda não estiver no seu servidor do Discord, convide-o antes com Convidar o bot.
  3. Quando aparecerem o código e o comando a digitar (/saba connect code:…), clique em Copiar.
  4. Cole num canal do Discord e envie. Só quem tem a permissão Gerenciar servidor naquele servidor do Discord pode usar esse comando.
  5. 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.
  6. 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.
  7. 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.

Saba-chan
ServidoresDiscordConfigurações
DaemonBot online
ConexãoConectado
Servidores do Discord
GNosso servidor
Geral
Nosso servidor
InstânciasMembrosComandosPalavrasCanaisConfigurações do bot
Instâncias que este servidor do Discord pode usar
Todas as instâncias
Novas instâncias aparecem na hora
Só as que eu escolher
Só as instâncias que você ativar ficam visíveis no Discord

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ívelQuem
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íveis você 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.

ItemEtapas disponíveisValor inicial
Pedido direto ao bot (comandos com prefixo e de barra)Todos os comandos · Cuidado ou acima · Só comandos perigosos · Nunca perguntarSó comandos perigosos
Saba-chan falanteTodos os comandos · Cuidado ou acima · Só comandos perigosos · Nunca perguntarTodos 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

#geralNosso servidor

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ê querO que enviar
Lista de servidores e statusSaba-chan list
Iniciar / parar / statusSaba-chan mc start · Saba-chan mc stop · Saba-chan mc status
Ver a ajudaSaba-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.