> ## 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.

# Sıkça Sorulan Sorular (S.S.S)

> AtlantisProject eklentilerinde karşılaşılan genel sorunlar, konsol hataları ve detaylı çözüm yolları.

<Note>
  Discord sunucumuzda destek talebi oluşturmadan önce lütfen bu sayfadaki yaygın sorunları ve çözüm yollarını inceleyin. Hataların %90'ı genellikle sürüm veya config uyumsuzluklarından kaynaklanmaktadır.
</Note>

## ⚙️ Kurulum ve Konsol Hataları

<AccordionGroup>
  <Accordion title="Eklentiyi klasöre attım ama /pl yazınca kırmızı gözüküyor veya hiç çalışmıyor." icon="circle-exclamation">
    Bu durum eklentinin başlatılamadığını gösterir. Konsol loglarını (`latest.log`) kontrol edin. Başlıca sebepleri:

    * **Eski Java Sürümü:** Konsolda `UnsupportedClassVersionError` görüyorsanız, Java sürümünüz yetersizdir. Java 17 veya 21 kullanmanız gerekir.
    * **Eksik Bağımlılık (Dependency):** Eklentinin çalışması için Vault, PlaceholderAPI gibi eklentilerin sunucunuzda kurulu ve güncel olması gerekebilir.
  </Accordion>

  <Accordion title="Konsolda 'Could not pass event...' hatası alıyorum." icon="bug">
    Bu hata genellikle eklenti oyun içi bir tetikleyiciyi (örn: oyuncu ölmesi, blok kırılması) işlerken bir veriye ulaşamadığında çıkar.

    * `config.yml` dosyanızda sildiğiniz veya eksik bıraktığınız bir satır olabilir.
    * Olayın yaşandığı Minecraft sürümü ile eklentinin desteklediği API arasında uyuşmazlık olabilir. Config dosyanızı yedekleyip silin ve eklentinin yeni bir config oluşturmasına izin verin.
  </Accordion>

  <Accordion title="Eklentiyi kurdum ama komutları yazdığımda 'Bilinmeyen Komut' hatası veriyor." icon="terminal">
    Eklenti konsolda başarılı bir şekilde aktifleştiği (`[AtlantisProject] Plugin Enabled!`) halde komutlar çalışmıyorsa, kullandığınız yetki eklentisinde (LuckPerms vb.) kendinize gerekli admin yetkilerini (permissions) vermemiş olabilirsiniz veya eklentinin başka bir eklentiyle komut çakışması (örn: `/klan` komutunu başka bir pluginin de kullanması) yaşanıyor olabilir.
  </Accordion>
</AccordionGroup>

## 💾 Veritabanı (MySQL & SQLite) Sorunları

<AccordionGroup>
  <Accordion title="Verilerim kaydedilmiyor veya sunucu yeniden başlayınca sıfırlanıyor." icon="database">
    Eğer varsayılan veritabanı olarak **SQLite** (yerel dosya) kullanıyorsanız ve sunucunuz crash yiyip aniden kapanırsa (veya panelden zorla durdurulursa), veriler `.db` dosyasına yazılamadan kaybolabilir. Sunucuyu her zaman `/stop` komutu ile güvenli bir şekilde kapatın. BungeeCord/Velocity gibi büyük ağlarda mutlaka MySQL kullanın.
  </Accordion>

  <Accordion title="MySQL bağlantısı kuramıyorum, 'Communications link failure' veriyor." icon="network-wired">
    Bu tamamen makinenizin ağ ayarlarıyla ilgili bir durumdur. Şunları kontrol edin:

    * `config.yml` içindeki veritabanı adı, kullanıcı adı, şifre ve port (genelde 3306) bilgilerinin doğruluğu.
    * Eğer veritabanı farklı bir makinedeyse, o makinenin dış bağlantılara (Remote MySQL) açık olup olmadığı.
    * Güvenlik duvarınızın (Firewall) 3306 portunu engelleyip engellemediği.
  </Accordion>
</AccordionGroup>

