Comment afficher le nombre de joueurs en ligne sur la liste des serveurs Hytale

Lorsqu’un joueur parcourt la liste des serveurs Hytale, un chiffre décide s’il clique sur « Rejoindre » ou continue de défiler : le nombre de joueurs. Un serveur affichant 47/100 joueurs semble vivant. Un serveur n’affichant rien — ou juste « Hors ligne » — ressemble à une ville fantôme même s’il fonctionne parfaitement. HytaleCharts propose trois méthodes pour afficher le nombre de joueurs en temps réel et le statut en ligne de votre serveur Hytale. Chaque méthode présente des compromis différents en termes de précision, d’effort de configuration et de fonctionnalités. Ce guide les explique toutes pour que vous puissiez choisir celle qui convient à votre configuration. Les trois méthodes en un coup d’œil MéthodeNombre de joueursVitesse de mise à jourEffort de configurationIdéal pour Plugin HeartbeatNombre exact + liste de joueursToutes les 60 secondesInstaller le pluginServeurs auto-hébergés Requête externeNombre exactToutes les 5 minutesDéfinir une URLNitrado / hébergeurs gérés Ping UDPEn ligne/Hors ligne uniquementPériodiqueAucun (automatique)Statut de base par défaut Méthode 1 : Plugin Heartbeat HytaleCharts (Recommandé) Le plugin heartbeat est la meilleure façon d’afficher votre nombre de joueurs sur la liste des serveurs Hytale. Il s’exécute sur votre serveur Hytale et envoie un signal heartbeat à HytaleCharts toutes les 60 secondes, incluant le nombre exact de joueurs en ligne et leurs noms d’utilisateur. Ce qu’il rapporte Nombre de joueurs — le nombre actuel de joueurs connectés Joueurs maximum — la limite de joueurs de votre serveur Liste des joueurs — noms d’utilisateur individuels et UUIDs des joueurs connectés Version du plugin — pour que HytaleCharts puisse vous avertir des mises à jour Fonctionnement interne Le plugin envoie une requête POST à /api/heartbeat toutes les 60 secondes La requête inclut la clé secrète de votre serveur (une chaîne hexadécimale de 64 caractères) HytaleCharts valide le secret, met à jour le nombre de joueurs et le statut de votre serveur Si aucun heartbeat n’est reçu pendant 5 minutes, le serveur est marqué hors ligne Les données historiques sont stockées pour les analyses et les graphiques de nombre de joueurs Étapes de configuration Générez un secret heartbeat — sur HytaleCharts, allez dans Modifier le serveur et cliquez sur « Générer le secret Heartbeat » dans la section Plugin Heartbeat Copiez le secret — vous ne le verrez qu’une fois (vous pouvez le regénérer en cas de perte) Installez le plugin HytaleCharts sur votre serveur Hytale en le plaçant dans le répertoire mods/ de votre serveur Configurez le plugin — créez ou modifiez config.json dans le répertoire de données du plugin : { "secret": "YOUR_64_CHARACTER_SECRET_HERE", "debug": false } Redémarrez votre serveur — le plugin commencera à envoyer des heartbeats immédiatement Vérifiez sur HytaleCharts — votre serveur devrait apparaître en ligne avec un nombre de joueurs dans les 60 secondes Support multi-instances Si vous exécutez plusieurs instances de serveur (par ex., un serveur lobby et un serveur survie), le système heartbeat agrège automatiquement les nombres de joueurs. Toutes les instances partageant la même clé secrète verront leurs joueurs uniques fusionnés et les totaux additionnés. Cela signifie que votre entrée dans la liste des serveurs Hytale affiche le total correct sur l’ensemble de votre réseau. Le système identifie les instances uniques par adresse IP et nom du monde, prend le dernier heartbeat de chaque source et fusionne les joueurs par UUID pour éviter de compter deux fois les joueurs connectés à plusieurs instances. Mises à jour du plugin HytaleCharts suit la version de votre plugin. Si une version plus récente est disponible, votre page Modifier le serveur affichera un avertissement « Mise à jour disponible ». Garder le plugin à jour assure la compatibilité avec les modifications de l’API et vous donne les derniers correctifs. Méthode 2 : Point de terminaison de requête externe (Nitrado et hébergeurs gérés) Tous les opérateurs de serveurs Hytale n’ont pas accès à l’installation de plugins personnalisés. Si vous utilisez Nitrado, un hébergeur basé sur des conteneurs ou tout fournisseur exposant un point de terminaison de requête, le système de requête externe est votre solution. Fonctionnement Vous fournissez à HytaleCharts une URL qui retourne le nombre de joueurs de votre serveur en JSON HytaleCharts interroge cette URL toutes les 5 minutes La réponse est analysée et votre nombre de joueurs est mis à jour sur la liste des serveurs Si le point de terminaison devient inaccessible, le statut de votre serveur reflète le changement dans les 10 minutes Formats de réponse supportés HytaleCharts détecte automatiquement plusieurs formats JSON, il fonctionne donc avec la plupart des points de terminaison sans configuration supplémentaire : Format Nitrado { "Universe": { "CurrentPlayers": 15 }, "Server": { "MaxPlayers": 100 } } Format standard { "player_count": 15, "max_players": 100 } Supporte également les variantes camelCase (playerCount, maxPlayers) et abrégées (online, max). Étapes de configuration Trouvez ou configurez un point de terminaison de requête chez votre hébergeur (Nitrado en fournit un par défaut) Sur HytaleCharts, allez dans Modifier le serveur → Requête externe Entrez l’URL complète de votre point de terminaison de requête Cliquez sur « Tester le point de terminaison » pour vérifier que la réponse est analysable Enregistrez — HytaleCharts commence à interroger immédiatement La méthode de requête externe se met à jour moins fréquemment que le plugin heartbeat (toutes les 5 minutes contre toutes les 60 secondes), mais ne nécessite aucune modification côté serveur. Méthode 3 : Ping UDP (Repli automatique) Si vous n’avez configuré ni le plugin heartbeat ni un point de terminaison de requête externe, HytaleCharts tentera de vérifier le statut de votre serveur via ping UDP. C’est un système passif qui ne nécessite aucune configuration de votre part. Fonctionnement HytaleCharts envoie une sonde minimale du protocole QUIC au port public de votre serveur (par défaut : 5520) Si une réponse est reçue, le serveur est marqué en ligne Si aucune réponse après plusieurs tentatives, le serveur est marqué hors ligne Limitations Pas de nombre de joueurs — le ping UDP peut uniquement déterminer en ligne vs. hors ligne, pas combien de joueurs sont connectés Pas de liste de joueurs — aucune donnée individuelle de joueur n’est disponible Timing moins précis — les mises à jour de statut dépendent du calendrier d’interrogation plutôt que des heartbeats en temps réel Le ping UDP est utile comme base, mais les serveurs qui veulent monter dans le classement de la liste des serveurs Hytale devraient installer le plugin heartbeat ou configurer une requête externe pour des nombres de joueurs précis. Comment HytaleCharts détermine le statut de votre serveur Lorsque plusieurs méthodes sont disponibles, HytaleCharts utilise un système de priorité pour décider à quelle source de données faire confiance : Requête externe (priorité la plus élevée, si activée) — en ligne si le dernier sondage réussi date de moins de 10 minutes Plugin Heartbeat (si configuré) — en ligne si le dernier heartbeat date de moins de 5 minutes Ping UDP (repli) — utilise le résultat en ligne/hors ligne stocké du dernier contrôle Cela signifie que si vous avez à la fois le plugin heartbeat et une requête externe configurés, la requête externe a la priorité. La plupart des opérateurs utiliseront l’un ou l’autre, pas les deux. Ce que voient les joueurs Sur la liste des serveurs Hytale, le statut de votre serveur apparaît sous forme de badge coloré : Badge vert avec nombre de joueurs (par ex., « En ligne — 47 joueurs ») — quand en ligne et des joueurs sont détectés Badge vert (« En ligne ») — quand en ligne mais pas de joueurs ou nombre indisponible Badge rouge (« Hors ligne ») — quand pas de heartbeat, requête ou réponse ping récente Les serveurs avec des nombres de joueurs visibles attirent systématiquement plus de clics. Un serveur affichant « En ligne — 23 joueurs » est bien plus attractif qu’un qui dit simplement « En ligne » sans nombre. C’est pourquoi le plugin heartbeat ou la requête externe est important pour les meilleurs serveurs Hytale. Dépannage ProblèmeCause probableSolution Le serveur affiche « Hors ligne » malgré son fonctionnementPare-feu bloquant le heartbeat ou le pingAssurez-vous que votre serveur peut faire des requêtes HTTPS sortantes vers hytalecharts.com Nombre de joueurs bloqué à 0Le plugin ne suit pas les événements des joueursVérifiez que le plugin est chargé (consultez les logs du serveur) et redémarrez Le heartbeat s’arrête après un certain tempsLe plugin a planté ou a été déchargéVérifiez les logs du serveur pour les erreurs, réinstallez le plugin si nécessaire La requête externe affiche un mauvais nombreLe point de terminaison retourne des données obsolètesVérifiez la réponse JSON directement dans un navigateur Le nombre multi-instances est trop basLes instances utilisent des secrets différentsToutes les instances doivent partager le même secret heartbeat Avertissement « Mise à jour disponible »Le plugin est obsolèteTéléchargez la dernière version du plugin depuis HytaleCharts Meilleures pratiques Les opérateurs gérant les meilleurs serveurs Hytale suivent ces pratiques : Utilisez le plugin heartbeat dès que possible — c’est l’option la plus précise et réactive Définissez un nombre maximum de joueurs réaliste — des limites gonflées (par ex., 999) semblent malhonnêtes et réduisent la confiance Surveillez votre statut heartbeat — vérifiez périodiquement la page Modifier le serveur pour les erreurs Gardez le plugin à jour — les plugins obsolètes peuvent cesser de fonctionner après des modifications de l’API Utilisez la requête externe comme sauvegarde — si votre plugin tombe en panne, un point de terminaison externe fonctionnel maintient votre statut précis Assurez-vous que votre domaine est correct — le repli par ping UDP utilise votre domaine configuré, gardez-le donc précis même si vous utilisez principalement le heartbeat Pour commencer Afficher votre nombre de joueurs prend moins de cinq minutes avec le plugin heartbeat. Générez un secret, installez le plugin, ajoutez votre secret à la configuration et redémarrez. Votre serveur Hytale apparaîtra sur la liste des serveurs Hytale avec un nombre de joueurs en direct en moins d’une minute. Pour les hébergeurs gérés comme Nitrado, la requête externe est encore plus simple — collez simplement une URL et HytaleCharts s’occupe du reste. Dans tous les cas, afficher un vrai nombre de joueurs est l’une des choses les plus simples que vous pouvez faire pour augmenter la visibilité de votre serveur et attirer de nouveaux joueurs. Les serveurs qui affichent des nombres actifs de joueurs sur la liste des serveurs Hytale surpassent systématiquement ceux qui ne le font pas.