Guides / Building & Resources

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

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

2026-06-25

El reemplazo de sonidos falla silenciosamente con más frecuencia que cualquier otra característica de los paquetes de recursos, y casi siempre se debe a una de dos cosas: el formato de audio incorrecto o una mala interpretación de lo que 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.

La diferencia entre mono y 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 el sonido de tu yunque personalizado parece seguirte, es estéreo.

Un evento de sonido es un nombre, no un archivo

entity.pig.ambient es un evento. Se mapea a una lista de archivos, uno de los cuales se elige al azar cada vez. Reemplazar un sonido de cerdo significa redefinir el evento, no soltar 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 de sonidos predeterminada (vanilla). Si lo omites, tu sonido se añade a la piscina, por lo que se reproduce a veces y el original se reproduce otras. Ambos comportamientos son útiles; el valor predeterminado es añadir.
• Las rutas omiten sounds/ y .ogg. custom/my_pig se resuelve como assets/minecraft/sounds/custom/my_pig.ogg.
• sounds.json se encuentra en la raíz 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 que dure más de unos pocos segundos: música y discos. Los archivos largos no transmitidos se cargan completamente en la memoria y pueden bloquear el cliente.
• volume no puede exceder 1.0. Más alto significa un archivo de origen más ruidoso.

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 y en los bloques de notas a través de una definición de canción de tocadiscos; no se adjuntan automáticamente a ninguna acción del juego.

Por qué está en silencio

1. No es un Ogg Vorbis real.
2. La ruta incluye sounds/ o .ogg.
3. sounds.json es un JSON inválido; una coma al final anula todo el archivo, por lo que cada sonido del paquete se silencia, no solo el nuevo.
4. pack_format incorrecto, por lo que el paquete se carga pero los recursos se ignoran.

Las hojas de trucos para la estructura de carpetas del paquete, el remapeo de eventos de sonido y las texturas animadas se encuentran en las Herramientas de referencia del paquete de recursos.

Referencia de paquetes de recursos →