Guides / Building & Resources

Mengganti suara dengan paket sumber daya: sounds.json dan persyaratan .ogg

Minecraft hanya memutar Ogg Vorbis, dan event suara bukanlah sebuah file. Berikut adalah file pemetaan, cara menambahkan suara alih-alih mengganti, dan mengapa suara Anda senyap.

2026-06-25

Penggantian suara sering kali gagal tanpa pemberitahuan dibandingkan fitur paket sumber daya lainnya, dan hampir selalu disebabkan oleh salah satu dari dua hal: format audio yang salah, atau kesalahpahaman tentang apa itu event suara.

Hanya Ogg Vorbis

Minecraft memutar .ogg (Vorbis) dan tidak ada yang lain. File .mp3 atau .wav yang diganti namanya menjadi .ogg tidak akan diputar — kontainernya harus benar-benar Ogg.

Mono versus stereo juga penting: hanya file mono yang diposisikan dalam ruang 3D. File stereo diputar dengan volume konstan di mana-mana, yang tepat untuk musik dan salah untuk suara blok. Jika suara paron kustom Anda seolah-olah mengikuti Anda, itu adalah stereo.

Event suara adalah nama, bukan file

entity.pig.ambient adalah sebuah event. Ini memetakan ke daftar file, salah satunya dipilih secara acak setiap kali. Mengganti suara babi berarti mendefinisikan ulang event, bukan menjatuhkan file di suatu tempat.

assets/minecraft/
├── sounds.json
└── sounds/custom/my_pig.ogg

{
  "entity.pig.ambient": {
    "replace": true,
    "sounds": [ "custom/my_pig" ]
  }
}

Tiga detail:

• replace: true membuang daftar vanilla. Jika dihilangkan, suara Anda ditambahkan ke Kolam, sehingga kadang-kadang diputar dan yang asli diputar di lain waktu. Kedua perilaku ini berguna; defaultnya adalah menambah.
• Jalur tidak menyertakan sounds/ dan .ogg. custom/my_pig akan mengarah ke assets/minecraft/sounds/custom/my_pig.ogg.
• sounds.json berada di root assets/minecraft, bukan di dalam sounds/.

Opsi per-file

"sounds": [
  { "name": "custom/my_pig", "volume": 0.8, "pitch": 1.2, "weight": 3, "stream": false }
]

• weight memengaruhi pemilihan acak dalam daftar.
• stream: true untuk apa pun yang berdurasi lebih dari beberapa detik — musik dan rekaman. File panjang yang tidak di-stream dimuat sepenuhnya ke memori dan dapat membuat klien macet.
• volume tidak boleh melebihi 1.0. Lebih keras berarti file sumber yang lebih keras.

Menambahkan suara baru

Gunakan namespace Anda sendiri agar tidak ada yang bertabrakan:

assets/my_pack/sounds.json
assets/my_pack/sounds/spell.ogg

{ "spell": { "sounds": ["spell"] } }

Kemudian /playsound my_pack:spell master @a ~ ~ ~ 1 1. Event suara kustom berfungsi dengan /playsound dan di blok nada melalui definisi lagu Kotak Lagu; mereka tidak secara otomatis terhubung ke tindakan game apa pun.

Mengapa senyap

1. Bukan Ogg Vorbis asli.
2. Jalur menyertakan sounds/ atau .ogg.
3. sounds.json adalah JSON yang tidak valid — koma di akhir akan merusak seluruh file, sehingga setiap suara dalam paket menjadi senyap, bukan hanya yang baru.
4. pack_format salah, sehingga paket dimuat tetapi aset diabaikan.

Lembar contekan untuk struktur folder paket, pemetaan ulang event suara, dan tekstur animasi ada di Alat Referensi Paket Sumber Daya.

Rujukan paket sumber daya →