Ana içeriğe atla
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: 
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: 
socket_enabled: true
socket_port: 5555
socket_token: "YOUR_SECRET_TOKEN"
socket_port değerini yalnızca panel IP adresine açın. Herkese açık şekilde yayınlamayın.

​
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: 
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.
Kurulum tamamlandı. Artık SecureSocket kullanarak Hytale sunucusunu mağaza panelinizden kontrol edebilirsiniz.