ArceniaDuel

Temel Duello Sistemi

• 1v1 Duello -- Duello istegi, kabul/red, geri sayim, sure siniri, spawn korumasi
• Cok Arena Destegi -- Birden fazla arena olusturma, otomatik musait arena atama
• Kural Ozellestirme -- Envanter dusurme, basamak/orumcek agi engeli, yemek engeli, insa izni -- GUI ile secim
• Ganimet Sandigi -- Kaybeden oyuncunun esyalarini kazanana ozel sandik olarak sunma
• Beraberlik / Terk Sistemi -- Karsilikli beraberlik teklifi ve onaylamali forfeit mekanigi
• Izleyici Modu -- Aktif duellolari izleme, otomatik cikis, konum geri yukleme
• Komut Engelleme -- Duello sirasinda spawn, tp, home gibi komutlari engelleme
• AFK Koruma -- Duello teleportlari AFK pluginleri tarafindan geri alinamaz

Arena Koruma Sistemi

• Blok Korumasi -- Arena icinde blok kirma/koyma/patlama/yanma engelleme
• Sinir Kontrolu -- Aktif duello sirasinda arena disina cikma engeli (X/Y/Z ekseni)
• Ender Pearl / Chorus Fruit Korumasi -- Arena disinsa ender pearl ve chorus fruit ile kacisin engellenmesi
• Container Korumasi -- Arena icindeki sandik/firin/workbench erisimini engelleme
• Sivi Korumasi -- Su/lav yayilmasini ve kova ile dokmeyi engelleme
• Piston Korumasi -- Piston ile blok itme/cekme engelleme
• Entity Korumasi -- Zirh standi, item frame, tablo kirma/manipulasyon engeli
• Mob Spawn Engelleme -- Arena icinde dogal mob dogmasini engelleme
• Ates Yayilma Korumasi -- Ates, mantar, sarmasik yayilmasini engelleme
• Aclik Kontrolu -- Duello sirasinda aclik dondurma (opsiyonel)
• Bypass Izni -- arceniaduel.bypass.arenaprotection ile tum korumalardan muafiyet
• Config Toggle -- Her koruma ayri ayri config'den acilip kapatilabilir

ELO / Rating Sistemi

• ELO Puanlama -- Kazanma orani yerine beceri bazli siralama (varsayilan K=32)
• Dinamik Hesaplama -- Guclu rakibi yenmek daha fazla puan kazandirir
• PlaceholderAPI Destegi -- %duel_elo% ile scoreboard, tab, hologram entegrasyonu

Kuyruk / Eslestirme Sistemi

• Otomatik Eslestirme -- /duel queue ile kuyruga gir, ELO toleransina gore otomatik es bul
• Genisleyen Tolerans -- Bekleme suresi arttikca ELO toleransi otomatik genisler
• Asenkron Yukleme -- ELO verileri ana thread'i bloklamadan arka planda yuklenir

Takim Duellolari (2v2, 3v3)

• Parti Sistemi -- Parti olusturma, davet, kabul, lider/uye yonetimi
• Takim Duellosu -- Parti liderleri arasi takim duellosu istegi gonderme
• Takim Olum Mekanigi -- Olen oyuncu izleyici moduna gecer, takim elene kadar mac devam eder

Turnuva Sistemi

• Tek Eleme Bracket -- 4-32 oyunculu turnuva, bye destegiyle otomatik bracket olusturma
• Kayit Donemi -- Admin turnuva olusturur, oyuncular kayit suresinde katilir
• Otomatik Ilerleme -- Mac bitisinde bracket otomatik ilerler, no-show otomatik elenir
• Bracket Goruntuleme -- /turnuva bracket ile guncel bracket durumu (GUI)

Citizens NPC Entegrasyonu

• 4 NPC Tipi -- QUEUE (kuyruga gir/cik), STATS (istatistik GUI), TOURNAMENT (turnuva katilim/bracket), DUEL (duello meydan oku)
• Akilli NPC Davranisi -- Turnuva NPC'si tek acik turnuvaya otomatik katilar, birden fazlaysa listeler, zaten katilmissa bracket gosterir
• SQLite Kalicilik -- NPC verileri veritabaninda saklanir, sunucu yeniden baslatmada korunur

