MaceArena

MaceArena, Minecraft sunucuları için geliştirilmiş bir Mace (Gürz) tabanlı arena minigame pluginidir. Oyuncular dairesel bir arenada toplanır, her turda bir çark dönerek avcı(lar) seçilir ve seçilen avcı(lar) diğer oyuncuları Mace ile avlamaya çalışır. Son hayatta kalan oyuncu kazanır. Plugin; dinamik arena oluşturma, çark animasyonu, round etkinlikleri, minigame modları, kategori sistemi, istatistik takibi ve tamamen yapılandırılabilir mesaj sistemi sunar.

• Çark Tabanlı Avcı Seçimi: Her turda döndürücü 3B Mace display entity animasyonu ile avcı seçilir. Çift gürz (%20) ve üç gürz (%10) şansı vardır.
• Dinamik Arena Oluşturma: Oyuncu sayısına göre yarıçap büyüyen/küçülen dairesel arena. Farklı temalar desteklenir (Simple, Classic, Nether, Crystal, Desert, Random).
• Arena Küçülmesi: Oyuncu elendikçe arena küçülerek oyunu hızlandırır; partiküller ve ses efektleri ile görsel geri bildirim sağlar.
• Round Kategori Sistemi: Her turda birden fazla kategori aynı anda aktif olabilir:
  • Zemin: Gök Gürültüsü, Buz Zemin, Görünmez Zemin, Kırılgan Zemin, Slime Zemin, Darbe Dalgası
  • Gürz: Altın Gürz, Patlayıcı Gürz, Manyetik Gürz, Mjolnir, Shockwave, WindBurst
  • Oyuncular: Yavaş Zaman, Hızlı Zaman, Zıplama Yok, Körlük, Hayalet
  • Avcı Sayısı: Normal, Çift, Üçlü
  • Kaos: Tüm kategoriler aynı anda aktif olur (%3 şans)
• Minigame Modları:
  • Mjolnir: Vuruş sonrası arenada rastgele noktalara şimşek çakar
  • Shockwave: Vuruş sonrası genişleyen dalga halkasıyla oyuncular savrulur
  • WindBurst: Sadece vurulan kişi havaya fırlatılır
• İstatistik Sistemi: SQLite tabanlı sezonluk ve toplam istatistik takibi (kazanma, kill, avcı seçilme, oynanan oyun, hayatta kalınan tur). Leaderboard desteği.
• Seyirci Modu: Aktif oyunları Spectator modunda izleme imkânı.
• Anti-Tekrar Sistemi: Son seçilen oyuncuları hatırlar ve tekrar seçmez.
• MiniMessage Desteği: Gradient, hex renk, bold ve tüm MiniMessage formatları ile tamamen özelleştirilebilir mesajlar (messages.yml).
• FancyHolograms Entegrasyonu: Opsiyonel hologram çark desteği (softdepend).
• Tam Tab Completion: Tüm komut ve alt komutlar için akıllı tab tamamlama.
• BossBar Zamanlayıcı: Av süresi boyunca BossBar ile geri sayım.
• Avcı Glow Efekti: Seçilen avcıya kırmızı glow efekti uygulanır.
• Wind Charge Desteği: Avcı, Wind Charge fırlatarak momentum kazanabilir.
• Düşüşten Hasar Yok: Arena içinde düşüş hasarı otomatik iptal edilir.

1. Arcenia-MaceArena-1.0.0.jar dosyasını sunucunuzun plugins/ klasörüne kopyalayın.
2. Sunucuyu başlatın veya yeniden başlatın. Plugin otomatik olarak config.yml ve messages.yml dosyalarını oluşturacaktır.
3. Oyun içinde arena spawn noktasını ayarlayın:

   /macearena admin setspawn
   

4. Lobi noktasını ayarlayın (oyuncular öldüğünde ve oyun bittiğinde bu noktaya döner):

   /macearena admin setlobby
   

5. Plugin kullanıma hazır! Oyuncular /macearena join ile katılabilir.

