Música

Descrição

Guia do Usuário

Um player de áudio para seus canais de voz: o bot entra no seu canal, toca as faixas de uma fila de reprodução e anuncia o que está tocando. Pode ser usado por todos os membros.

O que ele faz

• Entra no seu canal de voz e inicia a reprodução.
• Acumula os pedidos em uma fila de reprodução por servidor.
• Adiciona uma playlist inteira com um único comando.
• Anuncia cada faixa (título, autor, miniatura) no canal onde o pedido foi feito.
• Permite pular, pausar, retomar, parar e ajustar o volume.
• Sai da voz automaticamente quando a fila fica vazia.

Início rápido (Admin)

1. Nenhuma configuração é necessária: o módulo está pronto assim que o bot entra no servidor.
2. Verifique se o bot pode se conectar e falar nos canais de voz em questão.
3. Entre em um canal de voz e execute /music play com um título ou um link.
4. Se a reprodução deve ficar restrita a determinados membros, restrinja os comandos /music nas Configurações do servidor → Integrações do Discord.

Comandos

Comando	Descrição
/music play	Toca uma faixa ou a adiciona à fila de reprodução (título para buscar ou link).
/music skip	Passa para a faixa seguinte.
/music pause	Pausa a reprodução.
/music resume	Retoma a reprodução.
/music stop	Para a reprodução, esvazia a fila e desconecta o bot.
/music queue	Exibe a fila de reprodução.
/music volume	Ajusta o volume, de 0 a 100.

Configuração pelo dashboard

Este módulo não tem página no dashboard: ele é controlado apenas pelos comandos acima.

Bom saber

• O módulo depende de um serviço de áudio externo (um servidor Lavalink) que deve estar em funcionamento e acessível ao bot. Se estiver indisponível, /music play responde "O serviço de música está indisponível no momento"; todos os outros comandos ficam sem efeito.
• Você precisa estar em um canal de voz para executar /music play: o bot entra no canal onde você está.
• Uma busca por texto consulta o SoundCloud. Se você quiser uma fonte específica, cole diretamente o link: ele será resolvido tal como está.
• Colar o link de uma playlist adiciona todas as suas faixas à fila de uma vez.
• A fila é comum a todo o servidor: existe apenas uma, e o volume se aplica ao player inteiro, não a cada ouvinte.
• /music queue exibe apenas as 10 primeiras faixas, seguidas do número de títulos restantes.
• Os anúncios de "tocando agora" são enviados ao canal de texto de onde veio o último comando /music play.
• Algumas faixas não podem ser reproduzidas mesmo que apareçam nos resultados (conteúdo monetizado, restrito ou bloqueado geograficamente). O bot avisa e passa automaticamente para a seguinte.
• Quando a fila se esvazia, o bot se desconecta por conta própria; é preciso executar /music play de novo para trazê-lo de volta.
• Não existe repetição, reprodução aleatória nem remoção de uma faixa específica da fila: use /music skip ou /music stop.