Comment créer un serveur Hytale : le guide complet (Chapter I)

Créer un serveur Hytale ne prend que quelques minutes, à condition de connaître les quelques pièges qui bloquent la plupart des débutants : la bonne version de Java, l'authentification du serveur et un port qui s'ouvre en UDP, pas en TCP. Ce guide reprend toutes les étapes, de l'installation au premier joueur connecté, et il est à jour avec la version Chapter I (Update 7) sortie en octobre 2026, qui a changé plusieurs règles côté serveur.

Ce qu'il faut savoir avant de commencer

Hytale est en accès anticipé depuis le 13 janvier 2026. Hypixel Studios fournit gratuitement le serveur officiel, un programme Java nommé HytaleServer.jar, accompagné d'une archive Assets.zip qui contient les ressources du jeu. La dernière version est Chapter I « Out of the Breach », sortie le 12 octobre 2026, suivie des correctifs 0.7.1 et 0.7.2 les 13 et 14 octobre.

Trois points distinguent Hytale des autres jeux que vous avez peut-être déjà hébergés :

• Java 25 est obligatoire : les versions plus anciennes ne lancent pas le serveur.
• Le réseau passe par QUIC sur UDP, sur le port 5520 par défaut. Une redirection en TCP seul ne fonctionnera jamais.
• Le serveur doit être authentifié avec un compte Hytale avant d'accepter des joueurs.

Le client et le serveur doivent aussi utiliser exactement la même version du protocole. Après chaque mise à jour du jeu, votre serveur doit donc être mis à jour lui aussi, sinon plus personne ne peut se connecter.

Configuration requise

Le serveur tourne sous Windows, Linux et macOS, sur processeur x64 ou arm64. La mémoire vive est la ressource la plus sollicitée, surtout à cause de la distance de vue. Voici les recommandations courantes, à ajuster selon votre usage :

Joueurs	RAM allouée (-Xmx)	Processeur	Stockage
1 à 5	4 Go	2 cœurs à 2,5 GHz	10 Go
5 à 10	6 Go	4 cœurs	20 Go SSD
10 à 20	8 Go	4 cœurs à 3 GHz et plus	20 Go SSD ou NVMe
20 et plus	12 Go ou plus	6 cœurs et plus	NVMe conseillé

Comptez aussi une bonne bande passante montante : environ 10 Mbit/s pour un petit groupe d'amis, bien davantage pour un serveur public.

Choisir où héberger votre serveur

Option	Avantages	Limites
Votre PC	Gratuit, idéal pour tester	Le serveur s'arrête quand le PC s'éteint, redirection de port nécessaire, impossible derrière un CGNAT
VPS ou serveur dédié	Disponible 24 h/24, IP fixe, contrôle total	Installation et maintenance sous Linux à votre charge
Hébergeur spécialisé	Prêt en quelques minutes, panel, sauvegardes, protection anti-DDoS	Abonnement mensuel

Les étapes ci-dessous valent pour un PC ou un VPS. Si vous passez par un hébergeur, les étapes 1, 2 et 5 sont déjà faites pour vous.

Étape 1 : installer Java 25

La distribution la plus utilisée est Eclipse Temurin 25, publiée gratuitement par Adoptium. Sous Windows et macOS, installez-la avec l'installateur officiel. Sous Ubuntu ou Debian, une fois le dépôt Adoptium ajouté, une seule commande suffit :

sudo apt update
sudo apt install temurin-25-jdk
java --version

La dernière commande doit afficher une version commençant par 25. Si une autre version de Java apparaît, c'est elle qui sera utilisée : changez la version par défaut ou appelez Java 25 avec son chemin complet dans votre script de lancement.

Étape 2 : récupérer les fichiers du serveur

Méthode rapide : copier depuis le launcher

Si le jeu est installé sur la machine, les fichiers se trouvent dans le dossier du launcher :

• Windows : %appdata%\Hytale\install\release\package\game\latest
• Linux : $XDG_DATA_HOME/Hytale/install/release/package/game/latest
• macOS : ~/Application Support/Hytale/install/release/package/game/latest

Copiez le dossier Server et le fichier Assets.zip dans un nouveau dossier dédié, par exemple hytale-server. Copiez, ne lancez pas le serveur sur place : depuis Chapter I, le serveur refuse de démarrer (code de sortie 11) si son dossier de travail, son monde ou ses sauvegardes se trouvent dans le dossier d'installation du launcher. Il existe une option --allow-install-dir pour forcer le démarrage, mais Hypixel prévient qu'elle expose à des pertes de données.

