ItemShuffleRoyale

Türkçe Anlatım

Spigot/Paper için tur bazlı item avı battle royale mini oyunu.

Eklenti YusufTe için yapılmıştır.

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üzenleyebilirsiniz.

Explanation in English

A round-based item-hunt battle royale minigame for Spigot/Paper (Java 21, Minecraft API 1.21).

What is it?

Every round, each living player is assigned a random target item. Find it before the timer runs out and you advance to the next round; fail and you are eliminated to spectator. The last survivor wins. All in-game text is Turkish.

A slot-machine style animation reveals each player's new target at the start of every round, and two special items help during the hunt:

• Skip item (default: Nether Star) — right-click to reroll your current target (cooldown + consumes one).
• Player compass (default: Compass) — right-click to cycle through and track other living players.

Live games are persisted, so a mid-game server restart is recovered automatically.

Commands & permissions

In-game command: /shuffle <start|stop|pause|resume|whitelist>

Subcommand	Description	Permission
start	Start a new game	itemshuffle.start
stop	Stop the running game	itemshuffle.stop
pause	Pause the current round timer	itemshuffle.pause
resume	Resume a paused round	itemshuffle.resume
whitelist	Open the whitelist editor GUI (remove items, save)	itemshuffle.whitelist

Base permission itemshuffle.use is required for the command itself. All permissions default to op.

Round duration scaling

The round timer shortens as the game goes on. Starting from duration_seconds, every duration_decrease_every_rounds rounds the duration drops by duration_decrease_seconds, never going below min_duration_seconds.

With the defaults (start 600 s, −60 s every 3 rounds, floor 180 s):

Rounds	Duration
1–3	10:00
4–6	9:00
7–9	8:00
…	…
19–21	4:00
22–24	3:00
25+	3:00 (fixed)

Set duration_decrease_every_rounds: 0 to keep the duration constant.

Configuration

All gameplay tuning lives in config.yml; every user-facing string lives in messages.yml. Each key in config.yml is documented with an inline comment above it. Summary:

round.*

Key	Meaning
duration_seconds	Starting round length (seconds).
duration_decrease_every_rounds	Shorten the round every N rounds (0 = never shorten).
duration_decrease_seconds	Seconds removed per decrease step (60 = 1 minute).
min_duration_seconds	Lowest the round length can drop to.
animation_duration_seconds	Length of the slot-machine target reveal animation.
animation_interval_ticks	Refresh interval of the animation (20 ticks = 1 s; lower = faster).
animation_sound	Sound played during the animation (Bukkit Sound name).
animation_sound_pitch_min	Pitch at the start of the animation.
animation_sound_pitch_max	Pitch at the end (pitch rises toward this as it progresses).

spawn_location.*

Key	Meaning
world	World players are teleported to each round (its own spawn point is used).

skip_item.* / compass_item.*

Key	Meaning
material	The item's Bukkit Material.
name	Display name (supports & color codes).
lore	Tooltip lines.
amount	(skip_item only) How many are given on game start.

whitelist

List of Bukkit Material names that can be chosen as targets. Edit it by hand or in-game with /shuffle whitelist.