Illustration pour Résoudre l'authentification et le port UDP/QUIC d'un serveur Hytale

Résoudre l'authentification et le port UDP/QUIC d'un serveur Hytale

Authentifie le serveur Hytale, ouvre le port 5520 en UDP et diagnostique QUIC, NAT, pare-feu et incompatibilité de version.

Hytale utilise QUIC sur UDP, pas TCP, et écoute par défaut sur 0.0.0.0:5520. Le serveur doit aussi s'authentifier auprès des services Hytale avant d'accepter les joueurs. Traite ces deux couches séparément : une authentification réussie ne prouve pas que le port est accessible.

Authentifier le serveur

Au premier lancement, exécute dans la console serveur :

/auth login device

Ouvre l'adresse https://accounts.hytale.com/device, saisis le code affiché et termine l'autorisation avant son expiration (le manuel montre 900 secondes). Après succès, le serveur stocke ses informations dans auth.enc et auth.key.

Traite ces deux fichiers comme des secrets : ne les publie pas, ne les place pas dans un dépôt et limite leurs permissions au compte du service. Pour une migration, déplace-les par un canal sécurisé et vérifie la procédure de ton hébergeur. Un fournisseur qui authentifie beaucoup d'instances doit suivre le guide dédié aux providers plutôt que réutiliser manuellement un compte.

Configurer le bind et le pare-feu QUIC

Le port par défaut est 5520. Pour en choisir un autre :

java -jar HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:3500

Autorise le même port UDP dans le pare-feu du système et, si le serveur est derrière un routeur, redirige-le vers l'adresse LAN stable de la machine. Aucune règle TCP n'est nécessaire pour le trafic joueur Hytale.

ContrôleValeur attendueErreur fréquente
Bind0.0.0.0:5520 ou port choisiÉcoute seulement sur 127.0.0.1
Pare-feu OSEntrée UDP autoriséeRègle créée en TCP
RouteurUDP externe vers même port LANCible DHCP ayant changé
ClientAdresse publique et port réelTest de l'IP privée depuis Internet
VersionHash protocole identiqueClient mis à jour, serveur ancien

Diagnostic dans le bon ordre

1

Lire la console d'authentification

Confirme Authentication successful et l'absence d'erreur de renouvellement. Si le code expire, relance la commande plutôt que de réutiliser l'ancien.
2

Confirmer l'écoute locale

Vérifie la ligne de bind et le processus. Teste d'abord depuis le LAN avec l'adresse privée pour séparer application et routeur.
3

Tester depuis l'extérieur

Utilise un client Hytale sur un autre réseau. Les testeurs de ports TCP classiques ne savent pas valider QUIC/UDP et peuvent signaler à tort un port fermé.
4

Vérifier NAT et fournisseur

Le NAT symétrique peut poser problème ; derrière CGNAT, un particulier ne dispose souvent pas de redirection entrante. Demande une IPv4 publique ou utilise un VPS/hébergeur.
5

Aligner client et serveur

Le protocole utilise un hash et exige actuellement une correspondance exacte. Mets le serveur à jour dès que les clients changent de version.

Valider la correction

Teste une connexion externe, un déplacement dans le monde, une reconnexion et un redémarrage du serveur. Vérifie que les credentials survivent, que le port reste identique et que le pare-feu n'a pas été remplacé par une règle temporaire. Conserve une sauvegarde de universe/, mais protège séparément les secrets d'authentification.

Le guide de mise à jour Hytale résout les incompatibilités de protocole ; le guide de sauvegarde protège le monde avant modification.

Éviter les problèmes QUIC et NAT

Compare les serveurs Hytale avec port UDP prêt, IPv4 publique et mises à jour gérées.

Questions fréquentes

Quel port utilise un serveur Hytale ?
Le port par défaut est 5520 et le protocole est UDP/QUIC. Si tu changes --bind, ouvre et redirige exactement le nouveau port en UDP.
Pourquoi un test de port dit fermé alors que le pare-feu est correct ?
Beaucoup de sites testent seulement TCP. Hytale utilise QUIC sur UDP ; valide avec les journaux et un vrai client Hytale depuis un réseau extérieur.
Pourquoi l'authentification réussit-elle mais les joueurs sont rejetés ?
Contrôle ensuite UDP, NAT et la version. Le client et le serveur doivent actuellement partager exactement le même hash de protocole.

Source principale : manuel officiel du serveur Hytale.

Notre recommandation

Prêt à lancer ton serveur Hytale ?

Voici les meilleures offres d'hébergement Hytale du moment, codes promo inclus. Tu hésites encore ? Notre quiz te trouve l'hébergeur idéal en moins de 2 minutes.

My box 8

Minestrator

11.99€/mois
-10% avec le code HOSTMYGAME
Max joueurs:Inconnu
Mods:
Oui

Spécifications

RAM:8GB(DDR4)

Jeux compatibles

Hytale

Fonctionnalités

  • ✓Mods en 1 click
  • ✓DDoS Protection
  • ✓Backups

Copper

Shockbyte

10.75€/mois
-25% avec le code LAUNCH
Max joueurs:4
Mods:
Non

Spécifications

RAM:5GB(DDR4)

Jeux compatibles

Hytale

Fonctionnalités

  • ✓DDoS Protection
  • ✓Backups
  • ✓Support 24/7

Hytale — 6 Go

WinterNode

10.67€/mois
-20% avec le code HOSTMYGAME
Max joueurs:Illimité
Mods:
Oui

Spécifications

RAM:6 Go

Jeux compatibles

Hytale

Fonctionnalités

  • ✓6 Go de RAM au minimum
  • ✓CPU sans limite fixe, sous politique d'usage raisonnable
  • ✓Stockage NVMe sans limite fixe, extension sur demande
  • ✓Sauvegardes automatiques toutes les 12 heures
  • +2 autres fonctionnalités
Hytale : authentification et port UDP QUIC | HostMyGame