sounds.json

sounds.json（在基岩版中为sound_definitions.json）是一个由资源包的声音系统使用的文件。当一个或多个游戏内事件触发了一个声音事件时，声音系统会根据该文件的内容来决定播放哪个音效。该文件应该放置于资源包的assets/<命名空间>/目录下。在该文件中定义的声音事件可以通过形如<命名空间>:<声音事件名>的命名空间ID来调用。

游戏默认的该文件放置在.minecraft/assets/objects（基岩版在assets/resource_packs/vanilla/sounds）目录下，它的文件名可以在.minecraft/assets/indexes/<游戏版本>.json文件中查询。

文件结构

这个文件用JSON格式存储，但在这里使用NBT的图标来表示。

• 根对象。
  •  声音事件名: 一个声音事件。声音事件名通常是按照类别以点（.）分割的（例如entity.enderman.stare）。下方有表格列出了所有游戏自带的声音事件。（如果你想要为该声音事件设定minecraft以外的命名空间，应当把sounds.json文件放置在相应命名空间的目录下，而不是在这里定义。）
    •  replace: 可选。如果设定为true，在sounds中定义的音效列表会替换掉优先级更低的资源包中为该声音事件定义的音效。设定为false则会补充到原来的音效列表中，而不是直接替换。如果不指定，默认为false。
    •  subtitle: 可选。如果游戏中开启了“显示字幕”选项，游戏将会在该声音事件被播放时将该字符串翻译为声音字幕。
    •  sounds: 可选。该声音事件使用的音效文件列表。当该声音事件被触发时，游戏会从此列表定义的音效文件中随机选取一个播放。
      • 从assets/<命名空间>/sounds/文件夹到此音效文件的路径。应使用正斜线（/）分割路径。
      • 一个代表音效文件的对象。如果你需要定义更多参数的话再用这个对象定义，否则用上面的字符串格式即可。
        •  name: 从assets/<命名空间>/sounds/文件夹到此声音文件的路径，或着是另一个声音事件的命名空间ID。
        •  volume: 播放此声音时的音量。值为0.0到1.0的小数。未定义时默认为1.0。
        •  pitch: 以确定的值播放音调。未定义时默认为1.0。可以调至更高或更低。
        •  weight: 此声音事件触发时此声音被播放的概率。默认为1。例如，设为2相当于此文件在列表中出现两次。相反地，假设别的文件都没有更改此设置，设为0.5相当于别的文件在列表中都出现两次。
        •  stream: 设置为true则此声音会以流式播放。当声音较长时最好设为true来避免卡顿。所有的music和record分类的音效（除了音符盒）都使用流式播放，因为它们的长度都达到一分多钟（最长达八分多钟）。未指定则默认为false。
        •  attenuation_distance: 基于距离的音效大小衰减率。用于传送门、信标和潮涌核心。默认为16。
        •  preload: 若设置为true，则该音效文件会在加载资源包时就加载，而不是在播放音效的时候再加载。用于水下环境音效。默认为false。
        •  type: 可选sound或event。sound表明name中定义的是文件名，event表明name中定义的是声音事件名。未指定则默认为sound。

这里有sounds.json的pre-1.10范本。
这里有Dinnerbone关于此文件的编写规范。

声音事件

一个声音事件是和游戏事件联系在一起的。多个声音事件可能对应不同的游戏事件或属于不同的声音分类，但它们共用同一个声音文件。小部分的有效声音文件并没有出现于sounds.json，而其他则没有相对应的游戏事件。任何缺少游戏事件的声音事件都仅能通过/playsound命令播放。所有默认的声音事件，它们使用的声音，它们属于的类别，以及触发它们的游戏事件将在下表中列出。

Java版数据值

主条目：Sounds.json/Java版数据值

[编辑]

基岩版数据值

主条目：Sounds.json/基岩版数据值

[编辑]

方块声音种类

声音系统可以使被踩到、被放置、被破坏的方块产生相应的声音。

