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

# Zonelycorehytale

ZonelyCore Hytale
SecureSocket mağaza entegrasyonu dahil ZonelyCore Hytale eklentisi için adım adım kurulum.
Bu rehber, **ZonelyCore** eklentisini Hytale sunucusuna nasıl kurup yapılandıracağınızı, **SecureSocket** üzerinden mağazanıza nasıl bağlayacağınızı ve yerleşik kimlik doğrulama ile kredi sistemlerini nasıl kullanacağınızı açıklar.

## 1) Ön Gereksinimler

* Çalışan bir **Hytale** sunucusu.
* Sunucuda **Java 21** (eklenti JDK 21 hedefler).
* Bir **MySQL/MariaDB** veritabanı (zorunlu).
* **SecureSocket** mağaza entegrasyonu istiyorsanız TCP portu açabilme imkanı.

## 2) Eklentiyi Kurma

1. En yeni `ZonelyCore` Hytale eklenti jar dosyasını indirin:\
   `https://zonely.gen.tr/plugins/zonelycorehytale-1.0.0.jar`
2. Jar dosyasını Hytale sunucunuzun mod/eklenti dizinine kopyalayın (genellikle `mods/`).
3. Yapılandırma dosyasını oluşturmak için sunucuyu bir kez başlatın.

İlk başlatmadan sonra şunu görmelisiniz:

`mods/ZonelyCore/config.yml` (bazı hostinglerde `plugins/ZonelyCore/config.yml` olabilir)

## 3) Veritabanını Yapılandırma

ZonelyCore için MySQL/MariaDB veritabanı gerekir. `mods/ZonelyCore/config.yml` (veya `plugins/ZonelyCore/config.yml`) dosyasını açın ve tam JDBC URL'si **veya** host/port/ad bilgilerini girin.

Örnek:

```yaml theme={null}
db_url: ""
host: "127.0.0.1"
port: 3306
name: "zonely"
username: "root"
password: ""
```

## 4) SecureSocket (Mağaza Entegrasyonu)

SecureSocket, mağazanızın/panelinizin sunucuya güvenli şekilde komut göndermesini sağlar.
`config.yml` içinde etkinleştirin:

```yaml theme={null}
socket_enabled: true
socket_port: 5555
socket_token: "YOUR_SECRET_TOKEN"
```

<Warning>
  `socket_port` değerini yalnızca panel IP adresine açın. Herkese açık şekilde yayınlamayın.
</Warning>

## 5) Kimlik Doğrulama Davranışı

Oyuncu ilk girişte otomatik olarak kaydedilir ve `/register` komutuyla şifre belirlemek zorundadır.
Kayıt tamamlanana kadar oyuncu dondurulur ve yalnızca `/register` komutunu kullanabilir.

Komutlar:

* `/register <password> <password>`
* `/password <new> <confirm>`
* `/email <email>`

Şifre formatı:

```
$SHA$<salt>$<hash>
```

E-posta isteğe bağlıdır.

## 6) Kredi Sistemi

Komutlar:

* `/credit` - bakiyenizi gösterir
* `/credit show <player>` - başka bir oyuncunun bakiyesini gösterir
* `/credit set <player> <amount>`
* `/credit add <player> <amount>`
* `/credit remove <player> <amount>`

İzinler:

* `zonelycore.credit.manage`
* `zonelycore.credit.show.other`

## 7) Çok Dilli Mesajlar

Dili `config.yml` içinde ayarlayın:

```yaml theme={null}
language: "en"
```

Ardından şunları düzenleyin:

* İngilizce için `messages_en:`
* Türkçe için `messages_tr:`

Daha fazla dil ekleyebilir (örnek: `messages_de`) ve `language: "de"` olarak ayarlayabilirsiniz.

## 8) Sorun Giderme

* **Eklenti yüklenmiyor**
  * Java 21 kullanıldığını kontrol edin.
  * Jar dosyasının doğru `mods/` (veya `plugins/`) dizininde olduğundan emin olun.
* **Veritabanı bağlantısı yok**
  * Host/port/ad/kullanıcı adı/şifre bilgilerini doğrulayın.
  * MySQL'in sunucudan erişilebilir olduğunu kontrol edin.
* **SecureSocket bağlantısı başarısız**
  * `socket_token` değerinin panelle eşleştiğini kontrol edin.
  * `socket_port` değerinin panel IP adresine açık olduğundan emin olun.
  * `eklenti_sunucus` içinde doğru `ip`, `port` ve `password` değerlerinin bulunduğunu doğrulayın.

## 9) Güvenlik İpuçları

* Güçlü bir `socket_token` kullanın.
* `socket_port` değerini panel IP adresiyle sınırlayın.
* Tokenları belirli aralıklarla yenileyin.
* Başarısız denemeleri panel tarafında loglayın ve rate limit uygulayın.

<Check>
  Kurulum tamamlandı. Artık SecureSocket kullanarak Hytale sunucusunu mağaza panelinizden kontrol edebilirsiniz.
</Check>