> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.atlantisproject.com.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# AtlantisKlan

> Minecraft sunucuları için sıfırdan kodlanmış, yüksek performanslı ve modern klan yönetim eklentisi.

<Note>
  AtlantisKlan, sıradan klan eklentilerinin aksine sunucunuzu yormayacak şekilde asenkron veritabanı işlemleriyle geliştirilmiştir. Tamamen lisanssız, özgür ve özelleştirilebilir bir yapıya sahiptir.
</Note>

## 🚀 Öne Çıkan Özellikler

AtlantisKlan, sunucunuzdaki klan savaşlarını ve rekabeti en üst düzeye çıkarmak için tasarlandı:

<CardGroup cols={2}>
  <Card icon="chart-simple" title="Gelişmiş İstatistik ve Sıralama">
    Klanların ve oyuncuların öldürme (kill), ölme (death) ve K/D oranlarını detaylıca kaydeder. Otomatik güncellenen klan sıralama (Top 10) sistemi sunar.
  </Card>

  <Card icon="keyboard" title="Kusursuz Tab Complete">
    Tüm komutlar ve alt komutlar için akıllı `Tab Complete` desteği mevcuttur. Oyuncular komut yazarken otomatik tamamlama sayesinde zorlanmadan klanlarını yönetebilir.
  </Card>

  <Card icon="skull" title="Ölüm Mesajı Yönetimi">
    Klan üyelerinin oyun içi ölüm mesajlarını açıp kapatabilmesi (toggle) için özel bir sistem içerir. Sohbet kirliliğini tamamen oyuncunun inisiyatifine bırakır.
  </Card>

  <Card icon="plug" title="PlaceholderAPI Desteği">
    Tablo (Scoreboard), Tab listesi ve sohbet (Chat) için eklentiye özel onlarca değişken (placeholder) sunar. Bütün modern pluginlerle tam uyumlu çalışır.
  </Card>
</CardGroup>

## ⌨️ Temel Komutlar ve Yetkiler

Eklentideki tüm oyuncu komutları varsayılan olarak herkese açıktır. Yönetici (Admin) komutları için özel yetkiler (permissions) ayarlanmıştır.

<AccordionGroup>
  <Accordion title="Oyuncu Komutları (/klan)" icon="user">
    * `/klan kur <isim>` - Yeni bir klan oluşturur.
    * `/klan davet <oyuncu>` - Klanınıza yeni bir üye davet eder.
    * `/klan katıl <klan>` - Size gelen daveti kabul edip klana katılırsınız.
    * `/klan ayrıl` - Mevcut klanınızdan çıkış yaparsınız.
    * `/klan bilgi [isim]` - Kendi klanınızın veya başkasının klanının detaylarını görüntüler.
    * `/klan sıralama` - Sunucudaki en iyi klanları listeler.
  </Accordion>

  <Accordion title="Yönetici Komutları (/klanadmin)" icon="shield-halved">
    **Gerekli Yetki:** `atlantisklan.admin`

    * `/klanadmin reload` - Tüm yapılandırma (config) ve dil dosyalarını yeniler.
    * `/klanadmin sil <klan>` - Sunucudaki bir klanı zorla siler.
    * `/klanadmin setlevel <klan> <seviye>` - Bir klanın seviyesini manuel olarak ayarlar.
  </Accordion>
</AccordionGroup>

## 🧩 PlaceholderAPI Değişkenleri

Klan verilerini Scoreboard veya sohbet eklentilerinizde göstermek için aşağıdaki değişkenleri kullanabilirsiniz. Değişkenlerin aktif olması için `/papi reload` komutunu unutmayın!

| Değişken (Placeholder)  | Açıklama                                                                |
| :---------------------- | :---------------------------------------------------------------------- |
| `%atlantisklan_name%`   | Oyuncunun klan adını gösterir. Klanı yoksa config'deki boş metni yazar. |
| `%atlantisklan_level%`  | Oyuncunun klanının mevcut seviyesini gösterir.                          |
| `%atlantisklan_kills%`  | Klanın toplam öldürme sayısını yansıtır.                                |
| `%atlantisklan_deaths%` | Klanın toplam ölme sayısını yansıtır.                                   |
| `%atlantisklan_kd%`     | Klanın Kill/Death oranını (K/D) hesaplayıp gösterir.                    |

## ⚙️ Kurulum Adımları

1. Sunucunuzu durdurun.
2. `AtlantisKlan.jar` dosyasını sunucunuzun `plugins` klasörüne atın.
3. İsteğe bağlı olarak `PlaceholderAPI` eklentisinin de kurulu olduğundan emin olun.
4. Sunucuyu başlatın. Eklenti, gerekli `config.yml` ve dil dosyalarını otomatik olarak oluşturacaktır.
5. Veritabanı (MySQL/SQLite) ve diğer ayarları yapmak için `plugins/AtlantisKlan/config.yml` dosyasını düzenleyin ve ardından oyun içinden `/klanadmin reload` yazın.

***

## 📞 Sorun mu Yaşıyorsunuz?

Kurulumda veya yapılandırmada bir hata ile karşılaşırsanız, öncelikle [S.S.S](https://wiki.atlantisproject.com.tr/sss) sayfamızı inceleyin. Sorun devam ederse Discord sunucumuzdan destek alabilirsiniz.

<Card icon="discord" horizontal href="https://discord.atlantisproject.com.tr" title="Discord Destek Merkezi">
  AtlantisKlan ile ilgili hata bildirimleri, öneriler ve teknik destek için sunucumuza katılın.
</Card>