Configurando o JMusicBot no ServerPrism

JMusicBot é um bot de música para Discord poderoso e fácil de usar. Este guia abrange a criação do seu bot no Discord, convidando-o para o seu servidor, configurando-o no ServerPrism e colocando-o online.

Crie seu bot no Discord Developer Portal

1. Vá para o Discord Developer Portal.
2. Clique em New Application.
3. Dê um nome à sua aplicação (por exemplo, "My Music Bot") 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 em segredo!
8. Role para baixo até Privileged Gateway Intents.
9. Ative o toggle Message Content Intent. O JMusicBot precisa disso para ler comandos como !play nome da música.

Convide o bot para o seu servidor

1. Vá para a aba OAuth2, depois selecione URL Generator na barra lateral esquerda.
2. Em SCOPES, selecione bot.
3. Em BOT PERMISSIONS, selecione o seguinte:
   • Read Messages/View Channels (Ler Mensagens/Ver Canais)
   • Send Messages (Enviar Mensagens)
   • Connect (Conectar)
   • Speak (Falar)
   • Use Voice Activity (Usar Atividade de Voz)
   • Manage Messages (Gerenciar Mensagens) (recomendado para gerenciamento de fila)
   • Read Message History (Ler Histórico de Mensagens)
4. Copie o URL gerado na parte inferior da página.
5. Cole o URL no seu navegador e selecione o servidor Discord para o qual você deseja convidar o bot. Clique em Authorize.

Pedido no ServerPrism

Ao encomendar seu servidor de bot Discord, você provavelmente selecionou JMusicBot como seu runtime. Um plano de 1 GB de RAM é geralmente suficiente para o JMusicBot. Você escolheu sua região preferida durante o processo de pedido, e seu servidor agora está implantado e aguardando configuração.

Configurar variáveis de inicialização

Sua instância do JMusicBot no ServerPrism usa variáveis de ambiente para configuração. Você as define na aba Startup do painel do seu servidor.

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

2. Clique na aba Startup.

3. Localize as seguintes variáveis e defina seus valores:

   • BOT_TOKEN: Cole o token do bot que você copiou do Discord Developer Portal.
   • PREFIX: Defina seu prefixo de comando desejado (por exemplo, !, ?, j!). É assim que os usuários interagirão com seu bot (por exemplo, !play).
   • OWNER_ID: Seu ID de usuário do Discord. Isso concede a você comandos administrativos especiais. Para encontrar seu ID de usuário, ative o Modo Desenvolvedor no Discord (Configurações de Usuário > Avançado), depois clique com o botão direito no seu nome de usuário e selecione "Copiar ID".
   • SPOTIFY_CLIENT_ID (Opcional): Se você deseja integração com o Spotify, crie uma aplicação de Desenvolvedor Spotify aqui e obtenha seu Client ID.
   • SPOTIFY_CLIENT_SECRET (Opcional): O Client Secret para sua aplicação de Desenvolvedor Spotify.
   • YOUTUBE_API_KEY (Opcional, mas Recomendado): Embora o JMusicBot possa frequentemente funcionar sem uma, uma chave de API do YouTube ajuda com a confiabilidade da pesquisa e evita limites de taxa. Obtenha uma no Google Cloud Console.

   Nota: O JMusicBot geralmente não requer uma MONGODB_URI ou string de conexão de banco de dados similar para sua operação básica, pois usa uma configuração simples baseada em arquivo.

4. Salve quaisquer alterações.

Primeira inicialização

1. Vá para a aba Console no seu painel do ServerPrism.
2. Clique no botão Start.
3. Observe a saída do console. Uma inicialização bem-sucedida mostrará mensagens indicando que o bot está se conectando ao Discord, carregando comandos e, eventualmente, uma linha semelhante a [INFO] JMusicBot is ready! ou [INFO] Logged in as <YourBotName>#<Discriminator>. O status do seu bot no Discord mudará para online.

Problemas comuns

• Bot não fica online / Token Rejeitado: Verifique novamente seu BOT_TOKEN na aba Startup. Certifique-se de que não há espaços extras ou caracteres incorretos. Regenere o token no Discord Developer Portal se necessário.
• Bot online, mas não responde aos comandos: Verifique se você ativou o Message Content Intent no Discord Developer Portal na aba Bot. Além disso, certifique-se de que seu PREFIX está configurado corretamente e que você o está usando (por exemplo, !play se seu prefixo for !). Verifique o console para quaisquer mensagens de erro ao tentar usar um comando.
• Bot no canal de voz, mas sem áudio: Certifique-se de que o bot tem as permissões Connect e Speak no canal ou categoria em que está tentando entrar. Além disso, verifique o console para quaisquer erros relacionados à reprodução de áudio.

Próximos passos

Agora que seu JMusicBot está funcionando, você pode explorar seus comandos digitando seu PREFIX seguido de help (por exemplo, !help). Você pode gerenciar filas, pular músicas, ajustar o volume e muito mais. Para configuração avançada ou solução de problemas, consulte o repositório oficial do JMusicBot no GitHub.

Aviso: A transmissão de áudio do YouTube usando bots pode violar os Termos de Serviço do YouTube. O Discord pode revogar tokens de bot encontrados em violação.