Configurando o pixel-bot no ServerPrism

Este guia o orienta na configuração do pixel-bot, um bot Discord baseado em Python, em seu servidor ServerPrism. Você criará seu aplicativo de bot no Discord, o convidará para seu servidor e o configurará no ServerPrism.

Crie seu bot no Portal do Desenvolvedor do Discord

1. Vá para o Portal do Desenvolvedor do Discord.
2. Clique em New Application.
3. Digite um nome para seu bot (por exemplo, pixel-bot) e clique em Create.
4. Na barra lateral esquerda, clique em Bot.
5. Clique em Add Bot, depois em Yes, Do It!
6. Em TOKEN, clique em Reset Token, depois em Yes, Do It! Copie este token imediatamente; você precisará dele mais tarde. Mantenha-o em segredo.
7. Em Privileged Gateway Intents, habilite Message Content Intent. O pixel-bot precisa disso para ler mensagens e responder a comandos.

Convide o bot para seu servidor

1. No Portal do Desenvolvedor do Discord, vá para o aplicativo do seu bot.
2. Na barra lateral esquerda, clique em OAuth2 -> URL Generator.
3. Em SCOPES, selecione bot.
4. Em BOT PERMISSIONS, selecione as permissões que seu bot precisa. Para o pixel-bot, Send Messages e Read Message History são bons pontos de partida.
5. Copie o URL gerado na parte inferior da página.
6. Cole o URL em seu navegador e selecione o servidor Discord para o qual deseja convidar o bot. Clique em Authorize.

Peça no ServerPrism

Ao solicitar seu servidor de bot Discord no ServerPrism, um plano de 1 GB de RAM é geralmente suficiente para o pixel-bot. Escolha uma região mais próxima de seus usuários para um desempenho ideal. Uma vez solicitado, seu servidor será implantado automaticamente com o tempo de execução do pixel-bot pré-instalado.

Configure as variáveis de inicialização

Seu painel ServerPrism permite que você defina variáveis de ambiente para seu bot. Elas são cruciais para sua operação.

1. Navegue até o servidor do seu bot no painel ServerPrism.

2. Clique na aba Startup.

3. Defina as seguintes variáveis de ambiente:

   • BOT_TOKEN: Cole o token do bot que você copiou do Portal do Desenvolvedor do Discord.
   • PREFIX: Defina isso para o prefixo de comando desejado (por exemplo, !, /, p!). É assim que os usuários interagirão com seu bot (por exemplo, !ping).
   • OWNER_ID: Seu ID de usuário do Discord. Isso é necessário para alguns comandos de administração. Para obter seu ID de usuário, ative o Modo Desenvolvedor no Discord (Configurações de Usuário > Avançado), então clique com o botão direito em seu perfil e selecione Copy ID.

   A aba Startup também pode listar outras variáveis. Consulte o repositório oficial do pixel-bot no GitHub para qualquer configuração adicional específica para certas funcionalidades:

   • pixel-bot GitHub

Primeira inicialização

1. Vá para a aba Console em seu painel ServerPrism.

2. Clique em Start.

3. Observe a saída do console. Uma inicialização bem-sucedida mostrará mensagens indicando que o bot está se conectando ao Discord e fazendo login. Você deverá ver uma saída semelhante a:

   [INFO] discord.client: logging in using static token
   [INFO] discord.gateway: Shard ID 0 has connected to Gateway (Session ID: ...)
   [INFO] discord.client: Ready! Logged in as pixel-bot#1234 (ID: ...)
   

4. Verifique seu servidor Discord; seu bot deverá aparecer online.

Problemas comuns

• Token do bot rejeitado: Verifique novamente se BOT_TOKEN na aba Startup está correto e não tem espaços extras. Regenere o token no Portal do Desenvolvedor se tiver dúvidas.
• Bot online, mas não respondendo: Certifique-se de que Message Content Intent esteja habilitado no Portal do Desenvolvedor do Discord nas configurações do seu bot. Sem ele, o bot não pode ler comandos de mensagem.
• Bot não fica online: Revise os logs do console para mensagens de erro. Problemas comuns incluem tokens incorretos, variáveis de ambiente ausentes ou erros críticos no código do bot. Certifique-se de que todas as variáveis Startup necessárias estejam definidas.

Próximos passos

Seu pixel-bot está agora em execução! Você pode começar a usar seus comandos em seu servidor Discord. Para uma lista de comandos disponíveis e opções de personalização adicionais, consulte o repositório pixel-bot GitHub.