Configurando o fragbot no ServerPrism

fragbot é o bot oficial do Discord para a Fragforce, fornecendo várias utilidades. Este guia abrange a criação do seu aplicativo de bot, convidando-o para o seu servidor, configurando-o no ServerPrism e colocando-o online.

Crie seu bot no Portal do Desenvolvedor Discord

1. Vá para o Portal do Desenvolvedor Discord.
2. Clique em New Application.
3. Dê um nome ao seu aplicativo (por exemplo, fragbot) e clique em Create.
4. Navegue até a aba Bot na barra lateral esquerda.
5. Clique em Add Bot, depois em Yes, do it!.
6. Em TOKEN, clique em Reset Token, depois em Yes, do it!.
7. Copie este token imediatamente. Você precisará dele para a sua configuração no ServerPrism. Mantenha-o seguro; não o compartilhe.
8. Em Privileged Gateway Intents, ative MESSAGE CONTENT INTENT. O fragbot precisa disso para ler mensagens e responder a comandos.

Convide o bot para o seu servidor

1. Vá para a aba OAuth2, depois para URL Generator.
2. Em SCOPES, selecione bot e applications.commands.
3. Em BOT PERMISSIONS, selecione as permissões que seu bot precisa. Para o fragbot, um bom ponto de partida inclui:
   • Read Messages/View Channels (Ler Mensagens/Ver Canais)
   • Send Messages (Enviar Mensagens)
   • Embed Links (Incorporar Links)
   • Attach Files (Anexar Arquivos)
   • Manage Messages (Gerenciar Mensagens) (se você quiser que ele exclua mensagens, por exemplo, para moderação)
4. Copie o URL gerado na parte inferior.
5. Cole o URL no seu navegador e selecione o servidor Discord para o qual você deseja convidar o bot.
6. Clique em Authorize.

Faça seu pedido no ServerPrism

Ao solicitar seu servidor de bot Discord no ServerPrism, 1 GB de RAM geralmente é suficiente para o fragbot. Escolha a região mais próxima da sua base de usuários principal para um desempenho ideal. Uma vez solicitado, seu servidor será implantado e o pacote fragbot virá pré-instalado.

Configure as variáveis de inicialização

A aba Startup do seu painel ServerPrism é onde você configura o fragbot usando variáveis de ambiente. Essas variáveis informam ao bot como se conectar ao Discord e qual prefixo usar para os comandos.

Defina as seguintes variáveis:

• BOT_TOKEN: Cole o token do bot que você copiou do Portal do Desenvolvedor Discord.
• PREFIX: O prefixo de comando ao qual seu bot responderá. Uma escolha comum é !. Por exemplo, se você definir PREFIX como !, você usaria !help.
• OWNER_ID: O ID de Usuário do Discord do proprietário do bot. Você pode obter seu ID de Usuário ativando o Modo Desenvolvedor no Discord (Configurações de Usuário > Avançado) e, em seguida, clicando com o botão direito do mouse em seu nome de usuário e selecionando Copy ID.

O fragbot pode exigir configuração adicional dependendo de suas funcionalidades. Consulte o repositório GitHub do fragbot para quaisquer variáveis de ambiente avançadas específicas que ele possa usar para recursos como conexões de banco de dados ou chaves de API.

Primeira inicialização

1. Após definir as variáveis de ambiente, navegue até a aba Console no seu painel ServerPrism.
2. Clique no botão Start.
3. Observe a saída do console. Uma inicialização bem-sucedida geralmente mostra mensagens indicando que o bot está se conectando ao Discord e fazendo login, seguido por uma mensagem como Bot is ready! ou Logged in as fragbot#1234.
4. Seu bot agora deve aparecer online no seu servidor Discord.

Problemas comuns

• Token do bot rejeitado/token inválido: Verifique novamente se BOT_TOKEN na sua aba Startup é exatamente o token que você copiou do Portal do Desenvolvedor. Certifique-se de que não há espaços iniciais/finais.
• Bot online, mas não responde a comandos: Verifique se você ativou o MESSAGE CONTENT INTENT no Portal do Desenvolvedor Discord nas configurações do seu bot. Sem isso, o bot não pode ler o conteúdo das mensagens para processar comandos.
• Bot não fica online: Verifique o console em busca de erros. Problemas comuns incluem BOT_TOKEN incorreto ou variáveis de ambiente obrigatórias ausentes. Certifique-se de que todas as variáveis necessárias estejam definidas na aba Startup.

Próximos passos

Agora que o fragbot está funcionando, você pode começar a explorar seus comandos. Use o comando !help (ou qualquer prefixo que você configurou) no seu servidor Discord para ver uma lista de comandos disponíveis. Para configuração mais avançada ou para entender recursos específicos, consulte o repositório GitHub do fragbot.