Hytale Sunucu Kurulumu: 2026 Tam Kurulum ve Yapılandırma Rehberi

By HytaleCharts Team Category: updates 8 min read

Bu kapsamlı rehber ile kendi Hytale özel sunucunuzu nasıl kuracağınızı öğrenin. Java kurulumu, sunucu dosyaları, kimlik doğrulama, port yapılandırması, güvenlik duvarı ayarları, modlar ve 2026 için optimizasyon ipuçlarını kapsar.

Kendi Hytale sunucunuzu barındırmaya hazır mısınız? Arkadaşlarınız için özel bir dünya oluşturuyor veya herkese açık bir topluluk sunucusu başlatıyor olun, bu kapsamlı rehber Java kurulumundan yüzlerce oyuncu için performans optimizasyonuna kadar sürecin her adımında size yol gösterir. Bu rehberin sonunda, oyuncuların katılabileceği tam işlevsel bir Hytale özel sunucunuz olacak. Başlayalım. Sistem Gereksinimleri Kuruluma başlamadan önce, sunucu makinenizin bu minimum gereksinimleri karşıladığından emin olun: BileşenMinimumÖnerilen RAM4 GB8-16 GB CPU2 çekirdek4+ çekirdek Depolama10 GB SSD50+ GB NVMe SSD JavaJava 25Java 25 (Adoptium önerilir) Mimarix64 ve arm64 desteklenir İşletim SistemiWindows, Linux veya macOS Kaynak Kullanımını Anlama Hytale sunucu kaynak tüketimi büyük ölçüde oyuncu davranışına bağlıdır: CPU Kullanımı: Oyuncu sayısı ve varlık sayısına (NPC'ler, mob'lar, aktif yaratıklar) bağlıdır RAM Kullanımı: Yüklenen dünya alanına bağlıdır — daha yüksek görüş mesafesi ve bağımsız keşif yapan oyuncular bellek ihtiyacını artırır İpucu: Sunucunuzun tipik tüketimini anlamak için oyun sırasında RAM ve CPU kullanımını izleyin. Yüksek CPU kullanımı fark ederseniz, bu aşırı çöp toplama işlemine neden olan bellek baskısına işaret edebilir — Java'nın -Xmx parametresini ayarlamayı deneyin. Adım 1: Java 25 Kurulumu Hytale sunucuları Java 25 gerektirir. Güvenilir, üretime hazır yapılar için Adoptium (eski adıyla AdoptOpenJDK) kullanmanızı öneririz. Java 25'i İndirin adoptium.net adresini ziyaret edin İşletim sisteminiz için JDK 25 yükleyicisini indirin Yükleyiciyi çalıştırın ve talimatları izleyin Kurulumu Doğrulayın Bir terminal veya komut istemi açın ve çalıştırın: java --version Şuna benzer bir çıktı görmelisiniz: openjdk 25.0.1 2025-10-21 LTS OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS) OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing) Farklı bir sürüm veya hata görüyorsanız, Java 25'in düzgün kurulduğundan ve sistem PATH'ine eklendiğinden emin olun. Adım 2: Sunucu Dosyalarını Edinin Hytale sunucu dosyalarını edinmek için iki seçeneğiniz var: Seçenek A: Oyun Kurulumunuzdan Kopyalayın (Hızlı Test) Hızlı kurulum için en kolay yöntem — dosyaları doğrudan Hytale başlatıcı kurulumunuzdan kopyalayın: Dosya Konumları: İşletim SistemiYol Windows%appdata%\Hytale\install\release\package\game\latest Linux$XDG_DATA_HOME/Hytale/install/release/package/game/latest macOS~/Application Support/Hytale/install/release/package/game/latest Server klasörünü ve Assets.zip dosyasını özel sunucu konumunuza kopyalayın. Seçenek B: Hytale Downloader CLI (Üretim Sunucuları) Üretim ortamları için resmi Hytale Downloader CLI aracını kullanın. Bu, güncellemeleri kolaylaştırır ve otomasyonu destekler: Resmi Hytale destek sitesinden hytale-downloader.zip dosyasını indirin Çıkartın ve dahil edilen QUICKSTART.md dosyasını okuyun En son sunucu dosyalarını almak için indiriciyi çalıştırın Yaygın Komutlar: KomutAçıklama ./hytale-downloaderEn son sürümü indir ./hytale-downloader -print-versionİndirmeden oyun sürümünü göster ./hytale-downloader -patchline pre-releaseÖn sürüm kanalından indir Adım 3: Sunucunuzu Başlatın Sunucu dizininize gidin ve şu komutla başlatın: java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip -XX:AOTCache bayrağı, sunucuyla birlikte gelen önceden eğitilmiş Ahead-Of-Time önbelleğini kullanarak başlangıç süresini önemli ölçüde iyileştirir. İlk Kimlik Doğrulama İlk başlatmadan sonra sunucunuzu doğrulamanız gerekir. Sunucu konsolunda çalıştırın: /auth login device Bir cihaz yetkilendirme istemi göreceksiniz: =================================================================== DEVICE AUTHORIZATION =================================================================== Visit: https://accounts.hytale.com/device Enter code: ABCD-1234 =================================================================== Waiting for authorization (expires in 900 seconds)... Tarayıcınızda gösterilen URL'yi ziyaret edin Hytale hesabınızla giriş yapın Konsolda görüntülenen kodu girin Konsola dönün — "Authentication successful!" mesajını görmelisiniz Önemli: Her Hytale oyun lisansı en fazla 100 sunucuyu destekler. Daha büyük dağıtımlar için ek lisans satın alın veya Sunucu Sağlayıcı hesabı başvurusunda bulunun. Adım 4: Port ve Güvenlik Duvarı Yapılandırması Hytale UDP üzerinden QUIC protokolü kullanır (TCP değil). Bu, güvenlik duvarı ve port yönlendirme yapılandırması için önemlidir. Varsayılan Port Varsayılan port 5520'dir. Farklı bir port kullanmak için: java -jar HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:3500 Port Yönlendirme Bir yönlendirici arkasında barındırıyorsanız, UDP port 5520'yi (veya özel portunuzu) sunucu makinenize yönlendirin. TCP yönlendirmesi gerekli değildir. Güvenlik Duvarı Yapılandırması Windows (Yönetici olarak PowerShell): New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow Linux (iptables): sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT Linux (ufw): sudo ufw allow 5520/udp NAT Hususları QUIC, çoğu senaryoda NAT geçişini iyi yönetir. Oyuncular bağlanmakta sorun yaşıyorsa: Port yönlendirmenin TCP değil UDP için ayarlandığından emin olun Simetrik NAT yapılandırmaları sorun çıkarabilir — VPS veya özel sunucu düşünün Operatör seviyesi NAT arkasındaki oyuncular (mobilde yaygın) istemci olarak sorunsuz bağlanabilmelidir Sunucu Dosya Yapısı Sunucunuzun dosya yapısını anlamak yönetim ve sorun gidermeye yardımcı olur: YolAçıklama .cache/Optimize edilmiş dosyalar için önbellek logs/Sunucu günlük dosyaları mods/Yüklü modlar universe/Dünya ve oyuncu kayıt verileri bans.jsonYasaklı oyuncular listesi config.jsonSunucu yapılandırması permissions.jsonİzin yapılandırması whitelist.jsonBeyaz listedeki oyuncular Dünya Yapısı Dünyalar universe/worlds/ içinde saklanır. Her dünyanın kendi config.json dosyası vardır ve şu ayarları içerir: Dünya tohumu ve oluşturma tipi PvP açık/kapalı Düşme hasarı ayarları NPC doğma davranışı Gerekli eklentiler Her dünya kendi ana iş parçacığında çalışır, paralel iş paylaşımlı bir iş parçacığı havuzuna dağıtılır. Mod Kurulumu Hytale sunucunuza mod eklemek basittir: CurseForge veya diğer güvenilir kaynaklardan modları (.zip veya .jar dosyaları) indirin Mod dosyalarını sunucunuzun mods/ klasörüne yerleştirin Sunucuyu yeniden başlatın Not: Birçok mod yalnızca sunucu tarafında çalışır — sunucunuza katılan oyuncular mod içeriğini manuel kurulum yapmadan otomatik olarak alır. Performans Optimizasyonu Görüş Mesafesi Görüş mesafesi RAM kullanımının birincil belirleyicisidir. Varsayılan 384 blok (12 chunk) görüş mesafesi, yaklaşık 24 Minecraft chunk'ına eşdeğerdir. Öneriler: Küçük sunucular (1-10 oyuncu) için: Varsayılan ayarlar iyi çalışır Orta sunucular (10-50 oyuncu) için: 8-10 chunk ile sınırlandırmayı düşünün Büyük sunucular (50+ oyuncu) için: 6-8 chunk ile sınırlandırın ve kaynakları izleyin Önerilen Eklentiler Büyük hosting sağlayıcıları sunucu yönetimi için faydalı eklentiler sağlar: EklentiAçıklama Nitrado:WebServerWeb uygulamaları ve API'ler için temel eklenti Nitrado:QueryHTTP üzerinden sunucu durumunu gösterir (oyuncu sayıları vb.) Nitrado:PerformanceSaverKaynaklara göre görüş mesafesini dinamik olarak sınırlar ApexHosting:PrometheusExporterAyrıntılı sunucu ve JVM metriklerini sunar Geliştirme Sırasında Sentry'yi Devre Dışı Bırakma Eklenti geliştiriyorsanız, geliştirme hatalarını göndermemek için çökme raporlamasını devre dışı bırakın: java -jar HytaleServer.jar --assets Assets.zip --disable-sentry Sunucu Komutları Referansı Tüm mevcut sunucu argümanlarını görüntüleyin: java -jar HytaleServer.jar --help Yaygın Argümanlar: ArgümanAçıklama --assets <path>Assets.zip yolu (varsayılan: ../HytaleAssets) --bind <address:port>Dinlenecek adres (varsayılan: 0.0.0.0:5520) --auth-mode <mode>Kimlik doğrulama modu: authenticated veya offline --backupOtomatik yedeklemeyi etkinleştir --backup-dir <path>Yedek dizini konumu --backup-frequency <minutes>Yedekleme aralığı (varsayılan: 30) --disable-sentryÇökme raporlamasını devre dışı bırak Çoklu Sunucu Mimarisi Hytale, sunucular arasında oyuncu yönlendirmeyi yerel olarak destekler — BungeeCord gibi bir ters proxy gerekli değildir. Oyuncu Yönlendirme Bağlı oyuncuları isteğe bağlı veri yükü ile diğer sunuculara aktarın: PlayerRef.referToServer(host, port, optionalData) Güvenlik Notu: Yük istemci üzerinden geçer ve kurcalanabilir. Alıcı sunucuda orijinalliği doğrulamak için kriptografik imzalama (örn. paylaşımlı gizli anahtarlı HMAC) kullanın. Bağlantı Yönlendirme Bağlantı el sıkışması sırasında, yük dengeleme veya bölgesel yönlendirme için oyuncuları farklı sunuculara yönlendirin. Bağlantı Kesilme Yedek Planı Oyuncular beklenmedik şekilde bağlantı kestiğinde (sunucu çökmesi, ağ sorunları), istemci ana menüye dönmek yerine önceden yapılandırılmış bir yedek sunucuya otomatik olarak yeniden bağlanır. Sunucunuzu Listeye Ekleyin Sunucunuz çalıştığında, oyuncuların önüne çıkarın: HytaleCharts'a gönderin: Ücretsiz görünürlük için sunucunuzu ekleyin Resmi Sunucu Keşfi: Hytale'ın yerleşik sunucu tarayıcısına katılın (yakında) Topluluğunuzu Oluşturun: Bir Discord sunucusu ve sosyal medya varlığı oluşturun Daha İyi Sıralama İçin İpuçları: Yüksek çalışma süresi sağlayın (%99+) Sunucunuzu en son sürüme güncelleyin İlgili anahtar kelimelerle etkileyici bir sunucu açıklaması yazın Oyuncuları sunucunuza oy vermeye teşvik edin Yaygın Sorunları Giderme Oyuncular Bağlanamıyor Güvenlik duvarınızın 5520 portunda UDP'ye izin verdiğini doğrulayın Port yönlendirmenin UDP (TCP değil) için ayarlandığını onaylayın Sunucunuzun kimlik doğrulamasının yapıldığını kontrol edin Oyuncuların sunucunuzla aynı oyun sürümünde olduğundan emin olun Yüksek Bellek Kullanımı Görüş mesafesini azaltın Maksimum oyuncu sayısını sınırlayın Bellek yoğun modları kontrol edin -Xmx parametresini uygun şekilde ayarlayın Sunucu Gecikmesi Varlık sayısını izleyin (çok fazla mob/NPC) Yoğun saatlerde CPU kullanımını kontrol edin Performans izleme eklentileri kullanın Sürekli maksimumda çalışıyorsa donanım yükseltmesi düşünün Kimlik Doğrulama Sorunları /auth login device komutunu yeniden çalıştırın Hytale hesabınızın iyi durumda olduğundan emin olun Lisans başına 100 sunucu sınırını aşmadığınızı kontrol edin Önemli Noktalar Java 25 Gerekli: Güvenilir yapılar için Adoptium kullanın UDP Port 5520: QUIC protokolü TCP değil UDP gerektirir Kimlik Doğrulama Gerekli: İlk başlatmadan sonra /auth login device çalıştırın Görüş Mesafesi = RAM: Bellek kullanımını azaltmak için görüş mesafesini düşürün AOT Önbellek: Daha hızlı başlatma için -XX:AOTCache=HytaleServer.aot kullanın Mod Klasörü: Modları mods/ klasörüne bırakın ve yeniden başlatın Yerel Çoklu Sunucu: Sunucular arası transferler için proxy gerekli değil Hytale sunucunuz artık oyunculara hazır. Topluluğunuzu oluşturmaya başlamak için HytaleCharts'a gönderin!