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。