Méthode recommandée : Hytale Downloader

Sur un VPS, utilisez l'outil officiel en ligne de commande Hytale Downloader. Au premier lancement, il vous demande de vous connecter à votre compte Hytale depuis un navigateur pour autoriser le téléchargement.

./hytale-downloader -print-version   # affiche la version disponible
./hytale-downloader                  # télécharge la dernière version
./hytale-downloader -patchline pre-release   # canal de pré-version

Vous obtenez une archive datée. Une fois décompressée, elle contient le dossier Server/ et le fichier Assets.zip, dans la disposition officielle attendue par le serveur.

Étape 3 : lancer le serveur

Depuis le dossier Server, la commande minimale est :

java -jar HytaleServer.jar --assets ../Assets.zip

Si votre archive contient déjà un script start.sh ou start.bat à côté de Assets.zip, utilisez-le en priorité : c'est lui qui applique les mises à jour téléchargées par le serveur. Sinon, créez votre propre script, par exemple run-hytale.sh, en fixant la mémoire et en profitant du cache AOT fourni, qui accélère le démarrage :

#!/bin/bash
cd Server
java -Xms4G -Xmx8G -XX:AOTCache=HytaleServer.aot \
  -jar HytaleServer.jar --assets ../Assets.zip \
  --bind 0.0.0.0:5520 --backup --backup-dir backups

Rendez-le exécutable avec chmod +x run-hytale.sh. Sous Windows, placez la même ligne java dans un fichier .bat. Adaptez -Xmx au tableau de la section précédente, en laissant toujours 1 à 2 Go au système. L'option --backup active les sauvegardes automatiques ; --backup-frequency permet d'en régler l'intervalle.

Sur un VPS, lancez le serveur dans une session screen ou tmux, ou mieux, dans un service systemd, pour qu'il continue de tourner après la fermeture de votre connexion SSH.

Étape 4 : authentifier le serveur

Au premier démarrage, le serveur n'accepte pas encore de joueurs. Tapez dans sa console :

/auth login device

Le serveur affiche une adresse et un code court. Ouvrez la page de validation des appareils du site de comptes Hytale dans votre navigateur, connectez-vous et saisissez le code. Ne traînez pas : le code n'est valable que pendant un temps limité. Depuis Chapter I, la commande fonctionne aussi quand le serveur est déjà connecté, et un échec conserve la session existante.

Étape 5 : ouvrir le port 5520 en UDP

C'est l'étape où la plupart des guides et des joueurs se trompent : Hytale utilise UDP uniquement. Autorisez le port dans le pare-feu de la machine :

# Linux avec UFW
sudo ufw allow 5520/udp

# Linux avec iptables
sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT

# Windows (PowerShell en administrateur)
New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

À la maison, ajoutez ensuite une redirection dans l'interface de votre box : protocole UDP, port externe et interne 5520, vers l'adresse IP locale du PC qui fait tourner le serveur. Vos amis se connectent alors avec votre adresse IP publique.

Si votre fournisseur d'accès vous place derrière un CGNAT, fréquent avec les box 4G et 5G et chez certains opérateurs fibre, aucune redirection ne fonctionnera. Les solutions sont alors un tunnel, un VPS ou un hébergeur.

Étape 6 : configurer le serveur

Après le premier lancement, le dossier Server contient notamment :

Élément	Rôle
config.json	Configuration principale
universe/	Mondes et données des joueurs, à sauvegarder en priorité
mods/	Mods au format .jar ou .zip
permissions.json	Groupes et permissions
logs/	Journaux, à consulter en cas de problème

Arrêtez toujours le serveur avant de modifier un fichier : il réécrit ses fichiers de configuration pendant le jeu et pourrait écraser vos changements. Les réglages les plus utiles de config.json :

• ServerName et MOTD : le nom et le message affichés aux joueurs.
• Password : laissez vide pour un serveur ouvert, ou définissez un mot de passe demandé à la connexion.
• MaxPlayers : le nombre maximal de joueurs, à adapter à votre RAM.
• MaxViewRadius : la distance de vue en chunks, principal facteur de consommation de RAM. La recommandation courante est de ne pas dépasser 12. Depuis Chapter I, toute valeur hors de l'intervalle 1 à 32 est ramenée dans ces bornes avec un avertissement.
• Defaults : le monde et le mode de jeu par défaut.

Réserver le serveur à vos amis

Pour un serveur privé, ajoutez d'abord les joueurs autorisés, puis activez la liste blanche depuis la console :

