One Query Plugin Einrichtungsanleitung
Erfahre, wie du das One Query Plugin einrichtest, um Echtzeit-Spielerzahlen, Online-Spieler und Server-Infos auf deinem Hylist-Eintrag anzuzeigen.
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.
Was ist One Query?
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:
- Aktuelle Spielerzahl und maximale Spieler
- Liste der Online-Spieler mit Namen und UUIDs
- Server-Version und MOTD
- Liste der installierten Plugins
Schritt 1: Plugin installieren
Download and install either One Query or Hyvote on your Hytale server:
- Lade die neueste JAR von der GitHub-Releases-Seite herunter
- Platziere die JAR-Datei im Plugins-Verzeichnis deines Servers
- Starte deinen Server neu
Keine zusätzliche Konfiguration erforderlich! Das Plugin funktioniert sofort mit dem Port deines Spielservers (5520).
Schritt 2: Abfrage-Port in Hylist hinzufügen
Konfiguriere deinen Abfrage-Port im Hylist-Dashboard:
- Gehe zur Bearbeitungsseite deines Servers im Hylist-Dashboard
- Scrolle zum Abschnitt "Abfrage-Ports"
- Klicke auf "Abfrage-Port hinzufügen"
- Gib Port 5520 ein (oder den Port deines Spielservers, falls anders)
- Wähle optional einen Tag, um diesen Port mit einem Spielmodus zu verknüpfen
- Speichere deine Änderungen
Mehrere Spielmodi (Proxy-Netzwerke)
Wenn du mehrere Backend-Server betreibst, kannst du mehrere Abfrage-Ports hinzufügen - einen für jeden Spielmodus:
Port 5520 -> No tag (Lobby) Port 5521 -> PvP Port 5522 -> Survival Jeder Backend-Server benötigt seine eigene One Query Plugin-Instanz. Der Tag hilft Besuchern zu verstehen, zu welchem Spielmodus jede Spielerliste gehört.
Einrichtung überprüfen
Nach der Konfiguration überprüfe deine Einrichtung:
- Stelle sicher, dass dein Server online ist und das One Query Plugin läuft
- Warte einige Minuten, bis Hylist deinen Server abfragt
- Besuche die Seite deines Servers auf Hylist
- Du solltest Spielerzahl, Online-Spieler, Version und Plugin-Informationen sehen
Wenn alles funktioniert, siehst du ein grünes "Online"-Abzeichen und Echtzeit-Spielerinformationen auf deiner Serverseite!
Fehlerbehebung
Keine Daten auf Hylist?
- Überprüfe, ob die One Query Plugin-JAR in deinem Plugins-Ordner ist
- Überprüfe deine Server-Logs auf Plugin-Fehler
- Stelle sicher, dass die Portnummer in Hylist mit deinem Server-Port übereinstimmt (Standard: 5520)
- Warte 5-10 Minuten, bis Hylist die Serverdaten aktualisiert
Falsche Spielerzahl oder Informationen?
- Stelle sicher, dass der Query-Port auf den richtigen Server zeigt
- Bei mehreren Servern stelle sicher, dass jeder seinen eigenen Port konfiguriert hat
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.