Guías / Construcción y recursos

Reemplazar sonidos con un paquete de recursos: sounds.json y el requisito de .ogg

Minecraft solo reproduce Ogg Vorbis, y un evento de sonido no es un archivo. Aquí está el archivo de asignación, cómo añadir un sonido en lugar de reemplazarlo, y por qué el tuyo queda en silencio.

2026-06-25

El reemplazo de sonidos falla en silencio más a menudo que cualquier otra función de los paquetes de recursos, y casi siempre es una de dos cosas: el formato de audio incorrecto, o un malentendido sobre qué es un evento de sonido.

Solo Ogg Vorbis

Minecraft reproduce .ogg (Vorbis) y nada más. Un .mp3 o .wav renombrado a .ogg no se reproducirá — el contenedor tiene que ser realmente Ogg.

Mono frente a estéreo también importa: solo los archivos mono se posicionan en el espacio 3D. Un archivo estéreo se reproduce a volumen constante en todas partes, lo cual es correcto para la música e incorrecto para el sonido de un bloque. Si tu sonido personalizado de yunque parece seguirte a todas partes, es estéreo.

Un evento de sonido es un nombre, no un archivo

entity.pig.ambient es un evento. Se asigna a una lista de archivos, de los cuales se elige uno al azar cada vez. Reemplazar el sonido de un cerdo significa redefinir el evento, no dejar un archivo en algún lugar.

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

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

Tres detalles:

• replace: true descarta la lista vanilla. Si lo omites, tu sonido se añade a la piscina, así que suena a veces y el original suena otras. Ambos comportamientos son útiles; el predeterminado es añadir.
• Las rutas omiten sounds/ y .ogg. custom/my_pig se resuelve a assets/minecraft/sounds/custom/my_pig.ogg.
• sounds.json se encuentra en la raíz de assets/minecraft, no dentro de sounds/.

Opciones por archivo

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

• weight sesga la selección aleatoria dentro de la lista.
• stream: true para cualquier cosa de más de unos segundos — música y discos. Los archivos largos sin transmisión se cargan completamente en memoria y pueden bloquear el cliente.
• volume no puede superar 1.0. Más volumen significa un archivo de origen más fuerte.

Añadir un sonido completamente nuevo

Usa tu propio espacio de nombres para que nada colisione:

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

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

Luego /playsound my_pack:spell master @a ~ ~ ~ 1 1. Los eventos de sonido personalizados funcionan con /playsound, en tocadiscos mediante una definición de canción de tocadiscos, y en bloques de nota mediante el componente note_block_sound de una cabeza de jugador; no se adjuntan automáticamente a ninguna acción del juego.

Por qué queda en silencio

1. No es Ogg Vorbis real.
2. La ruta incluye sounds/ o .ogg.
3. sounds.json es JSON inválido — una coma final mata todo el archivo, así que todos los sonidos del paquete quedan en silencio, no solo el nuevo.
4. Un pack.mcmeta desactualizado — 26.x requiere min_format y max_format, y un paquete sin ellos aparece como incompatible.

Las hojas de referencia para la estructura de carpetas del paquete, la reasignación de eventos de sonido y las texturas animadas están en Resource Pack Reference Tools.

Referencia de paquetes de recursos →