Istatistik ve GUI

• Istatistik Takibi -- Galibiyet, maglubiyet, ELO, seri, en hizli oldurme, favori arena/rakip
• Istatistik GUI -- Detayli istatistik goruntulemesi envanter GUI'si ile
• Duello Gecmisi GUI -- Gecmis duellolari GUI uzerinden goruntuleyebilme
• Duello Meydan Oku GUI -- Online oyuncularin kafalarini gosteren, ELO ve W/L bilgisiyle zenginlestirilmis GUI
• Turnuva Bracket GUI -- Turnuva bracket durumunu GUI uzerinden goruntuleme
• Siralama Tablosu -- Kazanma orani veya ELO'ya gore ilk 10 oyuncu siralamasi

Altyapi

• SQLite Veritabani -- Istatistikler, gecmis, arena verileri, ban ve NPC kayitlari
• Arena Sifirlama -- Blok degisiklik takibi, asenkron sifirlama, parcacik efektleri
• Admin Paneli -- GUI tabanli yonetim: ban, force-end, istatistik sifirlama, NPC yonetimi
• Discord Webhook -- Duello baslangic/bitis bildirimleri, haftalik siralama gonderimi
• PlaceholderAPI -- 25+ placeholder ile scoreboard, tab, hologram entegrasyonu

Opsiyonel Bagimliliklar

1. Projeyi derleyin (mvn clean package) veya hazir JAR dosyasini indirin
2. JAR dosyasini sunucunuzun plugins/ klasorune kopyalayin
3. (Opsiyonel) Citizens eklentisini yukleyin -- NPC ozellikleri icin gereklidir
4. Sunucuyu baslatin -- plugins/ArceniaDuel/config.yml otomatik olusturulur
5. Arena olusturun:
   • /duelarena wand -> koseleri secin (sol tik / sag tik)
   • /duelarena create <isim>
   • /duelarena setspawn1 <isim> ve /duelarena setspawn2 <isim>
6. Arena durumunu kontrol edin:
   • /duelarena status <isim> -- tek arena kontrol
   • /duelarena status all -- tum arenalarin durumu
7. Duellolar artik aktiftir

Oyuncu Komutlari -- Duello

Oyuncu Komutlari -- Beraberlik / Izleme / Istatistik

Oyuncu Komutlari -- Parti

Oyuncu Komutlari -- Turnuva

Yonetim Komutlari

Arena Yonetimi Komutlari

Arena Status Komutu

/duelarena status <arena> komutu arenanin kurulum durumunu detayli gosterir:

----------------------------------------
Arena Durumu: Arena1

Spawn 1: ✓ Ayarlandi
Spawn 2: ✗ Ayarlanmadi
Sinirlar (XZ): ✓ X[50,200] Z[50,200]
Sinirlar (Y): ✓ Y[60,80]
Dunya: ✓ world
Durum: ✓ Aktif
Kullanim: Bos

✗ Arena kurulumu tamamlanmadi!
----------------------------------------

/duelarena status all komutu tum arenalarin durumunu tek seferde gosterir.

Oyuncu Izinleri

Yonetim Izinleri

Duello Ayarlari

duel:
  duration: 600                    # Duello suresi (saniye)
  countdown: 3                    # Baslangic geri sayimi
  spawn-protection: 3             # Spawn korumasi suresi (saniye)
  cooldown: 0                     # Ayni oyuncuyla tekrar duello bekleme suresi
  request-expire: 60              # Istek gecerlilik suresi (saniye)
  draw-request-expire: 30         # Beraberlik teklifi gecerlilik suresi
  forfeit-confirm-seconds: 10     # Terk onay penceresi suresi
  winner-stay-seconds: 120        # Kazananin arenada kalma suresi
  max-spectators: 20              # Duello basina maksimum izleyici
  no-inventory-respawn-delay: 5   # Envanter dusurme kapaliysa yeniden dogma gecikmesi
  blocked-commands:               # Duello sirasinda engellenen komutlar
    - "spawn"
    - "home"
    - "sethome"
    - "tp"
    - "tpa"
    - "tpahere"
    - "tpaccept"
    - "warp"
    - "back"
    - "fly"
    - "gamemode"

