Guide de configuration du plugin One Query

Apprenez à configurer le plugin One Query pour afficher le nombre de joueurs en temps réel, les joueurs en ligne et les informations du serveur sur votre fiche Hylist.

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.

CurseForge GitHub

Hyvote

Alternative plugin with configurable exports. Lets you toggle exactly what data to expose.

CurseForge GitHub

Important: These plugins are mutually exclusive. Only install one of them - do not install both on the same server.

Qu'est-ce que 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:

  • Nombre actuel de joueurs et maximum de joueurs
  • Liste des joueurs en ligne avec leurs noms et UUIDs
  • Version du serveur et MOTD
  • Liste des plugins installés

Étape 1 : Installer le plugin

Download and install either One Query or Hyvote on your Hytale server:

  1. Téléchargez le dernier JAR depuis la page des releases GitHub
  2. Placez le fichier JAR dans le répertoire plugins de votre serveur
  3. Redémarrez votre serveur

Aucune configuration supplémentaire requise ! Le plugin fonctionne directement avec le port de votre serveur de jeu (5520).

Étape 2 : Ajouter le port de requête dans Hylist

Configurez votre port de requête dans le tableau de bord Hylist :

  1. Allez sur la page d'édition de votre serveur dans le tableau de bord Hylist
  2. Faites défiler jusqu'à la section "Ports de requête"
  3. Cliquez sur "Ajouter un port de requête"
  4. Entrez le port 5520 (ou le port de votre serveur de jeu si différent)
  5. Sélectionnez éventuellement un tag pour associer ce port à un mode de jeu
  6. Enregistrez vos modifications

Plusieurs modes de jeu (réseaux proxy)

Si vous gérez plusieurs serveurs backend, vous pouvez ajouter plusieurs ports de requête - un pour chaque mode de jeu :

Port 5520 -> No tag (Lobby)
Port 5521 -> PvP
Port 5522 -> Survival

Chaque serveur backend a besoin de sa propre instance du plugin One Query. Le tag aide les visiteurs à comprendre à quel mode de jeu appartient chaque liste de joueurs.

Vérification de votre configuration

Après avoir tout configuré, vérifiez votre installation :

  1. Assurez-vous que votre serveur est en ligne avec le plugin One Query en cours d'exécution
  2. Attendez quelques minutes que Hylist interroge votre serveur
  3. Visitez la page de votre serveur sur Hylist
  4. Vous devriez voir le nombre de joueurs, les joueurs en ligne, la version et les informations sur les plugins

Si tout fonctionne, vous verrez un badge vert "En ligne" et des informations en temps réel sur les joueurs sur la page de votre serveur !

Dépannage

Pas de données sur Hylist ?

  • Vérifiez que le JAR du plugin One Query est dans votre dossier plugins
  • Vérifiez les logs de votre serveur pour des erreurs de plugin
  • Assurez-vous que le numéro de port dans Hylist correspond au port de votre serveur (par défaut : 5520)
  • Attendez 5-10 minutes pour que Hylist rafraîchisse les données du serveur

Nombre de joueurs ou informations incorrectes ?

  • Assurez-vous que le port de requête pointe vers le bon serveur
  • Si vous utilisez plusieurs serveurs, assurez-vous que chacun a son propre port configuré

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.

Frequently Asked Questions

How often does Hylist query my server?
Hylist queries your server approximately every 60 seconds. This provides near real-time data while keeping the network overhead minimal. The query is lightweight and should have no noticeable impact on your server's performance.
Does the query plugin affect server performance?
The query plugins (One Query and Hyvote) are extremely lightweight. They respond to incoming query requests with basic server information (player count, version, MOTD). The CPU and memory overhead is negligible. The plugin simply listens on a port and responds to UDP/TCP queries when asked.
Can I use One Query and Hyvote at the same time?
No, these plugins are mutually exclusive. You should only install one of them. Both provide the same query functionality. Hyvote includes additional features (like Votifier2 integration), while One Query is a standalone query-only plugin. Choose the one that best fits your setup.
Retour à Mes Serveurs