sounds.json

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

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

文件结构[]

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

Java版[]

：根对象。
- 声音事件名：一个声音事件。声音事件名通常是按照类别以点（.）分割的（例如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相当于此文件在列表中出现两次。
      - stream：设置为true则此声音会以流式播放。当声音较长时最好设为true来避免卡顿。所有的music和record分类的音效（除了音符盒）都使用流式播放，因为它们的长度都达到一分多钟（最长达八分多钟）。未指定则默认为false。
      - attenuation_distance: 基于距离的音效大小衰减率。用于传送门、信标和潮涌核心。默认为16。
      - preload：若设置为true，则该音效文件会在加载资源包时就加载，而不是在播放音效的时候再加载。用于水下环境音效。默认为false。
      - type：可选sound或event。file表明name中定义的是文件名，event表明name中定义的是声音事件名。未指定则默认为sound。

sounds.json的pre-1.10范本。

Dinnerbone的关于此文件的编写规范。

基岩版[]

`sound_definitions.json`或`music_definitions.json`[]

: 根对象。
- format_version：当前值为1.14.0，表示自村庄与掠夺以来使用的标准格式。
- sound_definitions：对声音事件的定义。
  - ：单个声音事件，通常会分为一类（例如mob.endermen.stare或step.stone）。默认的声音事件会在下方列出。
    - category：控制声音音量滑条的分类。master、music、record、weather、hostile、neutral、player、block、bucket、bottle、ambient、voice、sound。默认值为sound。
    - min_distance：声音开始衰减的距离。默认值为0。
    - max_distance：声音完全听不见的距离。默认值为16。
    - min_delay：声音事件触发后经过多长时间才会播放（最小值），单位为秒。只有music_definitions.json才会使用此参数。默认值为0。
    - max_delay：声音事件触发后经过多长时间才会播放（最大值），单位为秒。只有music_definitions.json才会使用此参数。默认值为0。
    - sounds：声音事件所使用的具体音效。
      - name：该音效在资源包中的路径（不包含拓展名）。若详细定义了每个音效的具体参数，则会使用下方的组件。
      - name：该音效在资源包中的路径（不包含拓展名）。
        
        stream：当该声音为流式播放时为true。默认值为false。
        
        is3D：是否以立体声播放。
        
        volume：声音的音量。默认值为1.0。可以是一个区间以表示范围。
        
        pitch：声音的音高。默认值为1.0。可以是一个区间以表示范围。
        
        weight：声音的权重，即触发该音效时间后单个声音会被播放的概率，例如值为2时相当于将该音效重复定义了1次。默认值为1。
        
        load_on_low_memory：是否预载。预载的音效可以在低内存设备上播放。
    - subtitle：未使用的值。

`sounds.json`[]

: 根对象。
- ：声音事件的集合名。值可以是individual_event_sounds、block_sounds、entity_sounds、interactive_sounds。
  - ：二级集合名，用于表示某一类方块的共同音效集合，例如stone和wood。
    - volume：声音的音量。默认值为1.0。可以是一个区间以表示范围。
    - pitch：声音的音高。默认值为1.0。可以是一个区间以表示范围。
    - events：具体的声音事件命名空间ID的集合。
      - ：系统音效类型，例如item.use.on。默认值和声音事件命名空间ID保持一致。
        sound：单个声音事件命名空间ID，例如use.stone。作为简写，该参数有时候会直接以命名空间ID为值。
        volume：声音的音量。默认值为1.0。可以是一个区间以表示范围。此值与二级集合的同一参数为乘积关系，以表示该声音最终的音量。
        
        pitch：声音的音高。默认值为1.0。可以是一个区间以表示范围。此值与二级集合的同一参数为乘积关系，以表示该声音最终的音高。

声音事件[]

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

Java版数据值

[编辑]

基岩版数据值

[编辑]

方块声音种类[]

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

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

↑ MC-91091

历史[]

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]
1.13	18w10a	加入了“preload”字段。
携带版
1.0.4	1.0.4.1	加入了sounds.json、sound_definitons.json和music_definitons.json。