Varsayilan Kural Ayarlari

default-rules:
  inventory-drop: true             # Olunce esyalar dussun mu?
  slab-disabled: false             # Basamak koyma engellensin mi?
  cobweb-disabled: false           # Orumcek agi koyma engellensin mi?
  food-disabled: false             # Yemek yeme engellensin mi?
  build-enabled: true              # Blok koyma ve kirma acik mi?

Arena Koruma Ayarlari

protection:
  container-protection: true       # Arena icindeki sandik/firin erisimini engelle
  liquid-protection: true          # Su/lav yayilmasini engelle
  piston-protection: true          # Piston ile blok itme/cekme engelle
  entity-protection: true          # Zirh standi, item frame, tablo korumasi
  mob-spawn-prevention: true       # Arena icinde mob dogmasini engelle
  fire-spread-protection: true     # Ates yayilmasini engelle
  bucket-protection: true          # Kova ile su/lav dokmeyi engelle
  hunger-freeze: false             # Duello sirasinda aclik dondurma (false=normal)
  boundary-enforcement: true       # Duello sirasinda sinir kontrolu

Not: Her koruma bagimsiz olarak acilip kapatilabilir. arceniaduel.bypass.arenaprotection iznine sahip oyuncular tum korumalardan muaf tutulur.

ELO / Rating Ayarlari

elo:
  enabled: true                    # ELO sistemi acik/kapali
  starting-elo: 1000               # Yeni oyuncularin baslangic ELO puani
  k-factor: 32                     # ELO degisim hizi (yuksek = daha volatil)

ELO nasil calisir: Guclu bir rakibi (yuksek ELO) yendiginde daha fazla puan kazanirsin, zayif bir rakibe (dusuk ELO) kaybettiginde daha fazla puan kaybedersin. K-factor degeri degisim hizini kontrol eder.

Kuyruk / Eslestirme Ayarlari

queue:
  enabled: true                    # Kuyruk sistemi acik/kapali
  matchmaking-interval: 40         # Eslestirme kontrol araligi (tick, 40 = 2 saniye)
  initial-elo-tolerance: 100       # Baslangic ELO toleransi
  tolerance-expansion: 50          # Her periyotta genisleme miktari
  tolerance-expansion-interval: 30 # Genisleme periyodu (saniye)
  max-tolerance: 500               # Maksimum ELO toleransi

Genisleyen tolerans: Oyuncu kuyruga girdiginde, ilk 30 saniye +-100 ELO araliginda es aranir. Bulunamazsa tolerans her 30 saniyede 50 artarak +-500'e kadar genisler.

Takim Duellosu Ayarlari

team-duel:
  enabled: true                    # Takim duellosu acik/kapali
  max-party-size: 3                # Maksimum parti boyutu (2 = sadece 2v2, 3 = 2v2 ve 3v3)
  countdown: 5                    # Takim duellosu geri sayimi
  duration: 900                    # Takim duellosu suresi (saniye)

Turnuva Ayarlari

tournament:
  enabled: true                    # Turnuva sistemi acik/kapali
  min-participants: 4              # Minimum katilimci sayisi
  max-participants: 32             # Maksimum katilimci sayisi
  registration-time: 300           # Kayit suresi (saniye)
  match-start-delay: 10            # Maclar arasi bekleme (saniye)
  no-show-timeout: 60              # Gelmezse diskalifiye suresi (saniye)

Arena Sifirlama Ayarlari

arena-reset:
  reset-speed: 20                  # Tick basina sifirlanacak blok sayisi
  async-reset: true                # Asenkron sifirlama (lag onleme)
  show-reset-progress: true        # Parcacik efektleri
  clear-dropped-items: true        # Yerdeki esyalari temizle
  clear-entities: true             # Oklari vb. temizle

Discord Webhook Ayarlari

discord:
  enabled: false
  webhook-url: "https://discord.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN"
  send-duel-start: true
  send-duel-end: true
  send-weekly-leaderboard: true
  leaderboard-day: "SUNDAY"
  embed-color-start: "#3498db"
  embed-color-win: "#2ecc71"
  embed-color-loss: "#e74c3c"

