YusufTe's Item Shuffle Royale

# ItemShuffleRoyale ## Türkçe Anlatım Spigot/Paper için tur bazlı item avı battle royale mini oyunu. ### Eklenti (https://www.youtube.com/@YusufTe) için yapılmıştır. <iframe width="560" height="315" src="https://www.youtube.com/embed/C59GCyZpoaA?si=VbtKX_u-sQtBscBF" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe> ## Nedir? Her turda, hayatta kalan her oyuncuya **rastgele bir hedef eşya** verilir. Süre dolmadan eşyayı bulan oyuncu bir sonraki tura geçer; bulamayan elenir ve izleyici olur. **Son kalan oyuncu kazanır.** Tüm oyun içi metinler Türkçedir. Her turun başında, oyuncunun yeni hedefini gösteren bir slot makinesi animasyonu oynar. Av sırasında iki özel eşya yardımcı olur: - **Atlama eşyası** (varsayılan: Nether Star) — sağ tıklayınca mevcut hedefi yeniden atar (bekleme süreli, 1 adet tüketir). - **Oyuncu pusulası** (varsayılan: Pusula) — sağ tıklayınca diğer canlı oyuncular arasında gezip onları takip eder. Devam eden oyun kaydedilir; oyun ortasında sunucu yeniden başlasa bile otomatik olarak kurtarılır. ## Komutlar ve yetkiler Oyun içi komut: `/shuffle <start|stop|pause|resume|whitelist>` | Alt komut | Açıklama | Yetki | |-------------|------------------------------------------------------|------------------------| | `start` | Yeni bir oyun başlatır | `itemshuffle.start` | | `stop` | Devam eden oyunu durdurur | `itemshuffle.stop` | | `pause` | Mevcut tur sayacını duraklatır | `itemshuffle.pause` | | `resume` | Duraklatılmış turu devam ettirir | `itemshuffle.resume` | | `whitelist` | Whitelist düzenleme arayüzünü açar (eşya çıkar, kaydet)| `itemshuffle.whitelist`| Komutun kendisi için temel `itemshuffle.use` yetkisi gerekir. Tüm yetkiler varsayılan olarak `op`'tur. ## Tur süresi ölçeklemesi Tur sayacı oyun ilerledikçe kısalır. `duration_seconds` değerinden başlayarak, her `duration_decrease_every_rounds` turda bir süre `duration_decrease_seconds` kadar azalır ve hiçbir zaman `min_duration_seconds` değerinin altına inmez. Varsayılan ayarlarla (başlangıç 600 sn, her 3 turde −60 sn, taban 180 sn): | Turlar | Süre | |--------|------| | 1–3 | 10:00 | | 4–6 | 9:00 | | 7–9 | 8:00 | | … | … | | 19–21 | 4:00 | | 22–24 | 3:00 | | 25+ | 3:00 (sabit) | Süreyi sabit tutmak için `duration_decrease_every_rounds: 0` yapın. ## Yapılandırma Tüm oyun ayarları `config.yml` içindedir; oyuncuya görünen her metin `messages.yml` içindedir. `config.yml` içindeki her anahtarın üstünde açıklayıcı bir yorum satırı vardır. Özet: ### `round.*` | Anahtar | Anlamı | |----------------------------------|------------------------------------------------------------------------| | `duration_seconds` | Turun başlangıç süresi (saniye). | | `duration_decrease_every_rounds` | Tur süresi her N turde bir azaltılır (`0` = hiç azalmaz). | | `duration_decrease_seconds` | Her azalma adımında düşülen saniye (60 = 1 dakika). | | `min_duration_seconds` | Tur süresinin inebileceği en düşük değer. | | `animation_duration_seconds` | Slot makinesi hedef belirleme animasyonunun süresi. | | `animation_interval_ticks` | Animasyonun yenilenme aralığı (20 tick = 1 sn; düşük = daha hızlı). | | `animation_sound` | Animasyon sırasında çalınan ses (Bukkit `Sound` adı). | | `animation_sound_pitch_min` | Animasyonun başındaki ses perdesi. | | `animation_sound_pitch_max` | Animasyonun sonundaki ses perdesi (ilerledikçe bu değere yükselir). | ### `spawn_location.*` | Anahtar | Anlamı | |---------|-----------------------------------------------------------------------------| | `world` | Her tur oyuncuların ışınlanacağı dünya (dünyanın kendi spawn noktası kullanılır). | ### `skip_item.*` / `compass_item.*` | Anahtar | Anlamı | |------------|-------------------------------------------------------| | `material` | Eşyanın Bukkit `Material` değeri. | | `name` | Görünen ad (`&` renk kodlarını destekler). | | `lore` | Açıklama (tooltip) satırları. | | `amount` | (yalnızca `skip_item`) Oyun başında verilecek adet. | ### `whitelist` Hedef olarak seçilebilecek Bukkit `Material` adlarının listesi. Elle ya da oyun içinde `/shuffle whitelist` ile dü