Como criar um bot de música para Discord

Primeiro: a voz criptografada do Discord (DAVE)

Desde 1º de março de 2026, o Discord só permite chamadas de voz com criptografia de ponta a ponta, por meio de um protocolo chamado DAVE. Um bot feito com uma biblioteca que não tem suporte a ele não consegue mais entrar em canais de voz. Por isso muitos tutoriais e repositórios antigos de bots de música pararam de funcionar.

Antes de começar, confira se a sua stack é recente o bastante:

Duas formas de tocar áudio: Lavalink ou FFmpeg

A maioria dos bots de música públicos usa Lavalink. O FFmpeg é mais simples para começar, porque só há um programa para rodar.

Bibliotecas cliente de Lavalink que recebem manutenção

Estes clientes estão na lista oficial do Lavalink e lançaram versões em 2026 com as mudanças de voz acima:

• JavaScript (discord.js): lavalink-client, Shoukaku, Riffy, Moonlink.js
• Python (discord.py): Wavelink, lavalink.py, mafic, pomice
• C#: Lavalink4NET
• Java (JDA): Lavalink-Client

Cada um se conecta a um servidor Lavalink com host, porta e senha, e dá ao seu bot comandos como buscar, tocar, pular e volume. A configuração do servidor em si está em como hospedar um servidor Lavalink.

Em JavaScript também existe o discord-player, que cuida do áudio dentro do bot. A versão atual não tem mais suporte ao YouTube; ela toca SoundCloud, Vimeo, anexos e links do Spotify ou Apple Music por meio de outras fontes.

O jeito FFmpeg, em poucas linhas

Para ver a voz funcionando, toque um arquivo que seja seu. Em Python, instale o extra de voz e confira se o ffmpeg está no seu sistema:

pip install "discord.py[voice]"

Depois, dentro de um comando de barra, entre no canal de quem chamou o comando e toque um arquivo local:

channel = interaction.user.voice.channel
voice = await channel.connect()
voice.play(discord.FFmpegPCMAudio("song.mp3"))
await interaction.response.send_message("Playing.")

Em JavaScript, o equivalente é @discordjs/voice com @discordjs/opus e FFmpeg. Um bot de verdade adiciona uma fila, comandos de pular e parar, e sai do canal quando ele fica vazio.

O que um bot de música pode tocar

É aqui que a maioria dos bots de música arruma problema, então tenha isso claro antes de construir:

• Os termos do YouTube não permitem baixar nem retransmitir o conteúdo dele sem permissão, nem burlar suas proteções. Grandes bots de música foram derrubados justamente por isso.
• As diretrizes da comunidade do Discord proíbem compartilhar conteúdo que viole a propriedade intelectual de qualquer pessoa, e o dono do bot é responsável pelo que ele faz.
• Fontes mais seguras: música sua ou licenciada para você, bibliotecas livres de royalties e Creative Commons, rádios online que permitam isso e arquivos que seus membros enviem com o direito de compartilhá-los.

O Lavalink e seus plugins conseguem tecnicamente tocar de muitos sites; se você tem permissão para isso é outra questão, e cabe a você responder.

Hospedando um bot de música

Um bot de música precisa ficar online e manter uma conexão estável enquanto transmite, algo que um PC de casa no Wi-Fi raramente consegue por muito tempo. Na hospedagem de bots Discord da HytHost:

• O bot roda no runtime Node.js, Python, Java, Go, C# ou Bun que você escolher no pedido.
• O Lavalink é um runtime próprio. Ele roda como um servidor separado: contrate um plano para o bot e outro com o runtime Lavalink ou, em um plano com vários slots de bot, peça para movermos um deles para Lavalink.
• Aponte o cliente Lavalink do bot para o endereço, a porta e a senha do servidor Lavalink, como aparecem no painel dele.

Manter o próprio bot online, com reinício automático e o token em um lugar seguro, é explicado em como hospedar um bot do Discord 24/7.