Créer une architecture multiserveur Hytale avec Player Referral

Choisir l'architecture

Une architecture simple comprend :

1. un lobby public qui authentifie et présente les destinations ;
2. plusieurs serveurs de jeu Hytale authentifiés séparément ;
3. un service de matchmaking ou une base côté serveur pour l'autorité ;
4. un DNS stable et un port UDP/QUIC unique par processus ;
5. des sauvegardes et mises à jour indépendantes par monde.

Le lobby ne doit pas être l'unique source de vérité pour les droits, inventaires ou monnaie. Le serveur cible doit revalider toute information sensible auprès d'un service de confiance.

Utiliser Player Referral en sécurité

L'API documentée est :

PlayerRef.referToServer(host, port, data)

data est facultatif et limité à 4 Ko. Le client le présente au serveur cible pendant la poignée de main. Le manuel avertit qu'il peut être altéré : signe le contenu avec HMAC et un secret partagé uniquement entre serveurs. Inclus un identifiant de session aléatoire, la destination, une expiration courte et un nonce anti-rejeu ; ne place jamais le secret ni une permission permanente dans le payload.

Le serveur cible doit : vérifier la signature, l'expiration, la destination et l'usage unique, puis récupérer les données de session faisant autorité côté backend. Rejette proprement une référence invalide et journalise un identifiant, sans écrire le secret.

Redirection, fallback et proxy

Le manuel du 12 octobre 2026 marque encore l'implémentation du paquet de fallback comme « Coming Soon ». Ne construis donc pas une garantie de reprise dessus sans vérifier la release réellement déployée. Prévois côté client un retour au menu et un moyen clair de rejoindre le lobby.

Un proxy personnalisé reste possible avec Netty QUIC et les paquets présents dans HytaleServer.jar, mais il augmente fortement la surface de sécurité et la maintenance de protocole. Utilise d'abord Referral et Redirect natifs.

Déployer et valider le réseau

Checklist avant production

Pour le réseau de base, consulte le guide UDP/QUIC. Pour chaque instance, applique la procédure de sauvegarde Hytale.

Questions fréquentes