Guides / Building & Resources

Substituindo sons com um pacote de recursos: sounds.json e o requisito .ogg

O Minecraft só reproduz Ogg Vorbis, e um evento sonoro não é um arquivo. Aqui está o arquivo de mapeamento, como adicionar um som em vez de substituir um, e por que o seu está mudo.

2026-06-25

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

Apenas Ogg Vorbis

O Minecraft reproduz .ogg (Vorbis) e nada mais. Um .mp3 ou .wav renomeado para .ogg não será reproduzido — o contêiner precisa ser realmente Ogg.

Mono versus estéreo também importa: apenas arquivos mono são posicionados no espaço 3D. Um arquivo estéreo é reproduzido em volume constante em todos os lugares, o que é certo para música e errado para o som de um bloco. Se o som personalizado da sua Bigorna parece seguir você, ele é estéreo.

Um evento sonoro é um nome, não um arquivo

entity.pig.ambient é um evento. Ele mapeia para uma lista de arquivos, um dos quais é escolhido aleatoriamente a cada vez. Substituir o som de um Porco significa redefinir o evento, não soltar 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. Deixe-o de fora e seu som será adicionado ao pool, então ele será reproduzido às vezes e o original em outras. Ambos os comportamentos são úteis; o padrão é adicionar.
• Os caminhos omitem sounds/ e .ogg. custom/my_pig resolve para assets/minecraft/sounds/custom/my_pig.ogg.
• sounds.json fica na raiz 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úsica e discos. Arquivos longos não transmitidos são carregados completamente na memória e podem travar o cliente.
• volume não pode exceder 1.0. Mais alto significa um arquivo de origem mais alto.

Adicionando um som totalmente novo

Use seu próprio namespace para que nada colida:

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

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

Então /playsound my_pack:spell master @a ~ ~ ~ 1 1. Eventos sonoros personalizados funcionam com /playsound e em blocos de notas através de uma definição de música de Toca-Discos; eles não se anexam automaticamente a nenhuma ação do jogo.

Por que está mudo

1. Não é Ogg Vorbis real.
2. O caminho inclui sounds/ ou .ogg.
3. sounds.json é um JSON inválido — uma vírgula no final mata o arquivo inteiro, então todos os sons do pacote ficam mudos, não apenas o novo.
4. pack_format errado, então o pacote carrega, mas os recursos são ignorados.

Folhas de consulta para a estrutura da pasta do pacote, remapeamento de eventos sonoros e texturas animadas estão nas Ferramentas de Referência de Pacotes de Recursos.

Referência de pacotes de recursos →