## 🧩 PlaceholderAPI ve Değişkenler

<AccordionGroup>
  <Accordion title="Scoreboard veya Tab'da değişkenler (örn: %atlantis_klan%) çalışmıyor, olduğu gibi metin olarak gözüküyor." icon="code-branch">
    Değişkenlerin çalışması için öncelikle sunucunuzda PlaceholderAPI eklentisinin yüklü olması gerekir. Ardından, oyun içinden `/papi reload` komutunu yazarak sistemin yeni değişkenleri tanımasını sağlamalısınız. Eğer eklentimiz harici bir PAPI eklentisi (expansion) gerektiriyorsa, kurulum adımlarını doğru uyguladığınızdan emin olun.
  </Accordion>

  <Accordion title="Sohbet (Chat) formatında renk kodları veya klan tagı gözükmüyor." icon="message">
    Kullandığınız sohbet yönetim eklentisi (örn: EssentialsChat, LPC, ChatControl) PlaceholderAPI değişkenlerini doğrudan desteklemiyor olabilir. Sohbet eklentinizin config dosyasından PlaceholderAPI desteğinin aktif (`true`) olup olmadığını kontrol edin.
  </Accordion>
</AccordionGroup>

## 🎨 Özelleştirme ve Config (YAML) Ayarları

<AccordionGroup>
  <Accordion title="Config dosyasını düzenledikten sonra eklenti bozuldu veya sıfırlandı." icon="file-lines">
    YAML dosyaları karakter hatalarına karşı çok hassastır. Büyük ihtimalle:

    * Boşluk bırakmak yerine **TAB** tuşunu kullandınız (YAML dosyalarında TAB tuşu kullanılmaz, sadece boşluk tuşu kullanılır).
    * Metinlerin başındaki veya sonundaki tırnak işaretlerini (`'...'` veya `"..."`) yanlışlıkla sildiniz.
    * Türkçe karakter sorunu olmaması için dosyayı **UTF-8** formatında kaydettiğinizden emin olun. (YAML Validator sitelerini kullanarak dosyanızı test edebilirsiniz).
  </Accordion>

  <Accordion title="Hex (RGB) ve Gradient (Geçişli) renk kodlarını nasıl kullanırım?" icon="palette">
    Eklentilerimiz 1.16+ üstü sürümler için modern renk kodlarını destekler. Genellikle `&#RRGGBB` formatını kullanabilirsiniz. Örneğin: turuncu gölgeli veya özel renkli bir metin yapmak için `&#FFA500Bu bir turuncu metindir` şeklinde yazabilirsiniz. Klasik Minecraft renk kodları (`&a`, `&b`, `&l`) her zaman desteklenmektedir.
  </Accordion>
</AccordionGroup>

## ⚡ Performans (TPS & Lag)

<AccordionGroup>
  <Accordion title="Eklentileriniz sunucumda TPS düşüşüne veya lag'a sebep olur mu?" icon="gauge-high">
    Kesinlikle hayır. AtlantisProject eklentilerinin mimarisi tamamen optimizasyon odaklıdır. Veritabanı kayıtları (MySQL/SQLite) ve oyuncu veri çekme işlemleri **Asenkron (Async)** olarak ayrı iş parçacıklarında (threads) yapılır. Bu sayede sunucunun ana thread'i (Main Thread) meşgul edilmez ve oyun akışında donma yaşanmaz.
  </Accordion>
</AccordionGroup>

***

## 📞 Hâlâ Çözüm Bulamadınız Mı?

Yukarıdaki çözümler işinize yaramadıysa veya karşılaştığınız sorun burada yer almıyorsa, doğrudan geliştirici ekibimizden destek alabilirsiniz.

<Card icon="discord" horizontal href="https://discord.atlantisproject.com.tr" title="Destek Talebi (Ticket) Oluşturun">
  Discord sunucumuza katılarak 'Destek' kanalından bilet oluşturun. Lütfen sorununuzu açıklarken konsol loglarınızı (latest.log) göndermeyi unutmayın.
</Card>