Mesajlar

Config dosyasinda 150+ ozellestirilebilir Turkce mesaj bulunur:

• Duello istek/kabul/red, beraberlik, terk mesajlari
• ELO degisim bildirimleri
• Kuyruk durumu mesajlari
• Parti davet/katilim/ayrilis mesajlari
• Takim duellosu bilgilendirmeleri
• Turnuva kayit/baslangic/bitis mesajlari
• NPC olusturma/silme mesajlari
• Arena yonetimi bildirimleri
• & renk kodu destegi

Oyuncu A: /duel OyuncuB
    |
    v
Kural secim GUI'si acilir (DuelRulesGUI)
  - Envanter Dusurme, Basamak, Orumcek Agi, Yemek, Insa kurallarini sec
  - "Onayla" butonuna tikla
    |
    v
Oyuncu B'ye duello istegi gonderilir
  - Chat'te [KABUL ET] / [REDDET] butonlari (tiklanabilir)
  - Arena adi ve kurallar gosterilir
  - 60 saniye gecerlilik suresi
    |
    v
Oyuncu B: /duel accept veya [KABUL ET] tiklar
    |
    v
Musait arena otomatik atanir
Her iki oyuncu spawn noktalarina isinlanir
(AFK koruma metadata ile harici teleportlar engellenir)
    |
    v
[GERI SAYIM: 3... 2... 1...]
  - Spawn korumasi aktif (3 saniye)
    |
    v
[AKTIF DUELLO]
  - Sure siniri: 600 saniye (ayarlanabilir)
  - Blok degisiklikleri takip ediliyor
  - Komutlar engelli (spawn, tp, home vb.)
  - Arena sinir kontrolu aktif (yurume, ender pearl, chorus fruit)
  - Arena korumalari aktif (container, sivi, piston, entity, mob)
  - /berabere ile beraberlik teklif edilebilir
  - /duel ayril ile terk edilebilir
    |
    v
Duello sonucu:
  |
  +-- Oyuncu olur -> Kazanan/kaybeden belirlenir
  |     - ELO guncellenir
  |     - Envanter dusurme aciksa: Kazanan arenada kalir (120sn)
  |     - Ganimet sandigi olusturulur
  |
  +-- Sure dolar -> Yuksek canli oyuncu kazanir (esitse berabere)
  |
  +-- Beraberlik kabul edilir -> Her iki oyuncu icin berabere kaydedilir
  |
  +-- Oyuncu ayrilir/cikar -> Diger oyuncu kazanir
    |
    v
Istatistikler + ELO guncellenir (SQLite)
Arena sifirlanir (asenkron)
Discord webhook gonderilir (aktifse)
Turnuva maciysa bracket ilerletilir
Izleyiciler cikarilir

Senaryo 1: Kuyruk ile Otomatik Eslesme

/duel queue                          # Kuyruga gir
  -> ELO toleransi dahilinde rakip aranir
  -> Eslesme bulunursa otomatik duello baslar
  -> Bulunamazsa tolerans zamanla genisler
/duel leave                          # Kuyruktan cik (istemezsen)

Senaryo 2: 2v2 Takim Duellosu

# Takim 1
/party create                        # Lider parti olusturur
/party invite OyuncuB                # Takim arkadasini davet et
  -> OyuncuB: /party accept          # Davet kabul edilir

# Takim 2 de ayni sekilde parti olusturur

# Duello baslat
/duel team <KarsiLider>              # Liderden lidere istek
  -> Karsi Lider: /duel team accept  # Kabul et
  -> 2v2 duello baslar!

Senaryo 3: Turnuva Duzenleme

# Admin turnuva olusturur
/turnuva create yaz-kupasi 16        # 16 oyunculu turnuva

# Oyuncular katilir
/turnuva join yaz-kupasi

# Admin baslatir (min 4 oyuncu gerekir)
/turnuva start yaz-kupasi
  -> Bracket otomatik olusturulur
  -> Maclar sirayla baslar
  -> Kazanan bir sonraki tura ilerler
  -> Sampiyon belirlenir!

# Bracket durumu (GUI)
/turnuva bracket yaz-kupasi

Senaryo 4: NPC ile Etkilesim (Citizens Gerekir)

