Hytale Sunucu Listesinde Çevrimiçi Oyuncu Sayısı Nasıl Gösterilir

Bir oyuncu Hytale sunucu listesini incelerken, "Katıl"a tıklayıp tıklamayacağına bir sayı karar verir: oyuncu sayısı. 47/100 oyuncu gösteren bir sunucu canlı hissettirir. Hiçbir şey göstermeyen — veya sadece "Çevrimdışı" gösteren — bir sunucu, düzgün çalışsa bile hayalet kasaba gibi hissettirir. HytaleCharts, Hytale sunucunuzun gerçek zamanlı oyuncu sayısını ve çevrimiçi durumunu göstermek için üç yol sunar. Her yöntemin doğruluk, kurulum çabası ve özellikler açısından farklı avantaj ve dezavantajları vardır. Bu kılavuz üçünü de açıklar, böylece kurulumunuz için doğru olanı seçebilirsiniz. Üç Yönteme Genel Bakış YöntemOyuncu SayısıGüncelleme HızıKurulum ÇabasıEn İyi Kullanım Heartbeat EklentisiTam sayı + oyuncu listesiHer 60 saniyeEklenti kurKendi barındırdığı sunucular Harici SorguTam sayıHer 5 dakikaURL ayarlaNitrado / yönetilen hostlar UDP PingYalnızca çevrimiçi/çevrimdışıPeriyodikYok (otomatik)Temel durum yedeği Yöntem 1: HytaleCharts Heartbeat Eklentisi (Önerilen) Heartbeat eklentisi, Hytale sunucu listesinde oyuncu sayınızı göstermenin en iyi yoludur. Hytale sunucunuzda çalışır ve her 60 saniyede çevrimiçi oyuncuların tam sayısı ve kullanıcı adları dahil olmak üzere HytaleCharts'a bir heartbeat sinyali gönderir. Ne Raporlar Player count — mevcut bağlı oyuncu sayısı Maksimum oyuncu — sunucunuzun oyuncu kapasitesi Oyuncu listesi — bağlı oyuncuların bireysel kullanıcı adları ve UUID'leri Eklenti sürümü — HytaleCharts'ın güncellemeler hakkında sizi uyarabilmesi için Perde Arkasında Nasıl Çalışır The plugin sends a POST request to /api/heartbeat every 60 seconds The request includes your server's secret key (a 64-character hex string) HytaleCharts validates the secret, updates your server's player count and status If no heartbeat is received for 5 minutes, the server is marked offline Historical data is stored for analytics and player count graphs Kurulum Adımları Heartbeat gizli anahtarı oluşturun — on HytaleCharts, go to Edit Server and click "Generate Heartbeat Secret" in the Heartbeat Plugin section Copy the secret — you'll only see it once (you can regenerate if lost) Install the HytaleCharts plugin on your Hytale server by placing it in your server's mods/ directory Configure the plugin — create or edit config.json in the plugin's data directory: { "secret": "YOUR_64_CHARACTER_SECRET_HERE", "debug": false } Restart your server — the plugin will begin sending heartbeats immediately Verify on HytaleCharts — your server should show as online with a player count within 60 seconds Çoklu Örnek Desteği If you run multiple server instances (e.g., a lobby server and a survival server), the heartbeat system aggregates player counts automatically. All instances sharing the same secret key will have their unique players merged and totals summed. This means your Hytale server list entry shows the correct total across your entire network. The system identifies unique instances by IP address and world name, takes the latest heartbeat from each source, and merges players by UUID to avoid double-counting anyone connected to multiple instances. Eklenti Güncellemeleri HytaleCharts tracks your plugin version. If a newer version is available, your Edit Server page will show an "Update Available" warning. Keeping the plugin current ensures compatibility with any API changes and gets you the latest bug fixes. Yöntem 2: Harici Sorgu Endpoint'i (Nitrado ve Yönetilen Hostlar) Not all Hytale server operators have access to install custom plugins. If you're using Nitrado, a container-based host, or any provider that exposes a query endpoint, the external query system is your solution. Nasıl Çalışır You provide HytaleCharts with a URL that returns your server's player count as JSON HytaleCharts polls that URL every 5 minutes The response is parsed and your player count is updated on the server list If the endpoint becomes unreachable, your server status reflects the change within 10 minutes Desteklenen Yanıt Formatları HytaleCharts auto-detects multiple JSON formats, so it works with most query endpoints out of the box: Nitrado Formatı { "Universe": { "CurrentPlayers": 15 }, "Server": { "MaxPlayers": 100 } } Standart Format { "player_count": 15, "max_players": 100 } Also supports camelCase (playerCount, maxPlayers) and shorthand (online, max) variants. Kurulum Adımları Hosting sağlayıcınızda bir sorgu endpoint'i bulun veya yapılandırın a query endpoint on your hosting provider (Nitrado provides one by default) On HytaleCharts, go to Edit Server → External Query Enter the full URL to your query endpoint Click "Test Endpoint" to verify the response is parseable Save — HytaleCharts starts polling immediately The external query method updates less frequently than the heartbeat plugin (every 5 minutes vs. every 60 seconds), but it requires zero server-side modifications. Yöntem 3: UDP Ping (Otomatik Yedek) If you haven't configured either the heartbeat plugin or an external query endpoint, HytaleCharts will attempt to check your server's status via UDP ping. This is a passive system that requires no setup on your end. Nasıl Çalışır HytaleCharts sends a minimal QUIC protocol probe to your server's public port (default: 5520) If any response is received, the server is marked online If no response after multiple retries, the server is marked offline Sınırlamalar No player count — UDP ping can only determine online vs. offline, not how many players are connected No player list — no individual player data is available Less accurate timing — status updates depend on the polling schedule rather than real-time heartbeats UDP ping is useful as a baseline, but servers serious about climbing the Hytale server list rankings should install the heartbeat plugin or configure an external query for accurate player counts. HytaleCharts Sunucunuzun Durumunu Nasıl Belirler When multiple methods are available, HytaleCharts uses a öncelik sistemi kullanarak hangi veri kaynağına güvenileceğine karar verir: External Query (en yüksek öncelik, etkinleştirilmişse) — son başarılı yoklama 10 dakika içindeyse çevrimiçi Heartbeat Plugin (yapılandırılmışsa) — son heartbeat 5 dakika içindeyse çevrimiçi UDP Ping (yedek) — son kontrolden saklanan çevrimiçi/çevrimdışı sonucunu kullanır This means if you have both the heartbeat plugin and an external query configured, the external query takes precedence. Most operators will use one or the other, not both. Oyuncular Ne Görür On the Hytale server list, sunucunuzun durumu renkli bir rozet olarak görünür: Green badge with player count (e.g., "Online — 47 players") — when online and players are detected Green badge ("Online") — when online but no players or count unavailable Red badge ("Offline") — when no recent heartbeat, query, or ping response Servers with visible player counts consistently attract more clicks. A server showing "Online — 23 players" is far more compelling than one that just says "Online" with no count. This is why the heartbeat plugin or external query is important for en iyi Hytale sunucuları. Sorun Giderme SorunOlası NedenÇözüm Sunucu çalışmasına rağmen "Çevrimdışı" gösteriyorGüvenlik duvarı heartbeat veya ping'i engelliyorSunucunuzun hytalecharts.com'a giden HTTPS istekleri yapabildiğinden emin olun Oyuncu sayısı 0'da takılıEklenti oyuncu olaylarını izlemiyorEklentinin yüklendiğini doğrulayın (sunucu günlüklerini kontrol edin) ve yeniden başlatın Heartbeat bir süre sonra duruyorEklenti çöktü veya kaldırıldıSunucu günlüklerinde hataları kontrol edin, gerekirse eklentiyi yeniden yükleyin Harici sorgu yanlış sayı gösteriyorEndpoint eski veri döndürüyorJSON yanıtını doğrudan bir tarayıcıda doğrulayın Çoklu örnek sayısı çok düşükÖrnekler farklı gizli anahtarlar kullanıyorTüm örnekler aynı heartbeat gizli anahtarını paylaşmalıdır "Güncelleme Mevcut" uyarısıEklenti güncel değilHytaleCharts'tan en son eklenti sürümünü indirin En İyi Uygulamalar En iyi Hytale sunucularını yöneten operatörler bu kalıpları takip eder: Mümkün olduğunda heartbeat eklentisini kullanın — en doğru ve duyarlı seçenektir Gerçekçi bir maksimum oyuncu sayısı belirleyin — şişirilmiş limitler (örn. 999) dürüst görünmez ve güveni azaltır Heartbeat durumunuzu izleyin — hatalar için Sunucu Düzenle sayfasını düzenli olarak kontrol edin Eklentiyi güncel tutun — eski eklentiler API değişikliklerinden sonra çalışmayabilir Yedek olarak harici sorgu kullanın — eklentiniz çökerse, çalışan bir harici endpoint durumunuzu doğru tutar Domaininizin doğru olduğundan emin olun — UDP ping yedeği yapılandırılmış domaininizi kullanır, bu yüzden esas olarak heartbeat kullansanız bile doğru tutun Başlarken Heartbeat eklentisi ile oyuncu sayınızı göstermek beş dakikadan az sürer. Bir gizli anahtar oluşturun, eklentiyi kurun, gizli anahtarınızı yapılandırmaya ekleyin ve yeniden başlatın. Hytale sunucunuz bir dakika içinde canlı oyuncu sayısıyla Hytale sunucu listesinde görünecektir. Nitrado gibi yönetilen hosting sağlayıcıları için harici sorgu daha da basittir — sadece bir URL yapıştırın ve HytaleCharts gerisini halleder. Her iki durumda da, gerçek oyuncu sayısı göstermek sunucunuzun görünürlüğünü artırmak ve yeni oyuncuları çekmek için yapabileceğiniz en kolay şeylerden biridir. Hytale sunucu listesinde aktif oyuncu sayıları gösteren sunucular, göstermeyenleri sürekli olarak geride bırakır.