Bac à sable et RPG

Héberger un serveur Hytale

Q: Que choisir comme mode d'authentification ?

Conservez authenticated . Les modes offline et insecure désactivent la vérification des comptes : n'importe qui peut alors se connecter sous n'importe quel pseudonyme, y compris le vôtre. Ils ne se justifient qu'en développement, sur un serveur fermé.

Hytale mêle la liberté d'un bac à sable au rythme d'un RPG : un monde généré, des donjons, des créatures, et tout se reconstruit bloc à bloc. Son serveur tourne en Java et s'accompagne d'un cache de démarrage fourni par l'éditeur, qui raccourcit sensiblement les relances.

rocket_launchChoisir un VPSchevron_forward

Installation pas à pas

Comptez un quart d'heure 1

Commander le VPS avec la bonne image

Tout part de la commande : c'est là que vous choisissez le système, et c'est le seul moment où ce choix est simple à faire. Prenez une offre qui couvre au minimum ce que réclame Hytale, puis sélectionnez l'image « Debian 13 - Pterodactyl » dans la liste des systèmes.

Configuration minimale pour ce jeu : 2 vCPU, 4 Go de mémoire, 15 Go de disque. Ce sont des minimums éditeur, pas des valeurs confortables.
Si vous comptez héberger plusieurs jeux sur la même machine, additionnez leurs besoins avant de choisir l'offre.
Le panel est déjà installé dans l'image : à la livraison il est fonctionnel, vous n'avez aucune commande à taper.
Une erreur d'image se rattrape en réinstallant le VPS, mais vous perdez tout ce qui s'y trouve. Vérifiez avant de valider.

Se connecter au panel

Dès la mise en service, vous recevez par email l'adresse de votre panel et la marche à suivre pour ouvrir votre accès. Faites-le sans attendre : c'est l'unique interface dont vous aurez besoin ensuite.

Suivez à la lettre les instructions reçues à la livraison : elles sont propres à votre machine.
Le compte principal voit tout et peut tout. Pour un ami qui gère un serveur avec vous, créez-lui plutôt un sous-utilisateur aux droits limités, depuis l'onglet Utilisateurs du serveur concerné.
Si la page ne répond pas immédiatement, laissez quelques minutes : la mise en service se termine parfois après l'envoi de l'email.
En cas de difficulté d'accès, écrivez-nous sur Discord plutôt que de tâtonner.

Créer le serveur Hytale

Dans le menu d'administration, ouvrez Servers puis Create New. C'est le formulaire qui définit tout : nom, propriétaire, ressources et jeu. Prenez le temps de le remplir, un serveur mal dimensionné se corrige ensuite mais un egg mal choisi impose de recommencer.

Nom : le nom affiché dans votre panel. Il n'a rien à voir avec celui que verront vos joueurs, qui se règle plus tard dans le jeu.
Mémoire : la valeur se saisit directement en gigaoctets. Pour ce jeu, mettez 4. La valeur 0 signifie illimité, à éviter dès que plusieurs serveurs partagent la machine.
Espace disque : également en gigaoctets. Mettez 15. Là encore, 0 signifie illimité.
Limite CPU : en pourcentage, où 100 équivaut à un thread. Pour 2 vCPU, mettez 200. La valeur 0 laisse le serveur consommer tout ce qu'il veut, ce qui pénalise les autres en cas de pic.
Swap : laissez 0. Un serveur de jeu qui bascule en swap devient injouable bien avant d'être sauvé par lui.
Poids IO bloc : laissez 500, la valeur par défaut. Ce réglage ne sert qu'à arbitrer entre plusieurs serveurs qui saturent le disque en même temps.
Épinglage CPU : laissez vide. Réserver des threads précis n'a d'intérêt que sur une machine très chargée, et se règle après observation, pas à la création.
Nest puis Egg : choisissez « Hytale », puis l'egg « Hytale ». Le nest est la famille de jeu, l'egg la variante précise.

Déclarer vos ports