# Admin NPC olusturur
/dueladmin npc create QUEUE           # Kuyruga giris NPC'si
/dueladmin npc create STATS           # Istatistik GUI NPC'si
/dueladmin npc create DUEL            # Duello meydan oku NPC'si
/dueladmin npc create TOURNAMENT      # Turnuva NPC'si

# Oyuncu NPC'ye sag tiklar -> Ilgili aksiyon tetiklenir
# QUEUE: Kuyruga gir/cik (toggle)
# STATS: Istatistik GUI acilir
# TOURNAMENT: Acik turnuvaya otomatik katilim veya bracket goruntulemesi
# DUEL: Duello meydan oku GUI'si acilir

Senaryo 5: Arena Durum Kontrolu

# Tek arena kontrol
/duelarena status Arena1
  -> Spawn 1/2, sinirlar, dunya, durum bilgisi gosterilir
  -> Eksik ayarlar ✗ ile isaretlenir

# Tum arenalari toplu kontrol
/duelarena status all
  -> Her arena icin ayri ayri durum raporu gosterilir

Duello baslangicinda GUI uzerinden 5 kural ozellestirebilir:

Kurallar GUI'de renkli ikonlarla gosterilir ve tiklayarak degistirilir. Kabul eden oyuncu kurallari chat'te gorur.

Takip Edilen Metrikler

Identifier: duel

Durum Placeholder'lari

Istatistik Placeholder'lari

Dinamik Placeholder'lar

• Envanter dusurme acik olan duellolarda kaybeden oyuncunun esyalari yakalanir
• Kazanan oyuncu icin ozel bir sandik olusturulur
• /duel sandik komutuyla acilir
• Birden fazla bekleyen sandik destekler (kuyruk sistemi)
• Tum esyalar alindiginda sandik temizlenir
• Sandik envanterinde bekleyen sandik sayisi gosterilir

• /spectate <oyuncu> veya /izle <oyuncu> ile aktif duelloyu izleme
• Duello basina maksimum 20 izleyici (ayarlanabilir)
• Izleyiciler arena merkezine isinlanir
• Hasar alamaz, etkilesim yapamaz, esya toplayamaz
• Duello bittiginde otomatik cikarilir ve eski konumuna geri gonderilir

SQLite Tablolari

S: ELO sistemi nasil calisir? ELO, satranc dunyasindan uyarlanmis bir beceri puanlama sistemidir. Her oyuncu 1000 puanla baslar. Guclu rakipleri yenmek daha fazla puan kazandirir, zayif rakiplere kaybetmek daha fazla puan kaybettirir. K-factor (varsayilan 32) ile degisim hizini ayarlayabilirsiniz.

S: Kuyrukta ne kadar beklerim? Eslesme suresi sunucudaki aktif oyuncu sayisina ve ELO dagilimina baglidir. Baslangicta +-100 ELO araliginda rakip aranir. Her 30 saniyede tolerans 50 puan genisler, boylece uzun sure bekleyen oyuncular da eslesir (maks +-500).

S: Citizens eklentisi zorunlu mu? Hayir. Citizens opsiyonel bir bagimliliktir. Yuklu degilse NPC ozellikleri otomatik devre disi kalir, diger tum ozellikler normal calisir.

S: Turnuva sirasinda sunucu kapanirsa ne olur? Aktif turnuvalar bellekte tutulur, sunucu kapanirsa kaybolur. Turnuva sirasinda sunucuyu yeniden baslatmaktan kacinin.

S: Parti boyutu siniri nedir? Config'de team-duel.max-party-size ile ayarlanir (varsayilan 3). Bu deger 2 yapilirsa sadece 2v2, 3 yapilirsa 2v2 ve 3v3 duellolar yapilabilir.

S: AFK koruma nasil calisir? Plugin, duello icin teleport yaparken oyuncuya ozel bir metadata ekler. Bu metadata sayesinde AFK pluginleri (EssentialsX AFK, CMI vb.) oyuncuyu geri isinlayamaz. Sadece harici plugin teleportlari engellenir; ender pearl ve chorus fruit arena siniri icerisinde normal calisir, sinir disina cikis engellenir.

