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

# AuthMe, LimboAuth ve Kayıt Sorunları

> Web sitesinden kayıt olan oyuncuların oyuna girememesi, SHA256 şifre hash uyumu ve LimboAuth MySQL bağlantı hataları.

Minecraft sunucunuz ile Zonely web sitesi arasındaki hesap senkronizasyonu; AuthMe veya LimboAuth eklentilerinin veritabanı bağlantısı ve şifreleme algoritması uyumuna bağlıdır.

***

## En Sık Karşılaşılan Sorunlar ve Çözümleri

> [accordion] Siteden kayıt olan oyuncu oyuna girdiğinde 'Yanlış Şifre' hatası alıyor
>
> Destek taleplerinde en çok bildirilen kayıt hatasıdır.
>
> * **Kök Neden:** Zonely web yazılımı kullanıcı şifrelerini güvenli **SHA256** hash algoritması ile özetleyerek veritabanına kaydeder. Minecraft sunucunuzdaki AuthMe eklentisi varsayılan olarak `BCRYPT`, `ARGON2` veya farklı bir algoritma kullanacak şekilde bırakıldıysa, AuthMe şifreyi aynı algoritmayla doğrulayamaz ve şifre yanlış uyarısı verir.
> * **Çözüm:**
>   1. Oyun sunucunuzun dosya yöneticisinden `plugins/AuthMe/config.yml` dosyasını açın.
>   2. `settings.security.passwordHash` satırını bulun ve değerini mutlaka **`SHA256`** olarak ayarlayın:
>      ```yaml title="plugins/AuthMe/config.yml" theme={"theme":"css-variables"}
>      settings:
>        security:
>          passwordHash: 'SHA256'
>      ```
>   3. Oyuncuların kayıt olurken e-posta zorunluluğu gibi alanlarının uyumu için `userslist` tablosunu kullandığınızdan emin olun.
>   4. Oyun konsolunda `/authme reload` komutunu çalıştırın.

> [accordion] LimboAuth veya AuthMe uzak MySQL veritabanına bağlanamıyor
>
> Genellikle *"Communications link failure"*, *"Connection refused"* veya *"Host 'x.x.x.x' is not allowed to connect to this MySQL server"* hataları ile kendini gösterir.
>
> * **1. MariaDB / MySQL Bind Address Yapılandırması:**
>   Veritabanı sunucunuz yalnızca yerel bağlantıları (`127.0.0.1`) dinleyecek şekilde yapılandırılmışsa, dışarıdan gelen oyun sunucunuzun isteklerini doğrudan reddeder.
>   * Sunucunuzdaki `/etc/mysql/my.cnf` (veya `mariadb.conf.d/50-server.cnf`) dosyasında:
>     ```ini title="MySQL Yapılandırması" theme={"theme":"css-variables"}
>     bind-address = 0.0.0.0
>     ```
>     olarak ayarlayın ve MySQL servisini yeniden başlatın.
>
> * **2. Güvenlik Duvarı (Port 3306) İzni:**
>   Web hosting veya VDS sağlayıcınızın güvenlik duvarında TCP `3306` portunun dış erişime açık olduğundan emin olun.
>
> * **3. Uzak Kullanıcı Yetkilendirmesi (`GRANT`):**
>   Veritabanı kullanıcınız yalnızca `localhost` için yetkilendirilmiş olabilir. MySQL konsolunda oyun sunucunuzun dış IP'sine veya tüm IP'lere (`%`) yetki verin:
>   ```sql title="MySQL Yetkilendirme Komutu" theme={"theme":"css-variables"}
>   GRANT ALL PRIVILEGES ON zonely_db.* TO 'veritabani_kullanici'@'%' IDENTIFIED BY 'guclu_sifreniz';
>   FLUSH PRIVILEGES;
>   ```

> [accordion] ZonelyCore ile AuthMe eklentisi çakışıyor
>
> ZonelyCore eklentisi içerisinde dahili bir giriş/oturum doğrulama sistemi barındırır.
>
> * **Kök Neden:** Sunucunuzda zaten AuthMe Reloaded veya LimboAuth aktifken, ZonelyCore'un da kimlik doğrulama modülü açık bırakılırsa oyuncular oyuna girdiğinde iki eklenti birden giriş mesajı gönderir veya oturum kilitlenir.
> * **Çözüm:**
>   1. `plugins/ZonelyCore/config.yml` dosyasını açın.
>   2. `auth.enabled` parametresini `false` olarak değiştirin:
>      ```yaml title="plugins/ZonelyCore/config.yml" theme={"theme":"css-variables"}
>      auth:
>        enabled: false
>      ```
>   3. Bu sayede kimlik doğrulama işlemi tamamen AuthMe tarafından yönetilirken, ZonelyCore yalnızca mağaza teslimatı ve GUI menü kancalarını yürütür.

> [accordion] LimboAuth şifreleme ve tablo yapısı nasıl olmalıdır?
>
> Çakma lobi / LimboAuth kurulumlarında `settings.conf` dosyasındaki veritabanı ayarlarının Zonely ile eşleşmesi için şu parametreleri kullanın:
>
> ```hocon title="LimboAuth settings.conf" theme={"theme":"css-variables"}
> database {
>   type = "MYSQL"
>   host = "veritabani_host_adresiniz"
>   port = 3306
>   database = "zonely_veritabani_adi"
>   username = "veritabani_kullanici"
>   password = "veritabani_sifresi"
>   table = "userslist"
>   columns {
>     username = "username"
>     password = "password"
>   }
> }
> crypto {
>   hash = "SHA256"
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.