Les ports ne se saisissent pas à la main : votre machine dispose déjà d'une réserve d'allocations créées à l'avance, et vous en choisissez une dans la liste. Elle ne portera pas le numéro habituel de Hytale, qui est le 5520, et ce n'est pas gênant : vos joueurs le préciseront simplement dans l'adresse de connexion. Ce jeu réclame en revanche 1 allocation supplémentaire, à prendre dans la même liste, pour découverte du serveur (Source Query).

La liste des allocations disponibles s'affiche dans le formulaire de création, puis dans l'onglet Réseau du serveur. Vous y choisissez, vous n'y saisissez rien.
Les numéros proposés sont générés à l'avance et espacés : attendez-vous à quelque chose comme 25634 ou 27108, pas au port emblématique du jeu.
Notez celui que vous retenez : c'est la seconde moitié de l'adresse que vous communiquerez à vos joueurs.
Pour une adresse sans numéro de port, faites pointer un enregistrement DNS SRV de votre domaine vers l'IP et le port retenus. Vos joueurs saisissent alors simplement le nom de domaine.
Si aucune allocation libre n'apparaît, écrivez-nous : la réserve se complète à la demande.

Régler les variables du jeu

L'onglet Startup rassemble les réglages propres à Hytale : mode d'authentification, patchline, cache de démarrage AOT, plugins et opérateurs. Ils sont lus au démarrage, une modification n'a donc d'effet qu'après un redémarrage complet.

Chaque variable porte une description sous son champ : lisez-la avant de modifier une valeur dont vous n'êtes pas sûr.
Certaines variables ne sont modifiables qu'avant la première installation. Si un champ est grisé, c'est normal.
Un rechargement ne suffit pas à appliquer un changement de variable : il faut arrêter puis redémarrer.
En cas de doute, laissez les valeurs par défaut. Elles fonctionnent, et vous ajusterez une fois le serveur en ligne.

Lancer l'installation

Cliquez sur Start et laissez faire. Le serveur passe par trois états visibles en haut de la console : Installing pendant le téléchargement des fichiers du jeu, Starting pendant le chargement, puis Running lorsqu'il accepte les connexions.

La première installation télécharge les fichiers du jeu : de deux minutes pour les titres légers à une demi-heure pour les plus lourds.
Une console silencieuse pendant plusieurs minutes est normale au premier lancement. Ne redémarrez pas, vous ne feriez que tout reprendre du début.
Un serveur qui repasse en Offline juste après Starting a presque toujours manqué de mémoire : remontez dans la console, la cause y est écrite.
Le graphique de consommation en bas de page vous dit en quelques minutes si votre dimensionnement tient.

Se connecter et inviter vos joueurs

Votre serveur est joignable à l'adresse IP de votre VPS, suivie de deux-points et du port que vous avez choisi. Testez la connexion vous-même avant de communiquer l'adresse : il est plus confortable de découvrir un problème seul.

L'adresse prend la forme 203.0.113.10:5520, en remplaçant par l'IP réelle de votre VPS.
Pour une adresse plus lisible, faites pointer un sous-domaine vers l'IP de votre VPS et communiquez-le à la place.
Si vous n'arrivez pas à vous connecter alors que le serveur est en Running, le port déclaré dans le panel et celui configuré dans le jeu ne correspondent probablement pas.
Programmez une sauvegarde automatique dans l'onglet Backups avant d'ouvrir aux joueurs, pas après le premier incident.

Bon à savoir

Quatre gigaoctets conviennent à un groupe d'amis ; comptez 8 Go dès qu'un monde est longuement exploré, la génération procédurale occupant la mémoire.
Le mode d'authentification par défaut vérifie l'identité de chaque joueur. Ne le désactivez pas sur un serveur ouvert au public.
Le port de découverte doit être différent du port de jeu : par défaut, l'egg prend celui juste au-dessus.

tuneConfiguration minimale

Processeur2 vCPU

Mémoire4 Go

