用资源包替换音效：sounds.json 与 .ogg 格式要求

Minecraft 只播放 Ogg Vorbis 格式，而音效事件并不是一个文件。本文将介绍映射文件、如何添加音效而非替换音效，以及你的音效为什么没有声音，只有单声道文件才有 3D 定位效果，立体声文件不管站哪播放音量都一样大。

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 }
]

使用你自己的命名空间，避免冲突：

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

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

然后 /playsound my_pack:spell master @a ~ ~ ~ 1 1。自定义音效事件可用于 /playsound、通过唱片机歌曲定义在唱片机中播放，以及通过玩家头部的 note_block_sound 组件在音符盒中播放；它们不会自动关联到任何游戏行为。

资源包文件夹结构、音效事件重映射和动画纹理的速查表请见资源包参考工具。