sounds.json

sounds.json（基岩版稱sound_definitions.json）是一個資源包的音效系統所使用的文件，主要作用為當一個聲音事件被遊戲事件觸發時告知音效系統應當播放哪個聲音文件。這個文件處於資源包內的assets\minecraft，而遊戲的預設文件則保存於.minecraft\assets\objects中，而且它的散列名稱可以在.minecraft\assets\indexes\<对应版本>.json 中查找到。

文件結構

這個文件用JSON格式存儲，但在這裡使用NBT表示。

• 
  根對象。
  • 
     聲音事件: 聲音事件通常是按照能容分類(例如entity.enderman.stare)。下表列出了所有遊戲預設的聲音事件。（獲得和minecraft不同的namespace需要在不同的namespace內，但這裡並沒說明這點。）
    • 
       replace: 這僅能在加載資源包時使用。「true」情況下，在「聲音」中的聲音列表替換遊戲預設聲音。「false」情況下，列出的聲音應添加至遊戲預設聲音列表中的，「true」和「false」是可選的。在不做更改的情況下，遊戲預設為「false」。
    • 
       subtitle: 可選，如果字幕已被啟動，這將用於翻譯聲音字幕。
    • 
       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。
        • 
           attenuation_distance: Modify sound reduction rate based on distance. 這用於傳送門，烽火台和海靈核心。
        • 
           preload: true或false. 如果這聲音應該在加載包時加載，則為true。 當這聲音被加載時這為false。這將用於水下環境，預設為false
        • 
           type: 可選「sound」或「event」; 「sound」從文件播放音樂，「event」從已定義的事件播放音樂。未定義時預設為「sound」。

這裡有sounds.json的pre-1.10範本。
這裡有Dinnerbone關於此文件的編寫規範。

聲音事件

一個聲音事件是和遊戲事件聯繫在一起的。多個聲音事件可能對應不同的遊戲事件或屬於不同的聲音分類，但它們共用同一個聲音文件。小部分的有效聲音文件並沒有出現於sounds.json，而其他則沒有相對應的遊戲事件。任何缺少遊戲事件的聲音事件都僅能通過/playsound指令播放。所有預設的聲音事件，它們使用的聲音，它們屬於的類別，以及觸發它們的遊戲事件將在下表中列出。

Java版數據值

主條目：Sounds.json/Java版數據值

[ 編輯 ]

基岩版數據值

主條目：Sounds.json/基岩版數據值

[ 編輯 ]

方塊聲音種類

聲音系統可以使被踩到、被放置、被破壞的方塊產生相應的聲音。 具有特殊音效的史萊姆方塊沒有被列在下表中。

種類	所屬方塊	註解
布類	羊毛、仙人掌、蛋糕、地毯、火	火方塊被破壞的聲音是隨機生成的，fizz instead of dig.cloth.
草類	草地、海綿、濕海綿、樹葉、芒草、蕨、枯灌木、花、棕色蘑菇、紅色蘑菇、TNT、小麥、甘蔗、荷葉、菌絲土、藤蔓、胡蘿蔔、馬鈴薯、乾草捆、甜菜、草徑	其中小麥種子、甜菜種子、荷葉、胡蘿蔔和馬鈴薯在被玩家放置時不會產生聲音。
礫石類	泥土、粗泥、灰壤、礫石、耕地、黏土塊
沙類	沙、紅沙、靈魂砂、混凝土粉末
雪類	雪、雪塊
石制類	石頭、安山岩、拋光安山岩、閃長岩、拋光閃長岩、花崗岩、拋光花崗岩、鵝卵石、基岩、金礦、鐵礦、煤礦、青金石礦、青金石磚、發射器、砂岩、黏性活塞、蜘蛛網、活塞、石製半磚、紅磚、青苔鵝卵石、黑曜石、生怪磚、紅石線、鑽石礦、熔爐、鵝卵石階梯、石制壓力板、紅石礦、石製按鈕、唱片機、地獄石、怪物蛋、石磚、紅磚階梯、石磚階梯、地獄磚、地獄磚柵欄、地獄磚階梯、地獄疙瘩、附魔台、釀造台、鍋釜、終界石、龍蛋、紅石燈、砂岩階梯、綠寶石礦、終界箱、絆線鈎、絆線、指令方塊、烽火台、鵝卵石牆、花盆、生物頭顱、鐵砧、地獄石英礦、石英磚、石英階梯、投擲器、陶土、屏障、海磷石、海磷石磚、暗海磷石、煤炭磚、紅砂岩階梯、紅砂岩半磚、岩漿塊、混凝土、界伏盒、觀察者	唱片機雖然發出石制類方塊的音效，但是這種方塊最好用斧破壞，而不是鎬。
金屬類	動力鐵軌、感測鐵軌、金磚、鐵磚、鑽石磚、鐵軌、鐵門、鐵柵欄、綠寶石磚、漏斗、紅石磚、觸發鐵軌、鐵製地板門	鑽石磚、綠寶石磚理論上並不屬於金屬，但它們實際上仍然發出金屬的聲音。
木質類	木材、木塊、床、書櫃、火把、火、木質階梯、儲物箱、工作台、梯子、告示牌、控制桿、木質壓力板、紅石火把、柵欄、南瓜、南瓜燈、紅石中繼器、木地板門、巨型蘑菇方塊、西瓜、南瓜藤、西瓜藤、柵欄門、木質半磚、可可豆、木質按鈕、陷阱儲物箱、測重壓力板、紅石比較器、日光感測器、旗幟、木門	其中推薦使用鎬來破壞測重壓力板、火被破壞時的聲音是隨機的，可用手撲滅，滅火時發出「嘶嘶」的響聲、床、瓜藤、可可豆、旗幟和木門在被放置時沒有聲音產生。
玻璃類	玻璃、冰、螢光石、地獄傳送門方塊、染色玻璃、玻璃片、終界傳送門方塊、染色玻璃片、海燈籠、冰磚、終界傳送門框架	這些方塊在被踩踏和敲擊的時候發出「石製類」的聲音，並且很多「玻璃類」方塊推薦用鎬破壞，但是「玻璃類」方塊與「石制類」方塊的區別是——「玻璃類」方塊在被破壞的那一霎那會發出清脆的玻璃碎裂的聲音。

歷史

Java版
1.7.2		13w42a			加入了sounds.json。
1.9		15w43b			加入了 "subtitle" 字段。
		?			更改了許多聲音的id，之前的id可以從sounds.json/Java版1.9前上查看。
		16w02a			加入了「voice」聲音事件類別。
1.10					移除了「category」區域
1.13		18w10a			加入了「preload」字段。
攜帶版
1.0		?			加入了sound_definitons.json。