Disque15 Go

Nest PterodactylHytale · Hytale

Minimum recommandé par l'éditeur. Une communauté active, une grande carte ou un modpack demandent davantage : voyez les remarques en bas de page. lanPorts à déclarer 5520UDPport principal, que vous définissez5521UDPdécouverte du serveur (Source Query) Les ports ne sont pas attribués automatiquement : vous les choisissez et les créez vous-même dans l'onglet Réseau du panel. Au-delà du premier, utilisez les ports additionnels. rocket_launchPrêt à lancer ? Nos VPS Xeon sont livrés avec le panel préinstallé et l'anti-DDoS actif. rocket_launchVoir les offreschevron_forward

Guides complémentaires

1 guide menu_book

Régler les variables de l'egg Hytale

Authentification, cache de démarrage, plugins : ce que chaque option change vraiment.

chevron_forward

Problèmes courants sur un serveur Hytale

Mes joueurs ne parviennent pas à se connecter alors que le serveur tournechevron_forward

Vérifiez d'abord que le serveur et vos joueurs sont sur la même patchline : une instance en pre-release refuse les clients en release, et inversement. Contrôlez ensuite que l'adresse communiquée reprend bien le port de votre allocation.

Mon serveur n'apparaît pas dans les listeschevron_forward

La découverte passe par un plugin Source Query, activé par défaut dans l'egg, qui utilise un second port. Si vous ne l'avez pas déclaré en allocation supplémentaire, le serveur fonctionne mais reste invisible.

Que choisir comme mode d'authentification ?chevron_forward

Conservez authenticated. Les modes offline et insecure désactivent la vérification des comptes : n'importe qui peut alors se connecter sous n'importe quel pseudonyme, y compris le vôtre. Ils ne se justifient qu'en développement, sur un serveur fermé.

Le démarrage est longchevron_forward

Laissez le cache AOT activé : c'est un cache Java pré-entraîné, fourni par l'éditeur, qui réduit sensiblement le temps de démarrage. Le désactiver n'a d'intérêt que pour diagnostiquer un problème de chargement.

Mes joueurs n'arrivent pas à se connecterchevron_forward

Vérifiez d'abord que le port déclaré dans l'onglet Réseau du panel est bien celui configuré dans le jeu : ce sont deux réglages distincts et rien ne les synchronise. Vos joueurs doivent ensuite saisir l'adresse IP de votre VPS, deux-points, puis le port, par exemple 203.0.113.10:5520. Ce jeu réclame également 1 port supplémentaire : s'ils manquent, la connexion échoue ou le serveur n'apparaît pas dans la liste publique.

Le serveur consomme toute la mémoire que je lui ai allouéechevron_forward

C'est le comportement normal de la plupart des moteurs de jeu, qui réservent la mémoire disponible au lieu de la rendre. Ce qui doit vous alerter, c'est un serveur qui redémarre en boucle : là, il dépasse réellement son allocation. Le graphique de consommation du panel tranche en quelques minutes d'observation.

Comment sauvegarder mon serveur ?chevron_forward

L'onglet Backups du panel crée des sauvegardes à la demande ou selon un calendrier. Prenez le réflexe d'en déclencher une avant chaque mise à jour du jeu et avant chaque installation de mod : ce sont les deux moments où l'on casse un serveur.

Mon serveur s'est arrêté et n'est pas repartichevron_forward

Un serveur qui s'arrête reste arrêté : relancez-le depuis le panel. La console conserve les lignes qui précèdent l'arrêt, et la cause y est presque toujours écrite. Un arrêt qui revient à heure fixe vient souvent d'une tâche planifiée ou d'une sauvegarde qui remplit le disque.

Puis-je changer d'offre sans tout réinstaller ?chevron_forward

Oui. Le changement se fait au prorata et votre serveur reste en place : seules les ressources allouées augmentent. C'est la façon normale de procéder quand une communauté grandit, plutôt que de surdimensionner dès le départ.