S: Arenalarda kac oyuncu olabilir? Her arena ayni anda yalnizca bir duello barindirir (1v1 veya takim). Birden fazla arena olusturarak es zamanli duello sayisini artirabilirsiniz.

S: Arena korumasi nasil calisir? Arena icerisinde blok kirma/koyma, sandik acma, su/lav dokme, piston kullanma, zirh standi/item frame kirma ve mob dogmasi varsayilan olarak engellenir. Her koruma config'den ayri ayri kapatilabilir. arceniaduel.bypass.arenaprotection izni ile tum korumalar bypass edilebilir.

S: Arena sinir kontrolu nedir? Aktif duello sirasinda oyuncular arena disina cikamaz. Yurume, ender pearl ve chorus fruit ile arena sinirlarini asmaya calismak engellenir. Sinirlar X, Y ve Z eksenlerinde kontrol edilir. Y siniri ayarlanmamis eski arenalar icin Y kontrolu otomatik atlanir.

ArceniaDuel/
+-- pom.xml
+-- README.md
+-- src/
    +-- main/
        +-- java/com/arcenia/duel/
        |   +-- ArceniaDuel.java                    # Ana plugin sinifi
        |   +-- commands/
        |   |   +-- AdminCommand.java               # /dueladmin (NPC dahil)
        |   |   +-- ArenaSetupCommand.java          # /duelarena (status dahil)
        |   |   +-- BerabereCommand.java            # /berabere
        |   |   +-- DuelCommand.java                # /duel (queue, team dahil)
        |   |   +-- DuelHistoryCommand.java         # /duelhistory
        |   |   +-- DuelListCommand.java            # /duellist
        |   |   +-- DuelRankCommand.java            # /duelrank
        |   |   +-- PartyCommand.java               # /party
        |   |   +-- SpectateCommand.java            # /spectate
        |   |   +-- StatsCommand.java               # /stats
        |   |   +-- TournamentCommand.java          # /turnuva
        |   +-- gui/
        |   |   +-- AdminPanelGUI.java              # Yonetim paneli
        |   |   +-- DuelChallengeGUI.java           # NPC duello meydan oku
        |   |   +-- DuelLootChestHolder.java        # Ganimet sandigi
        |   |   +-- DuelRequestGUI.java             # Istek GUI'si
        |   |   +-- DuelRulesGUI.java               # Kural secim GUI'si
        |   |   +-- HistoryGUI.java                 # Duello gecmisi GUI'si
        |   |   +-- StatsGUI.java                   # Istatistik GUI'si
        |   |   +-- TournamentGUI.java              # Turnuva bracket GUI'si
        |   +-- hooks/
        |   |   +-- PlaceholderAPIHook.java          # PlaceholderAPI entegrasyonu
        |   +-- listeners/                           # 13 olay dinleyicisi
        |   |   +-- ArenaProtectionListener.java     # Kapsamli arena korumasi
        |   |   +-- BlockChangeListener.java
        |   |   +-- DuelCommandBlockListener.java
        |   |   +-- DuelListener.java
        |   |   +-- DuelLootChestListener.java
        |   |   +-- DuelTeleportListener.java        # AFK + ender pearl korumasi
        |   |   +-- InventoryClickListener.java
        |   |   +-- NPCInteractListener.java         # Citizens NPC etkilesimi
        |   |   +-- PlayerDeathListener.java
        |   |   +-- PlayerInteractListener.java
        |   |   +-- PlayerMoveListener.java          # Sinir kontrolu
        |   |   +-- PlayerQuitListener.java
        |   |   +-- WandInteractListener.java
        |   +-- managers/
        |   |   +-- ArenaManager.java               # Arena musaitlik ve secimi
        |   |   +-- ArenaResetManager.java          # Blok geri yukleme
        |   |   +-- ArenaSetupManager.java          # Arena kurulum oturumu
        |   |   +-- BlockTrackingManager.java       # Blok degisiklik takibi
        |   |   +-- ConfigManager.java              # Konfigurasyon yukleme
        |   |   +-- CooldownManager.java            # Bekleme suresi yonetimi
        |   |   +-- DatabaseManager.java            # SQLite islemleri
        |   |   +-- DiscordWebhookManager.java      # Discord bildirimleri
        |   |   +-- DuelLootChestManager.java       # Ganimet sandigi yonetimi
        |   |   +-- DuelManager.java                # Duello yasam dongusu
        |   |   +-- NPCManager.java                 # Citizens NPC yonetimi
        |   |   +-- PartyManager.java               # Parti yonetimi
        |   |   +-- PostDuelArenaManager.java       # Duello sonrasi arena yonetimi
        |   |   +-- QueueManager.java               # Kuyruk/eslestirme sistemi
        |   |   +-- StatsManager.java               # Istatistik yonetimi
        |   |   +-- TeamDuelManager.java            # Takim duellosu yonetimi
        |   |   +-- TournamentManager.java          # Turnuva yonetimi
        |   +-- models/
        |   |   +-- Arena.java                      # Arena veri modeli (Y ekseni dahil)
        |   |   +-- Duel.java                       # Duello durumu modeli
        |   |   +-- DuelHistory.java                # Gecmis kayit modeli
        |   |   +-- DuelNPC.java                    # NPC veri modeli
        |   |   +-- DuelRequest.java                # Istek modeli
        |   |   +-- DuelRules.java                  # Kural modeli
        |   |   +-- Party.java                      # Parti modeli
        |   |   +-- PlayerStats.java                # Istatistik modeli
        |   |   +-- QueueEntry.java                 # Kuyruk girdisi modeli
        |   |   +-- TeamDuel.java                   # Takim duellosu modeli
        |   |   +-- Tournament.java                 # Turnuva modeli
        |   +-- utils/
        |       +-- MessageUtil.java                # Mesaj formatlama
        +-- resources/
            +-- plugin.yml                          # Plugin metadata
            +-- config.yml                          # Varsayilan yapilandirma