Oyuncu Komutları

Admin Komutları

Next Round Komutları

Bir sonraki turun ayarlarını önceden belirlemenizi sağlar:

config.yml

Plugin plugins/Arcenia-MaceArena/config.yml altında yapılandırma dosyası oluşturur. Başlıca bölümler:

Spawn ve Lobi

spawn:
  world: ""
  x: 0
  y: 0
  z: 0

lobby:
  world: ""
  x: 0
  y: 0
  z: 0
  yaw: 0
  pitch: 0

Oyun içinde /macearena admin setspawn ve /macearena admin setlobby komutlarıyla otomatik ayarlanır.

Arena Ayarları

arena:
  min-radius: 5          # Minimum yarıçap (blok)
  max-radius: 15         # Maksimum yarıçap (blok)
  base-radius: 5         # Başlangıç yarıçapı
  growth-per-player: 1   # Her oyuncu başına eklenen yarıçap
  growth-cap-players: 10  # Bu sayıdan sonra büyüme durur
  theme: "default"       # Arena teması: default, classic, nether, crystal, desert, random
  spectate-padding: 10   # Seyirci konum ofseti
  spectate-height: 6     # Seyirci yükseklik ofseti

Oyun Ayarları

game:
  min-players-to-start: 2  # Başlamak için gereken minimum oyuncu
  max-players: 10           # Maksimum oyuncu sayısı
  hunt-duration: 20         # Avcının avlama süresi (saniye)
  double-mace-chance: 0.20  # Çift gürz gelme şansı (%20)
  triple-mace-chance: 0.10  # Üç gürz gelme şansı (%10)
  spin-duration-ticks: 80   # Çark dönme süresi (tick)
  spin-extra-rotations: 4   # Seçimden önce ek tur sayısı
  end-delay-ticks: 100      # Oyun bittikten sonra lobiye dönüş gecikmesi
  round-delay-ticks: 60     # Tur arası bekleme süresi

Round Event Ayarları

Her efekt ayrı ayrı etkinleştirilebilir, ağırlık (weight) değeri kategori içindeki seçim olasılığını belirler:

round-events:
  enabled: true
  chance: 0.25        # Varsayılan şans (fallback)

  thunder:
    enabled: true
    weight: 1.15
    interval-ticks: 30
    duration-ticks: 120
    pre-warning-ticks: 20
    hit-radius: 2.4
    damage: 4.0

  ice-floor:
    enabled: true
    weight: 1.0

  hidden-floor:
    enabled: true
    weight: 1.2

  fragile-floor:
    enabled: true
    weight: 1.15

  slime-floor:
    enabled: true
    weight: 1.3

  pulse-wave:
    enabled: true
    weight: 1.0
    interval-ticks: 25
    radius: 6.0

  golden-mace:
    enabled: true
    weight: 1.0

  explosive-mace:
    enabled: true
    weight: 1.2
    tnt-fuse-ticks: 24
    tnt-yield: 2.0

  magnetic-mace:
    enabled: true
    weight: 1.25
  # ... ve diğer efektler

Kategori Ayarları

round-categories:
  enabled: true
  max-active-normal: 3    # Aynı anda aktif olabilecek kategori sayısı
  block-four-combo: true

  zemin:
    chance: 0.22
  gurz:
    chance: 0.20
  avci-sayisi:
    chance: 1.0
  oyuncular:
    chance: 0.24
  kaos:
    enabled: true
    chance: 0.03         # %3 Kaos round şansı

Minigame Ayarları

minigames:
  enabled: true
  chance: 0.30           # Her turda minigame gelme şansı (%30)

  mjolnir:
    enabled: true
    lightning-count: 4        # İşaretlenecek blok sayısı
    lightning-delay-ticks: 20 # Şimşek gecikme süresi (tick)
    lightning-damage: 1000    # Şimşek hasarı

  shockwave:
    enabled: true
    radius: 5           # Dalga yarıçapı (blok)
    push-power: 2.0     # Savurma gücü
    wave-height: 0.5    # Dalga yüksekliği

  windburst:
    enabled: true
    launch-power: 1.5   # Havaya fırlatma gücü

