One Query Plugin Installatiehandleiding
Leer hoe je de One Query plugin instelt om realtime spelersaantallen, online spelers en serverinformatie op je Hylist-vermelding te tonen.
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.
Wat is 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:
- Huidig aantal spelers en maximum spelers
- Lijst van online spelers met hun namen en UUID's
- Serverversie en MOTD
- Lijst van geïnstalleerde plugins
Stap 1: Plugin Installeren
Download and install either One Query or Hyvote on your Hytale server:
- Download de nieuwste JAR van de GitHub releases-pagina
- Plaats het JAR-bestand in de plugins-map van je server
- Herstart je server
Geen extra configuratie nodig! De plugin werkt direct met de poort van je gameserver (5520).
Stap 2: Query-poort Toevoegen in Hylist
Configureer je query-poort in het Hylist-dashboard:
- Ga naar de bewerkingspagina van je server in het Hylist-dashboard
- Scroll naar de sectie "Query-poorten"
- Klik op "Query-poort Toevoegen"
- Voer poort 5520 in (of de poort van je gameserver als deze anders is)
- Selecteer optioneel een tag om deze poort te koppelen aan een spelmodus
- Sla je wijzigingen op
Meerdere Spelmodi (Proxy-netwerken)
Als je meerdere backend-servers draait, kun je meerdere query-poorten toevoegen - één voor elke spelmodus:
Port 5520 -> No tag (Lobby) Port 5521 -> PvP Port 5522 -> Survival Elke backend-server heeft zijn eigen One Query plugin-instantie nodig. De tag helpt bezoekers te begrijpen bij welke spelmodus elke spelerslijst hoort.
Je Installatie Verifiëren
Na het configureren, verifieer je installatie:
- Zorg ervoor dat je server online is met de One Query plugin actief
- Wacht een paar minuten tot Hylist je server heeft opgevraagd
- Bezoek de pagina van je server op Hylist
- Je zou spelersaantallen, online spelers, versie en plugin-informatie moeten zien
Als alles werkt, zie je een groene "Online" badge en realtime spelersinformatie op je serverpagina!
Probleemoplossing
Geen gegevens zichtbaar op Hylist?
- Controleer of het One Query plugin JAR-bestand in je plugins-map staat
- Controleer je serverlogs op pluginfouten
- Zorg ervoor dat het poortnummer in Hylist overeenkomt met je serverpoort (standaard: 5520)
- Wacht 5-10 minuten tot Hylist de servergegevens ververst
Onjuist spelersaantal of informatie?
- Zorg ervoor dat de query-poort naar de juiste server wijst
- Als je meerdere servers gebruikt, controleer dan of elke server een eigen poort heeft geconfigureerd
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.