种类	所属方块	注解
布类	羊毛、仙人掌、蛋糕、地毯、火	火方块被破坏的声音是random.fizz而非dig.cloth。
草类	草方块、海绵、湿海绵、树叶、高草丛、蕨、枯萎的灌木、花、棕色蘑菇、红色蘑菇、TNT、小麦、甘蔗、睡莲、菌丝、藤蔓、胡萝卜、马铃薯、干草块、甜菜、土径、干海带块、标靶	海绵、TNT理论上不属于草，但还是发出草的声音。
作物类[仅Java版]	海带、海草、小麦、马铃薯、胡萝卜、甜菜根、下界疣
沙砾类	泥土、砂土、灰化土、沙砾、耕地、黏土块
石质类	石头、安山岩、磨制安山岩、闪长岩、磨制闪长岩、花岗岩、磨制花岗岩、圆石、基岩、金矿石、铁矿石、煤矿石、青金石矿石、青金石块、发射器、砂岩、黏性活塞、蜘蛛网、活塞、石质台阶、砖块、苔石、黑曜石、刷怪笼、红石线、钻石矿石、熔炉、高炉、烟熏炉、砂轮、切石机、圆石楼梯、石质压力板、红石矿石、石质按钮、唱片机、怪物蛋、石砖、砖块楼梯、石砖楼梯、下界砖栅栏、附魔台、酿造台、炼药锅、末地石、龙蛋、砂岩楼梯、绿宝石矿石、末影箱、绊线钩、绊线、命令方块、信标、所有墙、花盆、生物头颅、铁砧、下界石英矿石、石英块、石英楼梯、投掷器、陶瓦、屏障、海晶石、海晶石砖、暗海晶石、煤炭块、红砂岩楼梯、红砂岩台阶、岩浆块、混凝土、潜影盒、侦测器、所有失活的珊瑚方块、所有失活的珊瑚、所有失活的珊瑚扇、哭泣的黑曜石、重生锚	唱片机虽然发出石质类方块的音效，但是这种方块最好用斧破坏，而不是镐。
珊瑚类	所有珊瑚方块、所有珊瑚、所有珊瑚扇、蜜脾块	声音好似石质类方块和史莱姆方块的组合版。另蜜脾块理论上并不属于珊瑚，但它仍然发出珊瑚的声音。
金属类	动力铁轨、探测铁轨、金块、铁块、钻石块、铁轨、铁门、铁栏杆、绿宝石块、漏斗、红石块、激活铁轨、铁活板门、钟[仅基岩版]	钻石块、绿宝石块理论上并不属于金属，但它们实际上仍然发出金属的声音。
木质类	木板、木头、去皮原木、去皮木头、床、书架、火把、木质楼梯、箱子、工作台、梯子、告示牌、拉杆、木质压力板、红石火把、栅栏、南瓜、南瓜灯、红石中继器、木活板门、巨型蘑菇方块、西瓜、南瓜藤、西瓜藤、栅栏门、木质台阶、可可果、木质按钮、陷阱箱、测重压力板、红石比较器、阳光探测器、旗帜、木门、制图台、制箭台、锻造台、讲台、织布机、堆肥桶、营火、木桶、蜂巢、蜂箱	其中推荐使用镐来破坏测重压力板。
玻璃类	玻璃、冰、荧石、下界传送门方块、染色玻璃、玻璃板、末地传送门方块、染色玻璃板、海晶灯、浮冰、蓝冰、末地传送门框架、红石灯	这些方块在被踩踏和敲击的时候发出“石质类”的声音，并且很多“玻璃类”方块推荐用镐破坏，但是“玻璃类”方块与“石质类”方块的区别是——“玻璃类”方块在被破坏的那一霎那会发出清脆的玻璃碎裂的声音。
下界类	骨块、下界岩、玄武岩、磨制玄武岩、灵魂沙、灵魂土、诡异菌岩、绯红菌岩、下界砖块、下界砖楼梯、下界砖台阶、红色下界砖块、红色下界砖楼梯、红色下界砖台阶、下界合金块、下界疣块、诡异疣块、菌光体、下界金矿石、下界石英矿石、磁石、绯红菌柄、 诡异菌柄、绯红菌核、诡异菌核、远古残骸	包含各种下界方块中不同的音效。
其他	沙子：沙子、红沙、混凝土粉末 雪类：雪、雪块 竹子类：竹子、脚手架 灯笼类：灯笼、灵魂灯笼 史莱姆类：黏液块、海泡菜 铁砧类：铁砧、钟[仅Java版] 独有：蜂蜜块	铁砧和钟在行走和破坏时则发出石质方块的声音，只有在放置时才发出特殊的声音。

历史

Java版
1.7.2		13w42a			加入了sounds.json。
1.9		15w43a			更改了许多声音的id，之前的id可以从sounds.json/Java版1.9前上查看。
		15w43b			加入了“subtitle”字段。
		16w02a			加入了“voice”声音事件类别。
1.10					移除了“category”字段。
1.13		18w10a			加入了“preload”字段。
携带版
1.0.4		1.0.4.1			加入了sound_definitons.json。