Começando com Bots do Discord

Este guia o orienta na configuração do seu bot do Discord no ServerPrism. Você aprenderá como solicitar um servidor, configurar seu bot e conectá-lo ao Discord.

Antes de começar

Antes de implantar seu bot, você precisa de um token de bot do Discord. Você pode gerar este token no Discord Developer Portal. Crie um novo aplicativo, navegue até a aba 'Bot' e clique em 'Add Bot'. Uma vez criado, você pode revelar e copiar seu token. Mantenha este token seguro; ele concede controle total sobre seu bot.

Pedindo no ServerPrism

1. Selecione um plano: Bots do Discord geralmente exigem pelo menos 2 GB de RAM. Para bots com muitos recursos ou muitas guildas, considere 4-8 GB. Você pode atualizar seu plano mais tarde no painel do ServerPrism, se necessário.
2. Escolha um runtime: O ServerPrism oferece vários runtimes de bot do Discord pré-configurados, como Aoede, Bastion, Dynamica e JMusicBot. Selecione o bot que deseja implantar. Você pode alternar os runtimes mais tarde através da aba 'Startup' no painel.
3. Implantar: Selecione sua região preferida e complete o pedido.

Primeira inicialização

Após o pedido, seu servidor de bot começará o provisionamento. Este processo geralmente leva alguns minutos. Você pode monitorar o progresso no painel do ServerPrism em https://serverprism.com/dashboard. Assim que o status do servidor mostrar 'Running' e a saída do console estabilizar, seu bot estará pronto para configuração.

Noções básicas de configuração

A maioria dos bots do Discord requer um token de bot para funcionar. Este token autentica seu bot com o Discord.

1. Acessar Variáveis de Inicialização: No seu painel do ServerPrism, navegue até a aba 'Startup'.
2. Insira seu token de bot: Localize a variável de ambiente para seu token de bot. Geralmente é nomeada BOT_TOKEN, DISCORD_TOKEN ou similar. Cole seu token de bot do Discord no campo correspondente.
3. Salvar e reiniciar: Clique em 'Save' e, em seguida, reinicie seu servidor na aba 'Console' ou 'Power' para que as alterações entrem em vigor.

Para configurações específicas do bot (por exemplo, prefixos personalizados, mensagens de boas-vindas, chaves de API para integrações), você normalmente usará um destes métodos:

• Variáveis de Inicialização: Verifique a aba 'Startup' no seu painel para opções de configuração adicionais fornecidas pelo runtime específico do bot.
• Gerenciador de Arquivos: Acesse os arquivos de configuração do bot (por exemplo, config.json, arquivos .env) através do 'File Manager' no seu painel. Edite esses arquivos diretamente.
• Console Web: Alguns bots oferecem comandos no jogo ou uma interface web para configuração. Verifique a documentação do bot para detalhes.

Convidando seu bot para o Discord

Para convidar seu bot para um servidor do Discord:

1. Obtenha o Client ID do seu bot: Vá para o Discord Developer Portal, selecione seu aplicativo e copie o 'Client ID' da aba 'General Information'.
2. Gerar um URL de convite: Use a seguinte estrutura de URL, substituindo YOUR_CLIENT_ID pelo Client ID do seu bot:

   https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&scope=bot&permissions=8
   

   O permissions=8 concede permissões de administrador, o que é frequentemente necessário para a funcionalidade completa do bot. Ajuste as permissões conforme necessário para as necessidades específicas do seu bot.
3. Convidar: Cole o URL gerado em seu navegador, selecione o servidor do Discord ao qual deseja adicionar o bot e autorize-o.

Seu bot deve agora aparecer na lista de membros do seu servidor do Discord e ficar online logo após o início do seu servidor.

Problemas comuns

• Bot não fica online:
  • Token incorreto: Verifique novamente seu BOT_TOKEN na aba 'Startup'. Certifique-se de que não há espaços extras ou caracteres ausentes.
  • Permissões do bot: No Discord Developer Portal, na aba 'Bot' do seu aplicativo, certifique-se de que as 'Privileged Gateway Intents' (como PRESENCE INTENT e MESSAGE CONTENT INTENT) estejam ativadas se seu bot as exigir.
  • Firewall: O ServerPrism configura automaticamente o firewall. Se você encontrar problemas de conectividade, abra um ticket de suporte em https://serverprism.com/tickets com seu ID de servidor e logs recentes.
• Bot não responde aos comandos:
  • Problemas de prefixo: Verifique o prefixo de comando do bot em sua configuração. Alguns bots usam um prefixo padrão (por exemplo, !, /, .)
  • Permissões ausentes: Certifique-se de que o bot tenha as permissões necessárias no servidor do Discord para o qual foi convidado.
  • Bot offline: Verifique o console do servidor no painel do ServerPrism em busca de erros. Se o bot travou, o console mostrará mensagens de erro relevantes.

Próximos passos

• Personalizar: Consulte a documentação oficial do bot escolhido para configuração avançada, adição de comandos personalizados ou integração com outros serviços.
• Troca de Runtime: Se você quiser experimentar um tipo diferente de bot do Discord, pode alternar os runtimes diretamente na aba 'Startup' do seu painel do ServerPrism sem precisar reordenar seu servidor.
• Atualizar seu plano: Se seu bot apresentar problemas de desempenho ou se você planeja escalar seu uso, pode facilmente atualizar a RAM e a CPU do seu servidor no painel de cliente do ServerPrism.