ArceniaDuel, geliştiricilerin eklentinin temel özelliklerine erişebilmesi ve kendi sistemlerine entegre edebilmesi için genişletilebilir bir API yapısı sunar. Eklentinin sunduğu etkinlikleri (event) dinleyerek duello başlangıçlarını, bitişlerini ve oyuncu istatistiklerini takip edebilirsiniz.

API Kullanımı:

• Etkinlikler: DuelStartEvent, DuelEndEvent ve DuelJoinEvent sınıflarını kullanarak duello süreçlerini kendi eklentilerinizle senkronize edebilirsiniz.
• PlaceholderAPI: arceniaduel_elo, arceniaduel_wins ve arceniaduel_losses gibi placeholder'lar ile oyuncu verilerini skor tablolarında veya sohbet formatlarında kolayca sergileyebilirsiniz.
• Entegrasyon: Citizens NPC API desteği sayesinde, özel NPC'ler üzerinden duello kuyruğuna giriş ve istatistik görüntüleme işlemlerini tetikleyebilirsiniz.

Daha detaylı teknik dokümantasyon ve örnek kod blokları için projenin GitHub üzerindeki Javadocs klasörünü inceleyebilirsiniz.

Sorun Giderme (Troubleshooting)

• Java Sürümü: Eklentinin çalışması için sunucunuzda Java 21 veya üzeri yüklü olduğundan emin olun.
• Sunucu Sürümü: ArceniaDuel yalnızca Spigot/Paper 1.21+ sürümlerini destekler. Eski sürümlerde eklenti hata verebilir.
• Arena Sorunları: Blok kırma veya komut engelleme çalışmıyorsa, arena sınırlarının doğru tanımlandığından ve Bypass yetkisine sahip olmadığınızdan emin olun.
• Komut Engelleme: Duello sırasında /spawn veya /tp gibi komutlar engellenmiyorsa, eklentinin diğer komut yönetim eklentileriyle çakışıp çakışmadığını kontrol edin.
• Bağımlılıklar: PlaceholderAPI veya Citizens NPC entegrasyonu ile ilgili sorun yaşıyorsanız, ilgili eklentilerin güncel olduğundan ve sunucuda yüklü olduğundan emin olun.
• Hatalı Davranışlar: Sorun devam ederse, konsoldaki hata kayıtlarını (stack trace) inceleyin ve eklentinin en güncel sürümünü kullandığınızdan emin olun.