Ana içeriğe atla
Bu doküman, ZonelyCore eklentisini Hytale sunucunuza kurmayı, SecureSocket ile mağaza/panel bağlantısı yapmayı ve temel sistemleri kullanmayı anlatır.

​
1) Gereksinimler

  • Çalışan bir Hytale sunucusu
  • Sunucuda Java 21
  • MySQL/MariaDB veritabanı
  • SecureSocket kullanacaksanız bir TCP portu açma yetkisi

​
2) Kurulum

  1. En güncel ZonelyCore Hytale jar dosyasını indirin:
    https://zonely.gen.tr/plugins/zonelycorehytale-1.0.0.jar
  2. Jar dosyasını sunucunuzun mod/eklenti dizinine kopyalayın (genellikle mods/).
  3. Sunucuyu bir kez çalıştırın ve config dosyasının oluşmasını bekleyin.
Oluşan dosya: mods/ZonelyCore/config.yml (bazı panellerde plugins/ZonelyCore/config.yml)

​
3) Veritabanı ayarı

ZonelyCore, MySQL/MariaDB kullanır. config.yml dosyasında ya tam JDBC URL girin ya da host/port/name alanlarını doldurun. Örnek: 
db_url: ""
host: "127.0.0.1"
port: 3306
name: "zonely"
username: "root"
password: ""

​
4) SecureSocket (mağaza/panel bağlantısı)

SecureSocket, mağazanızın/panelinizin sunucuya güvenli komut göndermesini sağlar. config.yml içinde açın: 
socket_enabled: true
socket_port: 5555
socket_token: "YOUR_SECRET_TOKEN"
socket_port sadece panel IP’sine açık olmalı. Herkese açık bırakmayın.

​
5) Auth sistemi

İlk girişte oyuncu otomatik kayıt edilir ve /register ile şifre belirlemesi istenir.
Kayıt tamamlanana kadar oyuncu hareket edemez ve sadece /register komutunu kullanabilir. Komutlar:
  • /register <sifre> <sifre>
  • /password <yeni> <tekrar>
  • /email <eposta>

​
6) Kredi sistemi

Komutlar:
  • /credit - kendi bakiyen
  • /credit show <oyuncu> - oyuncu bakiyesi
  • /credit set <oyuncu> <miktar>
  • /credit add <oyuncu> <miktar>
  • /credit remove <oyuncu> <miktar>
İzinler:
  • zonelycore.credit.manage
  • zonelycore.credit.show.other

​
7) Çoklu dil mesajları

config.yml içinde dili ayarla: 
language: "tr"
Ardından ilgili bloktan tüm mesajları düzenleyebilirsiniz:
  • messages_tr: Türkçe
  • messages_en: İngilizce

​
8) Sorun giderme

  • Eklenti yüklenmiyor
    • Java 21 kullanıldığını kontrol edin.
    • Jar dosyasının mods/ (veya plugins/) içinde olduğundan emin olun.
  • DB bağlantısı yok
    • Host/port/kullanıcı/şifre bilgilerini kontrol edin.
    • Veritabanı sunucudan erişilebilir mi kontrol edin.
  • SecureSocket çalışmıyor
    • socket_token paneldeki değerle aynı mı?
    • socket_port panel IP’sine açık mı?

​
9) Güvenlik önerileri

  • socket_token güçlü olsun.
  • socket_port sadece panel IP’sine açık olsun.
  • Token’ı düzenli aralıklarla değiştirin.
Kurulum tamam. Artık mağaza/panel üzerinden sunucunuza güvenli komut gönderebilirsiniz.