Guias / Construção e recursos

Substituindo sons com um pacote de recursos: sounds.json e a exigência do .ogg

O Minecraft só reproduz Ogg Vorbis, e um evento de som não é um arquivo. Veja aqui o arquivo de mapeamento, como adicionar um som em vez de substituí-lo e por que o seu fica mudo.

2026-06-25

A substituição de sons falha silenciosamente mais do que qualquer outro recurso de pacote de recursos, e quase sempre é uma de duas coisas: o formato de áudio errado, ou um mal-entendido sobre o que é um evento de som.

Apenas Ogg Vorbis

O Minecraft reproduz .ogg (Vorbis) e nada mais. Um .mp3 ou .wav renomeado para .ogg não vai tocar — o contêiner precisa ser de fato Ogg.

Mono versus estéreo também importa: apenas arquivos mono são posicionados no espaço 3D. Um arquivo estéreo toca em volume constante em todo lugar, o que é certo para música e errado para o som de um bloco. Se o seu som personalizado de bigorna parece te seguir por aí, é porque está em estéreo.

Um evento de som é um nome, não um arquivo

entity.pig.ambient é um evento. Ele mapeia para uma lista de arquivos, dos quais um é escolhido aleatoriamente a cada vez. Substituir o som de um porco significa redefinir o evento, não largar um arquivo em algum lugar.

assets/minecraft/
├── sounds.json
└── sounds/custom/my_pig.ogg

{
  "entity.pig.ambient": {
    "replace": true,
    "sounds": [ "custom/my_pig" ]
  }
}

Três detalhes:

• replace: true descarta a lista vanilla. Se você omitir, o seu som é adicionado à piscina, então ele toca às vezes e o original toca nas outras. Os dois comportamentos são úteis; o padrão é adicionar.
• Os caminhos omitem sounds/ e .ogg. custom/my_pig é resolvido para assets/minecraft/sounds/custom/my_pig.ogg.
• sounds.json fica na raiz de assets/minecraft, não dentro de sounds/.

Opções por arquivo

"sounds": [
  { "name": "custom/my_pig", "volume": 0.8, "pitch": 1.2, "weight": 3, "stream": false }
]

• weight influencia a seleção aleatória dentro da lista.
• stream: true para qualquer coisa com mais de alguns segundos — músicas e discos. Arquivos longos sem streaming são carregados inteiramente na memória e podem travar o cliente.
• volume não pode passar de 1.0. Mais alto significa um arquivo de origem mais alto.

Adicionando um som totalmente novo

Use o seu próprio namespace para que nada entre em conflito:

assets/my_pack/sounds.json
assets/my_pack/sounds/spell.ogg

{ "spell": { "sounds": ["spell"] } }

Depois, /playsound my_pack:spell master @a ~ ~ ~ 1 1. Eventos de som personalizados funcionam com /playsound, em toca-discos por meio de uma definição de música de toca-discos, e em blocos musicais por meio do componente note_block_sound de uma cabeça de jogador; eles não se vinculam automaticamente a nenhuma ação do jogo.

Por que fica mudo

1. Não é Ogg Vorbis de verdade.
2. O caminho inclui sounds/ ou .ogg.
3. O sounds.json é um JSON inválido — uma vírgula sobrando mata o arquivo inteiro, então todo som do pacote fica mudo, não só o novo.
4. Um pack.mcmeta desatualizado — a versão 26.x exige min_format e max_format, e um pacote sem eles aparece como incompatível.

Guias rápidos para a estrutura de pastas do pacote, remapeamento de eventos de som e texturas animadas estão em Ferramentas de Referência para Pacotes de Recursos.

Referência de pacotes de recursos →