İstatistik Ayarları

stats:
  current-season: "season-1"  # Aktif sezon anahtarı
  leaderboard-limit: 10       # Leaderboard'da gösterilecek oyuncu sayısı
  sqlite:
    path: "stats.db"          # SQLite veritabanı dosya yolu

Diğer Ayarlar

power:
  mace-wind-burst-launch-power: 1.5     # Mace vuruşu fırlatma gücü
  wind-charge-boost-multiplier: 1.5     # Wind Charge hız çarpanı

display:
  scale: 1.5         # Mace display büyüklüğü
  grounded: true     # Yere sabit mi

anti-repeat-memory: 3  # Son kaç oyuncuyu hatırla (tekrar seçme)

messages.yml

Tüm oyun mesajları plugins/Arcenia-MaceArena/messages.yml dosyasından özelleştirilir. MiniMessage formatı desteklenir:

• Gradient: <gradient:#ff6b35:#ff2e63>Metin</gradient>
• Hex renk: <color:#ff6b35>Metin</color>
• Bold: <bold>Metin</bold>
• Standart renkler: <red>, <green>, <aqua>, <gold>, <yellow>, <gray> vb.

Mesaj kategorileri: game, arena, selection, hunter, mace, victim, round, event, status, admin, elimination, victory, minigame.

Oyun Akışı

1. Katılım: Oyuncular /macearena join komutu ile bekleme listesine katılır. Durum IDLE -> WAITING olur.
2. Başlangıç: Minimum oyuncu sayısına ulaşıldığında admin /macearena start ile oyunu başlatır. Arena, spawn noktası etrafında oyuncu sayısına göre boyutlandırılarak oluşturulur.
3. Çark Dönüşü (SPINNING): 3B Mace display entity çark gibi oyuncuların etrafında döner. Şans faktörüne göre tek, çift veya üç avcı seçilir. Dönme sırasında oyuncular yerlerinden hareket edemez.
4. Av Fazı (HUNTING): Seçilen avcı(lar) Mace ve Wind Charge alır. Kırmızı glow efekti ve BossBar geri sayımı aktif olur. Avcı yukarıdan düşüş yaparak (minimum 1.5 blok) Mace ile vurabilir. Diğer oyuncular kaçmaya çalışır.
5. Eliminasyon: Vurulan oyuncu oyundan elenir. Arena, kalan oyuncu sayısına göre küçülür.
6. Tur Tekrarı: Av süresi dolduğunda veya avcı vuruşunu yaptıktan sonra yeni tur başlar. Round efektleri, minigame modları ve kategoriler seçilir.
7. Zafer: Son hayatta kalan oyuncu kazanır. İstatistikler güncellenir ve oyuncular lobiye geri döndürülür.

Round Efektleri ve Kategoriler

Her tur başında kategori sistemi devreye girer. Kategoriler bağımsız şanslarla aktif olur:

• Zemin kategorisi arena zeminini değiştirir (buz, görünmez, kırılgan, slime vb.)
• Gürz kategorisi mace'e özel özellikler ekler (altın gürz, patlayıcı, manyetik vb.)
• Oyuncular kategorisi oyuncuları etkiler (yavaş/hızlı zaman, körlük, zıplama yasağı, hayalet modu)
• Kaos roundu tüm kategorilerin aynı anda aktif olduğu özel bir turdur

Minigame Sistemi

Minigameler avcı başarılı bir vuruş gerçekleştirdiğinde tetiklenir ve ek mekanikler ekler:

• Mjolnir: Arenada rastgele 4 noktaya şimşek çakar, isabet ederse vurulan oyuncu elenir
• Shockwave: Vuruş noktasından genişleyen dalga halkası, yakalanan oyuncuları savurur
• WindBurst: Sadece vurulan oyuncu havaya fırlatılır