KaosDuel | Boxmining Advanced GUI Duel System

How It Works / Features
KaosDuel is a highly advanced, GUI-based 1v1 duel system designed for modern servers (1.21+). It offers a premium dueling experience with unique mechanics that set it apart from standard duel plugins.

• Interactive GUI Invites: Players can customize their duel settings (Elytra Usage, Cobweb Placement, Block Placing, Item Drops) via a sleek GUI before sending an invite.
  
  
• Loot Chest System: If the "Item Drop" rule is enabled, the loser's items do not drop messily on the floor. Instead, a clean "Loot Chest" GUI opens instantly for the winner to take their prize.
  
  
• Multi-Arena & Auto-Queue: Supports infinite arenas. The plugin automatically finds and assigns the next available empty arena for accepting players.
  
  
• Advanced Spectator Mode: Players can spectate ongoing duels. Spectators are strictly locked within the mathematical boundaries of the arena and cannot escape or interfere.
  
  
• Dynamic Language System (EN/TR): The plugin comes with built-in English and Turkish support. Changing the global language instantly changes everything—including the player commands themselves! (e.g., /duel davet automatically becomes /duel invite).
  
  
• Automatic Arena Reset: After every duel (or draw), the plugin automatically clears the arena by resetting all placed blocks within the boundaries.
  

️ Installation & Arena Setup
Setting up KaosDuel is incredibly simple. Follow these steps to get your first arena running:

1. Download the KaosDuel.jar and drop it into your server's plugins folder.
   
   
2. Start or restart your server.
   
   
3. Join the game and use the following commands to create your arena:
   
   • Step 1: Create the arena profile: /duel admin create <arena_name>
     
     
   • Step 2: Set the boundaries (used for resetting blocks and spectator limits). Go to the first corner of your arena and type /duel admin setpos1 <arena_name>. Go to the opposite bottom/top corner and type /duel admin setpos2 <arena_name>.
     
     
   • Step 3: Set where the players will spawn. Stand where Player 1 should spawn and type /duel admin setspawn1 <arena_name>. Do the same for Player 2 using /duel admin setspawn2 <arena_name>.
     
4. (Optional) Change the default language to English by typing /duel changelanguage en followed by /duel reload.
   
   
5. You are done! Players can now use /duel invite <player> to start fighting!
   

Commands & Permissions
Note: Player commands change dynamically based on the active language. The English commands are shown below.

Player Commands (No permissions required):

• /duel - Displays the help menu.
  
  
• /duel invite <player> - Opens the settings GUI to challenge a player.
  
  
• /duel accept <player> - Accepts a pending duel invite from a specific player.
  
  
• /duel deny <player> - Denies a pending duel invite.
  
  
• /duel draw - Sends a draw request to your opponent, or accepts theirs.
  
  
• /duel spectate <player> - Teleports you to an active duel as a spectator.
  
  
• /spawn - (While spectating) Instantly leaves spectator mode and teleports you to the server spawn.
  

️ Admin Commands (Requires kaosduel.admin permission):

• /duel changelanguage <en/tr> - Changes the global server language.
  
  
• /duel reload - Reloads the configurations and language files safely.
  
  
• /duel admin create <arena_name> - Creates a new arena.
  
  
• /duel admin delete <arena_name> - Permanently deletes an arena.
  
  
• /duel admin setpos1 <arena_name> - Sets the 1st boundary corner.
  
  
• /duel admin setpos2 <arena_name> - Sets the 2nd boundary corner.
  
  
• /duel admin setspawn1 <arena_name> - Sets Player 1's spawn location.
  
  
• /duel admin setspawn2 <arena_name> - Sets Player 2's spawn location.
  
  
• 
  
• /duel admin temizle <arena_name> - Manually forces an arena clean-up (removes blocks and kicks stuck players). and finish
• Nasıl Çalışır / Özellikler

KaosDuel, modern sunucular (1.21+) için tasarlanmış, son derece gelişmiş, GUI (Menü) tabanlı bir 1v1 düello sistemidir. Standart düello eklentilerinden ayrılan benzersiz mekanikleriyle premium bir düello deneyimi sunar.

