Guides / Building & Resources

Замена звуков с помощью ресурс-пака: sounds.json и требование .ogg

Minecraft воспроизводит только Ogg Vorbis, а звуковое событие — это не файл. Здесь вы найдете файл сопоставления, узнаете, как добавить звук вместо замены, и почему ваш звук может быть беззвучным.

2026-06-25

Замена звуков чаще всего терпит неудачу без каких-либо уведомлений, чем любая другая функция ресурс-пака, и почти всегда это происходит по одной из двух причин: неправильный аудиоформат или непонимание того, что такое звуковое событие.

Только Ogg Vorbis

Minecraft воспроизводит .ogg (Vorbis) и ничего больше. Файл .mp3 или .wav, переименованный в .ogg, не будет воспроизводиться — контейнер должен быть именно Ogg.

Моно или стерео также имеет значение: только монофайлы позиционируются в 3D-пространстве. Стереофайл воспроизводится с постоянной громкостью повсюду, что подходит для музыки, но не для звука блока. Если ваш пользовательский звук Наковальни, кажется, следует за вами, значит, он стерео.

Звуковое событие — это имя, а не файл

entity.pig.ambient — это событие. Оно сопоставляется со списком файлов, один из которых выбирается случайным образом каждый раз. Замена звука Свиньи означает переопределение события, а не просто размещение файла где-то.

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

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

Три детали:

• replace: true отбрасывает ванильный список. Если его не указать, ваш звук добавляется в Бассейн, поэтому он будет воспроизводиться иногда, а оригинальный — в других случаях. Оба поведения полезны; по умолчанию происходит добавление.
• Пути не содержат sounds/ и .ogg. custom/my_pig преобразуется в assets/minecraft/sounds/custom/my_pig.ogg.
• sounds.json находится в корне assets/minecraft, а не внутри sounds/.

Настройки для каждого файла

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

• weight смещает случайный выбор в списке.
• stream: true для всего, что длится более нескольких секунд — музыка и пластинки. Непотоковые длинные файлы полностью загружаются в память и могут замедлить работу клиента.
• volume не может превышать 1.0. Более высокое значение означает более громкий исходный файл.

Добавление совершенно нового звука

Используйте собственное пространство имен, чтобы ничего не конфликтовало:

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

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

Затем /playsound my_pack:spell master @a ~ ~ ~ 1 1. Пользовательские звуковые события работают с /playsound и в нотных блоках через определение песни Проигрывателя; они не привязываются автоматически к каким-либо игровым действиям.

Почему он беззвучен

1. Не настоящий Ogg Vorbis.
2. Путь включает sounds/ или .ogg.
3. sounds.json является недействительным JSON — висячая запятая убивает весь файл, поэтому каждый звук в паке становится беззвучным, а не только новый.
4. Неправильный pack_format, поэтому пакет загружается, но ресурсы игнорируются.

Шпаргалки по структуре папок пакета, переназначению звуковых событий и анимированным текстурам находятся в Справочных инструментах для ресурс-паков.

Справочник по ресурспакам →