本站文本内容除另有声明外,均在知识共享 署名-非商业性使用-相同方式共享 3.0 协议下提供。(详细信息…

Sounds.json

来自Minecraft Wiki
跳转至: 导航搜索

sounds.json是一个资源包的音效系统所使用的文件,主要作用为当一个声音事件被游戏事件触发时告知音效系统应当播放哪个声音文件。这个文件处于资源包内的assets\minecraft,而游戏的默认文件则保存于.minecraft\assets\objects中,而且它的散列名称可以在.minecraft\assets\indexes\<对应版本>.json 中查找到。

文件结构[编辑 | 编辑源代码]

这个文件用JSON格式存储,但在这里使用NBT表示。


  • 根对象。

    • 声音事件。这个对象的名字是声音事件的名称,通常是仿照其路径(如“random.break”)。下表列出了所有默认声音事件。

      •  category: 这个声音事件的类别。有效类别名称是“ambient”(环境)、“weather”(天气)、“player”(玩家)、“neutral”(中立)、“hostile”(敌意)、“block”(方块)、“record”(唱片)、“music”(音乐)和“master”(控制)。这个字符串可让声音系统知道每个声音事件对应的类别,然后根据类别的音量设置调整播放音量。

      •  replace: true或false。仅用于资源包。当sounds列出的声音需要替换默认sounds.json中此声音事件对应声音时为true。当列出的声音应添加至默认声音列表时为false。可选。未定义时默认使用false。 在1.7.6-pre1以前的版本中,此String因一个漏洞而被忽略。

      •  sounds: 此声音事件使用的声音文件。此声音事件触发时将随机选择列出的声音。可选。

        • “sounds”文件夹到某声音文件的路径。应使用正斜线符号(/)。

        • 声音文件。此对象需要额外字符串。

          •  name: “sounds”到此声音文件的路径。应使用正斜线符号(/)。也可以是另一声音事件的名称。

          •  volume: 播放此声音时的音量。值为0.0到1.0的小数。未定义时默认为1.0。

          •  pitch: 以确定的值播放音调。未定义时默认为1.0。可以调至更高或更低。

          •  weight: 此声音事件触发时此声音被播放的概率。默认为1。例如,设为2相当于此文件在列表中出现两次。相反地,假设别的文件都没有更改此设置,设为0.5相当于别的文件在列表中都出现两次。

          •  stream: true或false。当此声音应从它的文件中流播放时为true。当声音较长时最好设为true来避免延迟。所有除了音符盒外的“music”和“record”分类的声音都使用流播放,因为它们的长度都达到一分多钟。未定义时默认为false。

          •  type: 可选“sound”或“event”; “sound”从文件播放音乐,“event”从已定义的事件播放音乐。未定义时默认为“sound”。

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

声音事件[编辑 | 编辑源代码]

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

Java版数据值

1.9前的数据值

基岩版数据值

方块声音种类[编辑 | 编辑源代码]

声音系统可以使被踩到、被放置、被破坏的方块产生相应的声音。 具有特殊音效的粘液块没有被列在下表中。

种类 所属方块 注解
布类 羊毛仙人掌蛋糕地毯
草方块海绵湿海绵树叶高草丛枯死的灌木棕色蘑菇红色蘑菇TNT小麦甘蔗睡莲菌丝藤蔓胡萝卜马铃薯干草块甜菜草径 其中小麦种子甜菜种子、睡莲、胡萝卜和马铃薯在被玩家放置时不会产生声音。
沙砾类 泥土砂土灰化土沙砾耕地粘土块
沙子类 沙子红沙灵魂沙
雪类 雪块
石制类 石头安山岩、磨制安山岩、闪长岩、磨制闪长岩、花岗岩、磨制花岗岩、圆石基岩金矿石铁矿石煤矿石青金石矿石青金石块发射器砂岩音符盒充能铁轨探测铁轨粘性活塞蜘蛛网活塞金块铁块、石质台阶、砖块苔石黑曜石刷怪箱红石线钻石矿石钻石块熔炉铁轨、圆石楼梯、石制压力板、铁门红石矿石、石质按钮、唱片机地狱岩怪物蛋石砖铁栏杆、砖块楼梯、石砖楼梯、地狱砖块地狱砖栅栏、地狱砖楼梯、地狱疣附魔台酿造台炼药锅末地石龙蛋红石灯、砂岩楼梯、绿宝石矿石末影箱绊线钩绊线绿宝石块命令方块信标圆石墙花盆生物头颅铁砧下界石英矿石漏斗石英块红石块、下界石英楼梯、激活铁轨投掷器陶瓦屏障铁活板门海晶石海晶石砖暗海晶石煤炭块、红砂岩楼梯、红砂岩台阶、石材切割机染色粘土下界反应核 音符盒和唱片机虽然发出石制类方块的音效,但是这两种方块最好用破坏,而不是。、红石线、铁门和地狱疣在被放置时不会有声音产生。
木质类 木板木头书架火把、木质楼梯、箱子工作台梯子告示牌拉杆、木质压力板、红石火把栅栏南瓜南瓜灯红石中继器、木活板门、巨型蘑菇方块、西瓜、南瓜藤、西瓜藤、栅栏门、木质台阶、可可果、木质按钮、陷阱箱测重压力板红石比较器阳光传感器旗帜木门 其中推荐使用镐来破坏测重压力板、火被破坏时的声音是随机的,可用手扑灭,灭火时发出“嘶嘶”的响声、床、瓜藤、可可果、旗帜和木门在被放置时没有声音产生
玻璃类 玻璃荧石下界传送门方块染色玻璃玻璃板末地传送门方块染色玻璃板海晶灯浮冰末地传送门框架 这些方块在被踩踏和敲击的时候发出“石质类”的声音,并且很多“玻璃类”方块推荐用镐破坏,但是“玻璃类”方块与“石制类”方块的区别是——“玻璃类”方块在被破坏的那一霎那会发出清脆的玻璃碎裂的声音。

历史[编辑 | 编辑源代码]

正式版本
1.7.2 13w42a 增加了 sounds.json