Antes de prosseguir:
Caso não tenha um token de bot do discord ou não tenha criado uma conta de bot no developer portal, você pode conferir esse video-tutorial de como criar uma.
Ou caso já tenha uma conta de bot, certifique se as intents do bot que será usado nessa etapa está com a intents de [MESSAGE_CONTENT] e [MEMBERS] ativados.
Nota: O token do bot tem que ser copiado do menu "Bot" no developer portal (não na sessão de General Information). Caso não saiba onde obter o token de uma aplicação existente clique aqui para conferir uma imagem indicando o local correto.
- 1-1: Para começar, acesse o link https://replit.com/@xRitsu/Discord-Music-Bot-PT-BR?v=1 e clique no botão [Fork]:
- 1-2: Na próxima tela coloque um nome para seu projeto (1) e uma descrição (2 - opcional) e em seguida clique no botão [Fork Repl] (3) e aguarde carregar:
- 1-3: Após o fork, vai aparecer a seguinte mensagem abaixo (clique em Manage Secrets):
-
1-4: Nos campos exibidos nas secrets, coloque o token do seu bot em qualquer um dos 5 campos que começa com nome TOKEN_MUSIC_BOT_ e depois clique no botão "Add Secret".
-
Opcional: Caso queira usar mais de 1 bot por vez (pra ativar o sistema de multi-voice) você pode colocar token de mais bots nos outros campos que começam com nome TOKEN_MUSIC_BOT_.
-
Os demais campos são totalmente opcionais mas recomendo não preenche-los caso não saiba pra que servem.
- 3-1: Agora basta apenas clicar no botão Run (Play) e aguardar as dependências serem instaladas e o(s) bot(s) serem iniciados.
4 - Opcional: Migrar da repl.it para squarecloud (Hospedagem barata para manter o bot ligado 24h com planos a partir de R$8,99)
Clique aqui para visualizar:
Caso tenha feito fork (ou atualizado) antes do dia 25/10/2023 recomendo que atualize o code usando o comando no shell antes de prosseguir as etapas abaixo:
bash source_quick_update.sh- 4-1: Antes de começar, verifique se o bot está online e se o seu projeto da repl.it está em execução. Siga os passos abaixo:
1. Procure o arquivo squarecloud.config.example
2. Clique nos 3 pontos.
3. Clique em rename.
Retire o .example do nome (ficando apenas com o nome squarecloud.config) e dê enter pra salvar alterações (Você pode conferir o arquivo caso queira alterar algo, lembrando que o mínimo de ram recomendável é 512mb).
- 4-2: Vá no servidor onde o bot está (em um canal que o bot tenha acesso) e envie uma mensagem mencionando o bot + export (Exemplo: @teubot export) que ele vai te enviar um arquivo zip no privado.
- 4-3: Faça o download do arquivo zip enviado no seu privado.
-
4-4: Acesse o site da squarecloud: https://squarecloud.app/
-
4-5: Clique em login e depois clique no botão [Entrar com o discord]. Será solicitado o acesso a algumas informações de sua conta do discord (clique em autorizar se tiver de acordo).
-
4-6: Após fazer login, clique no botão [Adicionar aplicação]
- 4-7: Arraste o arquivo zip na região marcada na print abaixo (ou clique nessa mesma região pra selecionar o arquivo zip do bot manualmente) e aguarde sua aplicação ser inicializada.
-
4-8: Voltando pra replit, pare o projeto (clicando no botão stop) pra evitar que o bot fique ligado em múltiplos locais causando conflitos.
-
4-9: Agora basta apenas testar o bot executando algum comando e verificar se o mesmo está funcionando normalmente.
- Todos os itens configurados nas secrets (token etc) agora se encontram no arquivo .env para futuras alterações (use o gerenciador de arquivos da squarecloud para editá-lo quando necessário).
Você pode usar essa source como alternativa de self-hosting do meu bot principal (Muse Heart) pra hospedar/rodar seu próprio bot de música para uso privado ou em servidores públicos no qual você gerencia (que você tenha permissão de adicionar seu próprio bot no servidor). Entretanto não recomendo distribuir o bot usando essa source publicamente por não estar otimizado o suficiente pra lidar com alta demanda de servidores, mas se mesmo assim decidir fazer isso o bot terá que estar sob a licença gpl-2.0 da source original e dependendo de onde o bot estiver sendo divulgado (ex: botlists) há possibilidade de seu bot ser apontado pelo uso dessa source.
Caso ainda tenha alguma dúvida, envie uma mensagem nos comentários do final da página ou entre no servidor de suporte do discord.