Guides / Building & Resources

Kaynak paketiyle sesleri değiştirme: sounds.json ve .ogg gereksinimi

Minecraft yalnızca Ogg Vorbis çalar ve bir ses olayı bir dosya değildir. İşte eşleme dosyası, bir sesi değiştirmek yerine nasıl ekleneceği ve sizinkinin neden sessiz olduğu.

2026-06-25

Ses değiştirme, diğer kaynak paketi özelliklerinden daha sık sessizce başarısız olur ve bunun nedeni neredeyse her zaman iki şeyden biridir: yanlış ses formatı veya bir ses olayının ne olduğuna dair yanlış anlama.

Yalnızca Ogg Vorbis

Minecraft .ogg (Vorbis) çalar ve başka hiçbir şey çalmaz. .mp3 veya .wav olarak yeniden adlandırılmış bir .ogg çalmaz — kapsayıcının gerçekten Ogg olması gerekir.

Mono ve stereo da önemlidir: yalnızca mono dosyalar 3B uzayda konumlandırılır. Bir stereo dosya her yerde sabit ses seviyesinde çalar, bu müzik için doğru, blok sesi için yanlıştır. Özel örs sesiniz sizi takip ediyorsa, stereo demektir.

Bir ses olayı bir isimdir, bir dosya değil

entity.pig.ambient bir olaydır. Bir dosya listesine eşlenir ve her seferinde bunlardan biri rastgele seçilir. Bir domuz sesini değiştirmek, bir dosyayı bir yere bırakmak değil, olayı yeniden tanımlamak anlamına gelir.

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

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

Üç detay:

• replace: true vanilya listesini atar. Bunu dışarıda bırakırsanız sesiniz havuza eklenir, böylece bazen çalar, bazen de orijinali çalar. Her iki davranış da kullanışlıdır; varsayılan eklemedir.
• Yollar sounds/ ve .ogg içermez. custom/my_pig, assets/minecraft/sounds/custom/my_pig.ogg olarak çözümlenir.
• sounds.json, assets/minecraft kökünde bulunur, sounds/ içinde değil.

Dosya başına seçenekler

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

• weight listedeki rastgele seçimi etkiler.
• stream: true birkaç saniyeden uzun her şey için — müzik ve plaklar. Akışsız uzun dosyalar belleğe tamamen yüklenir ve istemciyi durdurabilir.
• volume 1.0'ı aşamaz. Daha yüksek, daha yüksek bir kaynak dosya anlamına gelir.

Yepyeni bir ses ekleme

Çakışmaları önlemek için kendi ad alanınızı kullanın:

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

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

Ardından /playsound my_pack:spell master @a ~ ~ ~ 1 1. Özel ses olayları /playsound ile ve müzik kutusu şarkı tanımı aracılığıyla nota bloklarında çalışır; otomatik olarak herhangi bir oyun eylemine bağlanmazlar.

Neden sessiz

1. Gerçek Ogg Vorbis değil.
2. Yol sounds/ veya .ogg içeriyor.
3. sounds.json geçersiz JSON — sondaki bir virgül tüm dosyayı öldürür, bu nedenle paketteki her ses sessizleşir, sadece yeni olan değil.
4. Yanlış pack_format, bu nedenle paket yüklenir ancak varlıklar yok sayılır.

Paket klasör yapısı, ses olayı yeniden eşlemesi ve animasyonlu dokular için kopya kağıtları Kaynak Paketi Referans Araçları bölümünde bulunmaktadır.

Kaynak paketi başvuru araçları →