• Etkileşimli GUI Davetleri: Oyuncular bir davet göndermeden önce şık bir menü üzerinden düello ayarlarını (Elytra Kullanımı, Örümcek Ağı Koyma, Blok Koyma, İtem Düşmesi) kolayca özelleştirebilirler.
  
  
• Ganimet Sandığı Sistemi: "İtem Düşmesi" kuralı açıksa, kaybeden oyuncunun eşyaları yere dağınık bir şekilde düşmez. Bunun yerine, kazananın ödülünü alması için anında temiz bir "Ganimet Sandığı" menüsü açılır.
  
  
• Çoklu Arena ve Otomatik Sıra: Sınırsız arena destekler. Eklenti, daveti kabul eden oyuncular için sıradaki müsait (boş) arenayı otomatik olarak bulur ve oyuncuları oraya yönlendirir.
  
  
• Gelişmiş İzleyici Modu: Oyuncular devam eden düelloları izleyebilir. İzleyiciler arenanın matematiksel sınırları içine hapsedilir; dışarı çıkamaz veya düelloya müdahale edemezler.
  
  
• Dinamik Dil Sistemi (TR/EN): Eklenti yerleşik Türkçe ve İngilizce desteğiyle gelir. Global dili değiştirdiğinizde her şey anında değişir—oyuncu komutlarının kendisi bile! (Örn: /duel invite otomatik olarak /duel davet olur).
  
  
• Otomatik Arena Sıfırlama: Her düellodan (veya beraberlikten) sonra eklenti, sınırlar içine koyulan tüm blokları temizleyerek arenayı sıradaki oyuncular için otomatik olarak sıfırlar.
  

️ Kurulum ve Arena Ayarları
KaosDuel'i kurmak inanılmaz derecede basittir. İlk arenanızı çalıştırmak için şu adımları izleyin:

1. KaosDuel.jar dosyasını indirin ve sunucunuzun plugins klasörünün içine atın.
   
   
2. Sunucunuzu başlatın (veya yeniden başlatın).
   
   
3. Oyuna girin ve arenanızı oluşturmak için sırasıyla aşağıdaki komutları kullanın:
   
   • Adım 1: Arena profilini oluşturun: /duel admin create <arena_ismi>
     
     
   • Adım 2: Sınırları belirleyin (bu sınırlar izleyiciler ve arenayı temizlemek için kullanılır). Arenanızın ilk köşesine gidin ve /duel admin setpos1 <arena_ismi> yazın. Çaprazındaki tam karşı (alt/üst) köşeye gidin ve /duel admin setpos2 <arena_ismi> yazın.
     
     
   • Adım 3: Oyuncuların nerede doğacağını ayarlayın. Oyuncu 1'in doğmasını istediğiniz yerde durun ve /duel admin setspawn1 <arena_ismi> yazın. Aynı işlemi Oyuncu 2 için /duel admin setspawn2 <arena_ismi> kullanarak yapın.
     
4. (İsteğe Bağlı) Varsayılan dili İngilizce yapmak isterseniz /duel changelanguage en yazıp ardından /duel reload komutunu kullanabilirsiniz.
   
   
5. İşlem tamam! Oyuncular artık birbirleriyle savaşmak için /duel davet <oyuncu> komutunu kullanabilirler!
   

Komutlar ve Yetkiler
Not: Oyuncu komutları aktif dile göre dinamik olarak değişir. Aşağıda Türkçe komutlar gösterilmektedir.

Oyuncu Komutları (Yetki gerektirmez):

• /duel - Yardım menüsünü gösterir.
  
  
• /duel davet <oyuncu> - Bir oyuncuya meydan okumak için ayarlar menüsünü açar.
  
  
• /duel kabul <oyuncu> - Belirli bir oyuncudan gelen düello davetini kabul eder.
  
  
• /duel reddet <oyuncu> - Bekleyen bir düello davetini reddeder.
  
  
• /duel berabere - Rakibinize beraberlik teklifi gönderir veya onlardan geleni kabul eder.
  
  
• /duel izle <oyuncu> - Sizi aktif bir düelloya izleyici (spectator) olarak ışınlar.
  
  
• /spawn - (İzleyici modundayken) İzleyici modundan anında çıkar ve sizi sunucu başlangıcına (spawn) ışınlar.
  

️ Admin Komutları (kaosduel.admin yetkisi gerektirir):

• /duel changelanguage <tr/en> - Global sunucu dilini değiştirir.
  
  
• /duel reload - Ayarları ve dil dosyalarını güvenli bir şekilde yeniler.
  
  
• /duel admin create <arena_ismi> - Yeni bir arena oluşturur.
  
  
• /duel admin delete <arena_ismi> - Bir arenayı kalıcı olarak siler.
  
  
• /duel admin setpos1 <arena_ismi> - 1. sınır köşesini ayarlar.
  
  
• /duel admin setpos2 <arena_ismi> - 2. sınır köşesini ayarlar.
  
  
• /duel admin setspawn1 <arena_ismi> - Oyuncu 1'in doğma noktasını ayarlar.
  
  
• /duel admin setspawn2 <arena_ismi> - Oyuncu 2'nin doğma noktasını ayarlar.
  
  
• /duel admin temizle <arena_ismi> - Manuel olarak arena temizliğini zorlar (blokları kaldırır ve içeride kalan oyuncuları çıkarır). ve bukadar