ZeMusic — Minecraft Sunucunuza Gerçek Müzik Getirin!

ZeMusic, sunucunuzdaki .ogg ses dosyalarını otomatik olarak
analiz edip Minecraft'ın nota blok sistemine dönüştüren gelişmiş
bir Paper eklentisidir. TarsosDSP kütüphanesi ve YIN pitch
detection algoritması ile gerçek müzik analizi yaparak notaları
tespit eder ve oyunculara gecikme yaratmadan sunar.

WorldGuard entegrasyonu sayesinde belirli bölgelere girince
otomatik olarak müzik çalmaya başlar, çıkınca durur — hiçbir
oyuncu müdahalesi gerekmez.

================================================================
ÖZELLİKLER
================================================================

• OGG & MP3 → Nota Bloğu Dönüşümü
- .ogg ve .mp3 ses dosyalarını doğrudan analiz eder
- YIN algoritmasıyla frekans tespiti yapar
- Frekansları en yakın Minecraft nota adımına çevirir
- Sessizlik bölgelerini otomatik algılar (config'den ayarlanır)
- Dahili VorbisSPI, JOrbis, MP3SPI ve Tritonus decoder'ları içerir
- Analiz sonuçları JSON olarak cache'lenir; aynı dosya
tekrar analiz edilmez (MD5 hash ile doğrulama)
- Desteklenen enstrümanlar: Harp, Bas Gitar, Bas Davul,
Davul, Ksylofon, Demir Ksylofon, Gitar, Flüt, Zil,
Çıngırak, Bit, Banjo, Pling

• Performanslı Çalma Motoru
- Tek merkezi pulse scheduler — her şarkı için ayrı task açılmaz
- Aynı tick'teki tüm notalar tek döngüde gönderilir (batched)
- Oyuncuya özel ve WorldGuard bölge bazlı çalma modları
- Eşzamanlı oturum limiti (varsayılan: 15) — TPS koruması
- Aynı şarkının nota dizisi paylaşılır, kopyalanmaz (bellek tasarrufu)

• WorldGuard Bölge Entegrasyonu (Opsiyonel)
- Soft-dependency: WorldGuard yoksa eklenti sorunsuz çalışır
- Bölge → şarkı eşlemesi config ile yapılır
- Hafif hareket cache'i + periyodik bölge kontrolü
(PlayerMoveEvent'te ağır sorgu yapılmaz!)
- Bölgeye giriş → müzik başlar | çıkış → müzik durur

• TPS & Sunucu Performansı Koruması
- Tüm OGG analizi ve dosya I/O tamamen async thread'de
- Ana thread sadece nota gönderimi için kullanılır
- WorldGuard bölge sorguları cache'lenir (chunk bazlı, 1s TTL)
- Oyuncu ayrılınca tüm map girdileri temizlenir (bellek sızıntısı yok)

================================================================
KURULUM
================================================================

1. ZeMusic-1.0.0.jar dosyasını plugins/ klasörüne kopyalayın.
2. Sunucuyu yeniden başlatın veya /reload komutunu kullanın.
3. plugins/ZeMusic/musics/ klasörüne .ogg dosyalarınızı atın.
4. /zemusic scan komutunu çalıştırın.
5. /zemusic list ile yüklenen şarkıları kontrol edin.
6. /zemusic play <sarki.json> ile test edin.

WorldGuard Bölge Müziği Kurulumu:
1. plugins/ZeMusic/config.yml dosyasını açın.
2. worldguard.bolgeler bölümüne WorldGuard bölge adı ve
şarkı JSON adını eşleştirin:

worldguard:
otomatik_bolge_muzigi: true
bolgeler:
spawn_bolgesi: "hosgeldin_muzigi.json"
arena_bolgesi: "savas_muzigi.json"

3. Sunucuyu yeniden başlatın veya /zemusic reload çalıştırın.

================================================================
KOMUTLAR & YETKİLER
================================================================

Tüm komutlar zemusic.admin yetkisi gerektirir.
Varsayılan: OP oyuncular

Komut | Açıklama
-----------------------------------|----------------------------------
/zemusic scan | OGG dosyalarını analiz et
/zemusic play <sarki.json> | Kendine şarkı çal
/zemusic play <sarki.json> <oyuncu>| Oyuncuya şarkı çal
/zemusic stop | Kendi müziğini durdur
/zemusic stop <oyuncu> | Oyuncunun müziğini durdur
/zemusic stop <bölge> | Bölge müziğini durdur
/zemusic list | Şarkıları ve oturumları listele
/zemusic reload | Config'i yeniden yükle

Takma ad: /zm (örn: /zm play muzik.json)

Yetki Düğümü:
- zemusic.admin → Tüm komutlara tam erişim (varsayılan: op)

================================================================
CONFIG.YML AÇIKLAMASI
================================================================

settings:
prefix: "..." # Mesaj öneki (MiniMessage formatı)
musics_klasoru: "musics" # OGG ve cache klasörü adı
sessizlik_esigi_db: -40.0 # Bu dB altı sessizlik sayılır (nota çalınmaz)
varsayilan_enstruman: "harp" # Varsayılan Minecraft enstrümanı

worldguard:
otomatik_bolge_muzigi: true # Bölge müziğini aktif et/kapat
bolgeler: # WorldGuard bölge adı → şarkı JSON adı
ornek_bolge: "ornek.json"

performans:
max_es_zamanli_calma: 15 # Aynı anda en fazla kaç oturum açılabilir
bolge_kontrol_araligi_tick: 10 # WorldGuard bölge sorgusunun periyodu (tick)
playback_pulse_araligi_tick: 1 # Merkezi çalma pulse'u periyodu (tick)
tarsos_buffer_size: 2048 # TarsosDSP analiz buffer boyutu
tarsos_hop_size: 512 # TarsosDSP hop boyutu

================================================================
WORLDGUARD ENTEGRASYONU
================================================================

ZeMusic, WorldGuard ile isteğe bağlı olarak çalışır (soft-depend).
WorldGuard kurulu değilse eklenti sorunsuz çalışmaya devam eder;
sadece otomatik bölge müziği özelliği devre dışı kalır.
Admin /zemusic play komutunu her zaman kullanabilir.

Desteklenen WorldGuard Sürümü: 7.0.9+

Bölge Müziği Nasıl Çalışır?
- Oyuncu bir WorldGuard bölgesine girdiğinde, config'de o bölgeye
eşlenmiş şarkı otomatik başlar.
- Oyuncu bölgeden çıktığında şarkı durur.
- Performans için: her blok hareketinde değil, her 10 tick'te bir
bölge sorgusu yapılır (bolge_kontrol_araligi_tick ayarı).

================================================================
GEREKSİNİMLER
================================================================

✔ Paper 1.21.1 (veya üzeri)
✔ Java 21 (veya üzeri)
✔ WorldGuard 7.0.9+ (opsiyonel — bölge müziği için)

NOT: Spigot/CraftBukkit desteklenmez. Yalnızca Paper.

================================================================
DESTEK & İLETİŞİM
================================================================

Website: https://neonyy.zya.me
Yapımcı: Neony

Hata bildirimi ve önerileriniz için yukarıdaki web sitesini
ziyaret edebilir veya SpigotMC profil sayfama mesaj atabilirsiniz.

Eklentiyi beğendiyseniz kaynak sayfasından olumlu yorum
bırakırsanız sevinirim! ★★★★★

================================================================