/whitelist add <pseudo>
/whitelist enable
/whitelist list

La syntaxe des commandes a déjà évolué entre les versions de l'accès anticipé : si l'une d'elles est refusée, tapez /help dans la console pour voir celle de votre version. Pour vous donner les droits d'administrateur, consultez notre guide dédié pour devenir OP sur un serveur Hytale.

Ajouter des mods

Déposez les fichiers .jar ou .zip dans le dossier mods/, redémarrez, puis vérifiez dans logs/ qu'ils sont bien chargés. Téléchargez-les uniquement depuis des sources reconnues : la page officielle de l'auteur ou une plateforme de mods réputée. Attention : Chapter I a supprimé ou remplacé une grande partie de l'API de modding. Un mod conçu pour une version précédente doit être recompilé par son auteur, sinon il risque d'empêcher le démarrage. Testez toujours un nouveau mod sur une copie de votre monde.

Mettre à jour sans perdre votre monde

Le serveur intègre un système de mise à jour, utilisable depuis la console :

/update status          # version actuelle
/update check           # recherche une mise à jour
/update download        # télécharge dans updater/staging/
/update apply --confirm # sauvegarde puis arrête le serveur

Le remplacement des fichiers est ensuite effectué par le script de lancement officiel au redémarrage. Si vous lancez java directement, téléchargez plutôt la nouvelle version avec Hytale Downloader.

Avant toute mise à jour majeure, arrêtez le serveur et copiez le dossier universe/ ailleurs. Un monde ouvert par une version plus récente est converti automatiquement et ne peut plus être ouvert par une version plus ancienne : cette copie est votre seul retour en arrière possible.

Dépannage rapide

Symptôme	Cause probable	Solution
Le serveur s'arrête aussitôt avec le code 11	Serveur lancé dans le dossier du launcher	Copier Server et Assets.zip dans un dossier séparé
Erreur au lancement mentionnant la version de classe	Java trop ancien	Installer Java 25 et vérifier java --version
Personne ne peut se connecter de l'extérieur	Port ouvert en TCP ou box derrière un CGNAT	Ouvrir 5520 en UDP, sinon passer par un VPS
Les joueurs sont refusés après une mise à jour	Versions du protocole différentes	Mettre à jour le serveur à la même version que le client
Le serveur plante ou ralentit avec plusieurs joueurs	RAM insuffisante ou distance de vue trop élevée	Augmenter -Xmx et baisser MaxViewRadius

Pour aller plus loin sur les performances, notre guide d'optimisation d'un serveur Hytale détaille les réglages avancés.

La solution sans installation

Si vous ne voulez pas gérer Java, les ports et les mises à jour, un hébergeur s'en charge. Chez OuiHeberg, les offres OuiBox compatibles Hytale démarrent avec l'OuiBox 8G (8 Go de RAM, 4 cœurs, 50 Go NVMe) à 9,98 € par mois, puis l'OuiBox 12G (12 Go, 5 cœurs, 80 Go NVMe) à 16,79 € par mois et l'OuiBox 16G (16 Go, 6 cœurs, 120 Go NVMe) à 21,59 € par mois. Le serveur est prêt en quelques minutes, et il ne vous reste qu'à l'authentifier et à inviter vos amis.

Questions fréquentes

Créer un serveur Hytale est-il gratuit ?

Oui, le logiciel serveur est fourni gratuitement par Hypixel Studios. Il faut seulement posséder un compte Hytale pour l'authentifier. Le seul coût éventuel est la machine qui le fait tourner.

Quel port utilise un serveur Hytale ?

Le port 5520 en UDP par défaut. Vous pouvez le changer avec l'option --bind, à condition d'ouvrir le nouveau port en UDP.

Combien de RAM faut-il pour un serveur Hytale ?

On recommande généralement 4 Go pour 1 à 5 joueurs, 8 Go pour 10 à 20 joueurs, et 12 Go ou plus au-delà. La distance de vue pèse autant que le nombre de joueurs.

Puis-je jouer sur mon serveur depuis le même PC ?

Oui. Connectez-vous à l'adresse 127.0.0.1 depuis le jeu. Prévoyez assez de RAM pour faire tourner à la fois le client et le serveur.

Pourquoi mes amis ne peuvent-ils pas rejoindre mon serveur ?

Dans la grande majorité des cas, le port 5520 est ouvert en TCP au lieu d'UDP, la redirection de la box est absente, ou votre connexion est derrière un CGNAT. Vérifiez aussi que tout le monde a mis à jour le jeu.