
Executar ZMusic, o Plugin de Música do Minecraft, em 2026
zmusic-plugin (zmusic-dev/zmusic-plugin)
Sistema de música poderoso para Minecraft, com suporte a letras, listas de reprodução e multiplataforma | Powerful Minecraft music system with lyrics, playlists, and multi-platform support
Quer música tocando em todo o servidor Minecraft sem pedir que todos usem outro aplicativo? É exatamente o que ZMusic resolve. É um plugin de servidor que permite que os jogadores busquem músicas, adicionem à fila para todo o servidor, e leiam letras rolagens, tudo dentro do jogo. Listas de reprodução pessoais também estão disponíveis, caso queira manter seu gosto para si.
O que ZMusic Faz
No seu núcleo, ZMusic transforma seu servidor em uma caixa de som a que todos podem contribuir. Um jogador busca uma faixa por palavra-chave, seleciona uma dos resultados, e ela toca. Você pode disparar um pedido de servidor para que todos ouçam, ou manter a reprodução apenas para si. Ele busca em mais de uma fonte de busca, então você não fica preso ao catálogo de uma única plataforma.
A parte das letras me surpreendeu. ZMusic exibe letras sincronizadas enquanto uma faixa toca, e pode exibir uma versão traduzida ao lado da original. Em um servidor com jogadores espalhados por diferentes países, essa é uma característica genuinamente atenta.
As listas de reprodução vêm em dois sabores: pessoais e de servidor. Sua área de espera pode loopar uma lista de reprodução global curada enquanto os jogadores individuais ainda constroem as suas próprias. Adicione controle de volume e suporte a BungeeCord (para que funcione em uma rede vinculada, não apenas em uma caixa) e você tem um conjunto bastante completo.
Ele é escrito em Kotlin e está em 151 estrelas. Os contadores do bStats mostram servidores reais executando-o, o que é mais do que o que você pode dizer sobre muitos plugins de hobby.
Por que se enfiar a executá-lo
Imagine um servidor de hub. Os jogadores carregam, e em vez de silêncio morto, há uma faixa tocando que alguém adicionou à fila trinta segundos antes. É o uso óbvio.
Mas o recurso de pedido é onde as coisas ficam divertidas. Servidores de roleplay iniciam estações de rádio in character. Servidores de construção colocam música de fundo durante sessões longas. Vi a abordagem de escuta em grupo funcionar surpreendentemente bem também: alguém adiciona um álbum à fila, todos ficam por perto de um lote, e isso se transforma em uma coisa social em vez de uma característica que ninguém toca.
Um servidor silencioso se sente como um demo de tecnologia. Um servidor com uma trilha sonora compartilhada se sente vivo.
Eu o executaria em um servidor de sobrevivência hardcore onde a imersão é o ponto principal? Provavelmente não. Ferramenta certa, servidor certo.
Instalando-o
É uma instalação padrão de plugin Paper, então se você já caiu um jar na pasta de plugins, já sabe o procedimento. Pegue o jar da release no GitHub:
wget https://github.com/zmusic-dev/zmusic-plugin/releases/download/2.12.0/zmusic-plugin-2.12.0-all.jarEntão mova para o diretório de plugins do servidor e reinicie:
mv zmusic-plugin-2.12.0-all.jar /caminho/para/servidor/plugins/
# reinicie o servidor para que o plugin carregueHá um segundo download nas releases, o jar de addon (zmusic-addon-2.5.0-all.jar). O changelog da 2.12.0 menciona que o addon foi atualizado para 2.5.0 para suportar melhor o Paper de alta versão, e as mesmas notas mencionam a adaptação ao Paper 1.21.11, então em uma compilação mais recente do Paper, você provavelmente quer ambos os arquivos em vez de apenas o plugin principal.
Comandos exatos do jogo e opções de configuração vivem na documentação do projeto (em zmusic.zhenxin.me), e eu apontaria para lá em vez de adivinhar a sintaxe, pois a release 2.12.0 efetivamente reconstruiu o sistema de login para suportar vários métodos de login. A documentação é a verdade aqui.
Um lado prático: se você estiver iniciando um servidor de teste para este plugin, um endereço de DNS memorável bate um IP cru. minecraft.how tem uma ferramenta de DNS do Minecraft gratuita que resolve isso em alguns minutos.
Recursos para Conhecer
Várias coisas se destacam uma vez que você passa a configuração.
Pesquisa de palavra-chave multi-fonte
Você não precisa do ID exato ou URL da música. Digite uma palavra-chave, obtenha resultados de várias fontes, escolha um. Isso importa mais do que soa, porque nenhuma plataforma tem tudo, e as fontes de busca caem ou mudam suas APIs constantemente. Ter algumas para cair de volta mantém os pedidos de mortos.
Letras, com tradução
Letras sincronizadas rolam à medida que a faixa toca, e a exibição de tradução é o verdadeiro brinde: linhas originais e traduzidas juntas. Ótimo para comunidades internacionais, ou honestamente só para descobrir o que aquela música está realmente dizendo.
Listas de reprodução pessoais e de servidor
Duas camadas aqui. Uma lista de reprodução global que todo o servidor compartilha (útil para uma área de espera em loop) e listas de reprodução pessoais que cada jogador cura. O controle de volume fica em cima para que ninguém seja explodido da cadeira.
Notificações de "Agora Tocando"
A menção do changelog sobre reparar "Paper 1.21.11 Toast" aponta para o plugin usando esses popups de estilo conquista para informações de "Agora Tocando". Toque pequeno, mas significa que os jogadores veem o que está girando sem spammar o chat.
Reprodução de vídeo completo do Bilibili
A última release ampliou o suporte do Bilibili de música apenas para áudio de vídeo completo, e corrigiu os cabeçalhos de conversão de áudio e um tempo limite de transcoding que costumava tropeçar nele. Se sua comunidade se inclina para essa plataforma, as versões recentes lidam com isso de forma notavelmente melhor.
Onde as Pessoas se Enredam
Primeiro: ZMusic é construído em torno de plataformas de música chinesas e a documentação mais profunda é principalmente em chinês. Há versões do readme em inglês e japonês, mas a documentação detalhada assume algum conhecimento da original. Não é um problema, apenas defina expectativas.
Segundo, é licenciado como GPL-3.0. Totalmente ok para executar em seu servidor, mas se você bifurcar ou construir em cima, herda obrigações de GPL (seu derivado deve permanecer aberto sob a mesma licença). Vale a pena saber antes de começar a mexer nele.
Então há a deriva de versão. Minecraft se move rápido, e um plugin que faz trabalho de áudio de baixo nível tem que perseguir mudanças no NMS constantemente. O projeto claramente mantiene o passo (o changelog mostra reparos no Paper 1.21.11), mas sempre combine a versão do plugin com a versão do servidor, em vez de supor que o jar mais novo roda em todos os lugares. Na verdade, isso se aplica ao addon também, não apenas ao plugin principal.
E o addon. As pessoas pegam o plugin principal, pulam o jar de addon, então se perguntam por que os builds mais recentes do Paper mal funcionam. Se você está em um Paper recente, pegue ambos.
Alternativas para Ver
ZMusic não é a única maneira de colocar áudio no Minecraft, embora seja um dos plugins mais recheados de recursos para pedidos de músicas reais.
OpenAudioMc toma um caminho diferente. Ele transmite áudio para uma aba de navegador e brilha com som ambiente baseado em região, como diferentes músicas em diferentes áreas do seu mapa. Honestamente, menos sobre permitir que os jogadores DJ, mais sobre atmosfera.
Para os verdadeiramente velhos, há plugins de músicas de bloco de notas que tocam melodias através do próprio motor de som do Minecraft, sem áudio externo. Limitado, mas funcionam em qualquer cliente com zero configuração. E se seu objetivo real for voz mais um pouco de música, um mod de chat de voz arrasta uma coita completamente diferente. Ferramenta diferente, trabalho diferente.
Minha Visão
ZMusic é genuinamente impressionante para o que é: um sistema de música polido, ativamente mantido, que lida com todo o loop de busca a letras sincronizadas. A tradução de letras sozinha coloca-o à frente da maioria das opções que tentei.
A pegadinha é a orientação para plataformas chinesas e documentação em chinês. Se sua comunidade estiver confortável com isso, é uma das melhores escolhas lá fora. Se não, você passará algum tempo em ferramentas de tradução ajustando-o.
De qualquer forma, é o tipo de projeto que faz um servidor sentir-se menos como um mundo vazio e mais como um lugar onde as pessoas querem ficar. (E se você estiver polindo o vibe de qualquer forma, o criador de skins do minecraft.how é um buraco de lebre divertido para dar a si mesmo um novo look enquanto a música toca.)
Lead writer at minecraft.how. Long-time Minecraft player running a small SMP server, testing every build, mod, and seed before writing about it.
Comentários
Nenhum comentário ainda. Seja o primeiro a compartilhar sua opinião!


