One Query Eklenti Kurulum Rehberi
Hylist listenizde gerçek zamanlı oyuncu sayısı, çevrimiçi oyuncular ve sunucu bilgilerini görüntülemek için One Query eklentisini nasıl kuracağınızı öğrenin.
Supported Plugins
Hylist supports two query plugins. Install one of them (not both - they are mutually exclusive):
One Query
The recommended plugin with full feature support including plugin version and status info.
Hyvote
Alternative plugin with configurable exports. Lets you toggle exactly what data to expose.
Important: These plugins are mutually exclusive. Only install one of them - do not install both on the same server.
One Query Nedir?
These plugins enable server status queries using UDP. They share your game server port, so no additional ports or firewall configuration is needed. This allows Hylist to fetch real-time data about your server, including:
- Mevcut oyuncu sayısı ve maksimum oyuncu
- Adları ve UUID'leri ile çevrimiçi oyuncuların listesi
- Sunucu versiyonu ve MOTD
- Yüklü eklentilerin listesi
Adım 1: Eklentiyi Yükleyin
Download and install either One Query or Hyvote on your Hytale server:
- GitHub sürümler sayfasından en son JAR'ı indirin
- JAR dosyasını sunucunuzun plugins dizinine yerleştirin
- Sunucunuzu yeniden başlatın
Ek yapılandırma gerekmez! Eklenti, oyun sunucunuzun portu (5520) ile doğrudan çalışır.
Adım 2: Hylist'te Sorgu Portu Ekleyin
Hylist panelinde sorgu portunuzu yapılandırın:
- Hylist panelinde sunucunuzun düzenleme sayfasına gidin
- "Sorgu Portları" bölümüne kaydırın
- "Sorgu Portu Ekle" düğmesine tıklayın
- 5520 portunu girin (veya farklıysa oyun sunucunuzun portu)
- İsteğe bağlı olarak bu portu bir oyun moduyla ilişkilendirmek için bir etiket seçin
- Değişikliklerinizi kaydedin
Birden Fazla Oyun Modu (Proxy Ağları)
Birden fazla backend sunucusu çalıştırıyorsanız, birden fazla sorgu portu ekleyebilirsiniz - her oyun modu için bir tane:
Port 5520 -> No tag (Lobby) Port 5521 -> PvP Port 5522 -> Survival Her backend sunucusunun kendi One Query eklenti örneğine ihtiyacı vardır. Etiket, ziyaretçilerin her oyuncu listesinin hangi oyun moduna ait olduğunu anlamasına yardımcı olur.
Kurulumunuzu Doğrulayın
Her şeyi yapılandırdıktan sonra kurulumunuzu doğrulayın:
- Sunucunuzun çevrimiçi olduğundan ve One Query eklentisinin çalıştığından emin olun
- Hylist'in sunucunuzu sorgulaması için birkaç dakika bekleyin
- Hylist'te sunucunuzun sayfasını ziyaret edin
- Oyuncu sayısı, çevrimiçi oyuncular, versiyon ve eklenti bilgilerini görmelisiniz
Her şey çalışıyorsa, sunucu sayfanızda yeşil bir "Çevrimiçi" rozeti ve gerçek zamanlı oyuncu bilgileri göreceksiniz!
Sorun Giderme
Hylist'te veri görünmüyor mu?
- One Query eklentisi JAR dosyasının plugins klasörünüzde olduğunu doğrulayın
- Sunucu günlüklerinizi eklenti hataları için kontrol edin
- Hylist'teki port numarasının sunucu portunuzla eşleştiğinden emin olun (varsayılan: 5520)
- Hylist'in sunucu verilerini yenilemesi için 5-10 dakika bekleyin
Yanlış oyuncu sayısı veya bilgi mi?
- Sorgu portunun doğru sunucuya yönlendirildiğinden emin olun
- Birden fazla sunucu kullanıyorsanız, her birinin kendi port yapılandırmasına sahip olduğundan emin olun
Why Server Query Matters for Your Listing
Adding server query to your Hytale server listing significantly improves your visibility and credibility on Hylist. Here's how real-time server data impacts your server's performance on the platform.
Higher Search Ranking
Servers with active query data appear higher in filtered searches. When players filter by "online only" or sort by player count, your server will only appear if query data is available. Without it, you're invisible to a significant portion of potential players.
Player Trust
Displaying real-time player counts and server status builds trust with potential players. A server showing "42 players online" is far more compelling than one with no data. Players are more likely to join and vote for servers they can verify are active.
Analytics Insights
Query data feeds into your server's analytics dashboard, showing player count trends over time. You can identify peak hours, track growth, and measure the impact of promotional campaigns or content updates.
Discord Integration
The Hylist Discord bot uses query data to display live player counts and server status in your Discord server. Without query configured, these stat channels will show limited information.