Configurando o Red Discord Bot

Este guia irá guiá-lo pela configuração do Red Discord Bot no ServerPrism, desde a criação do bot no portal de desenvolvedores do Discord até à reivindicação de proprietário e carregamento dos seus primeiros cogs.

Antes de começar

Precisará de uma conta Discord e de um servidor onde tenha a permissão Gerir Servidor.

1. Crie o seu bot no Discord Developer Portal

1. Vá a discord.com/developers/applications e clique em Nova Aplicação.
2. Dê-lhe um nome (esta é a identidade do seu bot — escolha algo com que esteja satisfeito), aceite os termos e clique em Criar.
3. Na barra lateral esquerda, clique em Bot.
4. Por baixo do nome de utilizador do bot, clique em Redefinir Token e copie o token para um local seguro. Irá colá-lo no ServerPrism dentro de momentos. Trate isto como uma palavra-passe — qualquer pessoa com ele pode controlar o seu bot.

2. Ativar Privileged Gateway Intents

Este passo é crítico — o Red recusar-se-á a iniciar sem que todas as três intents estejam ativadas, saindo com CONFIGURATION_ERROR (código de saída 78).

Ainda na página Bot, desça até Privileged Gateway Intents e ative:

• Presence Intent
• Server Members Intent
• Message Content Intent

Clique em Guardar Alterações na parte inferior.

3. Convide o bot para o seu servidor Discord

1. Na barra lateral esquerda, clique em OAuth2 → Gerador de URL.
2. Em Scopes, marque bot e applications.commands.
3. Em Permissões do Bot, marque as permissões que deseja que ele tenha. Para a maioria das configurações, Administrador é o ponto de partida mais fácil — pode restringir mais tarde.
4. Copie o URL gerado na parte inferior, abra-o numa nova aba, escolha o seu servidor Discord e autorize.

O bot irá juntar-se ao seu servidor, mas aparecerá como offline até que o inicie no ServerPrism.

4. Encomende o Red Discord Bot no ServerPrism

1. Vá à categoria Discord Bots no nosso site e escolha o produto Red Discord Bot.
2. Escolha um plano (1 GB de RAM é suficiente para a maioria das configurações), escolha uma região perto de si e finalize a compra.
3. Durante a encomenda, ser-lhe-á pedido:
   • Discord Bot Token — cole o token do passo 1.
   • Prefixo de Comando — o caractere que os utilizadores digitam antes dos comandos, por exemplo, ! ou <. Pode alterar isto mais tarde no Discord.
4. Uma vez provisionado, o painel irá instalar o Red e iniciar o bot. A primeira instalação demora alguns minutos (instalações pip + dependências).

5. Reivindicar propriedade no Discord

Quando o bot estiver online, precisa de dizer ao Red quem é o seu proprietário para que possa executar comandos de administração.

1. No Discord, envie uma DM ao seu bot com o comando <set owner (substitua < pelo seu prefixo).

2. O Red irá imprimir um token de confirmação único na consola do painel — verá algo como:

   Use the command [p]set owner XXXXXX in DM to confirm
   

3. Copie esse token de confirmação da consola e, em seguida, envie uma DM ao bot:

   <set owner XXXXXX
   

4. O Red responde com "I now recognise you as my owner." Está feito — os comandos de administração funcionam para si agora.

6. Carregue os seus primeiros cogs

Cogs são os plugins do Red. Para permitir o download e a instalação:

<load downloader
<repo add aikaterna-cogs https://github.com/aikaterna/aikaterna-cogs
<cog install aikaterna-cogs trivia
<load trivia

Navegue pelo índice Red Cogs para centenas de outros cogs. Cada um tem instruções de instalação na sua página.

Problemas comuns

"redbot: command not found" no primeiro arranque

O instalador não terminou. Este era um bug conhecido no nosso egg Red que já foi corrigido — se estiver a encontrá-lo numa instalação nova, abra um ticket de suporte e reinstalaremos o egg no seu servidor.

"You need to configure the bot instance using redbot-setup prior to running the bot"

O ficheiro de configuração da instância está em falta. O mesmo que acima — abra um ticket e nós corrigiremos. Reinstalar o servidor a partir do painel também irá corrigi-lo em eggs recém-implementados.

Código de saída 78 / "Red requires all Privileged Intents to be enabled"

Volte ao passo 2 acima e ative todas as três intents privilegiadas no Discord Developer Portal. Elas estão desativadas por padrão.

O bot está online, mas não responde a comandos

Duas causas comuns:

1. Message Content Intent está desativado — verifique novamente o passo 2. Sem isto, o bot não consegue ver o texto das mensagens.
2. Está a usar o prefixo errado — verifique a consola do seu painel para o prefixo com que o bot iniciou, ou use @YourBot prefix no Discord (mencionar o bot funciona sempre independentemente do prefixo).

Alterar o prefixo do bot

<set prefix !

O novo prefixo entra em vigor imediatamente.

Obter ajuda

Para perguntas específicas do Red, a documentação oficial do Red é o melhor recurso. Para perguntas de alojamento do ServerPrism — faturação, alterações de plano, desempenho — abra um ticket de suporte e entraremos em contacto consigo.