Comment créer un serveur Hytale ? Guide complet 2026

Vous voulez monter un serveur Hytale pour jouer avec vos amis, mais les guides en ligne mélangent des informations obsolètes datant de l'annonce en 2018 avec la réalité de l'Early Access 2026. Hytale n'utilise pas TCP comme Minecraft. Le serveur ne se lance pas comme un .jar Minecraft classique. Et l'authentification OAuth2 est obligatoire. Ce guide suit la documentation officielle d'Hypixel Studios et couvre uniquement ce qui fonctionne aujourd'hui.

Ce qu'il faut retenir

• Hytale nécessite Java 25 (pas Java 17 ni Java 21 comme Minecraft).
• Le serveur utilise le protocole QUIC sur UDP (port 5520 par défaut), pas TCP. Votre pare-feu et votre port forwarding doivent être configurés en UDP.
• L'authentification OAuth2 est obligatoire au premier lancement. Sans elle, aucun joueur ne peut se connecter.
• Les mods se déposent dans le dossier mods/ et sont synchronisés automatiquement aux clients qui se connectent. Pas d'installation côté joueur.

Prérequis

Un serveur Hytale peut tourner sur n'importe quelle machine avec au minimum 4 Go de RAM et Java 25. Les architectures x64 et arm64 sont supportées (Windows, Linux, macOS).

La view distance par défaut de Hytale est de 384 blocs (12 chunks), soit l'équivalent de 24 chunks Minecraft. C'est gourmand. Si votre serveur a une RAM limitée, réduire cette valeur est le premier levier de performance.

Installer Java 25

Téléchargez Java 25 depuis Adoptium (Temurin, la distribution recommandée par Hypixel Studios). Vérifiez l'installation :

java --version

Résultat attendu :

openjdk 25.0.1 2025-10-21 LTS

Si votre système renvoie une version différente (17, 21, etc.), c'est qu'une autre installation Java a priorité dans votre PATH. Sur un serveur dédié, désinstallez les anciennes versions ou pointez explicitement vers le binaire Java 25.

Obtenir les fichiers serveur

Trois méthodes officielles existent. La méthode recommandée pour un serveur de production est le Hytale Downloader CLI.

Méthode 1 : Hytale Downloader CLI (recommandée)

Un outil en ligne de commande qui télécharge les fichiers serveur avec authentification OAuth2 intégrée. Téléchargez-le depuis downloader.hytale.com et suivez le fichier QUICKSTART.md inclus dans l'archive.

Méthode 2 : Copie depuis le launcher

Si Hytale est déjà installé sur votre PC, copiez les fichiers depuis le dossier d'installation :

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

Copiez le dossier Server/ et le fichier Assets.zip vers votre dossier serveur. Simple pour tester rapidement, mais pénible à maintenir à jour.

Méthode 3 : Bootstrap depuis HytaleServer.jar

Placez HytaleServer.jar dans un dossier vide et lancez-le en mode bootstrap :

java -jar HytaleServer.jar --bootstrap

Le serveur démarre en mode minimal, vous authentifie, télécharge les fichiers manquants, configure la structure de dossiers, puis s'arrête. Relancez ensuite avec le script start.sh (Linux) ou start.bat (Windows) généré automatiquement.

Lancer le serveur et s'authentifier

Démarrez le serveur avec :

java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip

Le paramètre -XX:AOTCache utilise le cache AOT (Ahead-Of-Time) fourni avec le serveur pour accélérer le démarrage en évitant la phase de warm-up JIT. C'est optionnel mais recommandé.

Authentification OAuth2 (obligatoire)

Au premier lancement, le serveur ne peut pas accepter de connexions. Vous devez l'authentifier via la console :

/auth login device

Le serveur affiche un code et un lien. Ouvrez le lien dans votre navigateur (https://accounts.hytale.com/device), entrez le code, et validez. Une fois l'authentification réussie, le serveur sauvegarde les credentials dans auth.enc et auth.key. Vous n'aurez pas à refaire cette étape sauf si vous supprimez ces fichiers.

Il y a une limite de 500 serveurs par licence Hytale. Pour un joueur normal, c'est largement suffisant. Pour un hébergeur professionnel, Hypixel Studios propose un processus d'authentification dédié via leur guide Server Provider. Une fois le serveur en ligne, consultez notre guide complet des commandes Hytale pour la modération, les permissions et la gestion du monde.

Configuration réseau

C'est le point qui piège le plus d'administrateurs venant de Minecraft. Hytale utilise le protocole QUIC sur UDP, pas TCP. Toute votre configuration réseau doit refléter ça.

Port

Le port par défaut est 5520 UDP. Modifiable avec le paramètre --bind :

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

Port forwarding

Si votre serveur est derrière un routeur (hébergement à domicile), redirigez le port UDP 5520 vers l'IP locale de votre machine. Pas de redirection TCP nécessaire.

Pare-feu

Windows (PowerShell) :

New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

Linux (ufw) :

sudo ufw allow 5520/udp

Linux (iptables) :

sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT

Structure des fichiers

Chaque monde est stocké dans universe/worlds/ avec son propre config.json contenant le seed, le type de génération, les paramètres PvP, les dégâts de chute, le temps de jeu, et les plugins requis. Chaque monde tourne sur son propre thread principal.

Installer des mods

Téléchargez des mods depuis CurseForge (section Hytale) et déposez les fichiers .zip ou .jar dans le dossier Server/mods/. Redémarrez le serveur.

La différence majeure avec Minecraft : les mods Hytale se synchronisent automatiquement avec les clients qui se connectent. Les joueurs n'ont rien à installer de leur côté. Le serveur envoie les ressources nécessaires au client lors de la connexion. C'est le changement le plus significatif par rapport à l'écosystème Minecraft, où chaque joueur doit installer manuellement le même pack de mods que le serveur.

Mises à jour automatiques

Le serveur Hytale intègre un système de mise à jour automatique. Par défaut, il vérifie les nouvelles versions toutes les heures. Quand une mise à jour est disponible, il la télécharge dans un dossier updater/staging/. L'application de la mise à jour se fait via :

/update apply --confirm

Le serveur s'arrête avec le code de sortie 8. Le script start.sh ou start.bat détecte ce code, applique les fichiers mis à jour (sans toucher à la config, aux sauvegardes ni aux mods), et redémarre automatiquement.

Le mode AutoApplyMode dans config.json permet d'automatiser l'application : Disabled (défaut, application manuelle), WhenEmpty (applique quand aucun joueur n'est connecté), ou Scheduled (applique après un délai configurable, même avec des joueurs en ligne).

Hébergement : auto-hébergé vs hébergeur

Auto-hébergé (chez vous) : gratuit hors électricité, mais vous devez gérer Java, le pare-feu, le port forwarding, les backups et la disponibilité. Si votre PC est éteint, le serveur est inaccessible. Votre adresse IP publique est visible par tous les joueurs qui se connectent.

Hébergeur de serveurs : la plupart des hébergeurs Minecraft proposent désormais des offres Hytale. L'avantage est le même que pour Minecraft : IP fixe, disponibilité 24/7, panel de gestion, protection DDoS, et support technique. L'installation se fait généralement en un clic depuis le panel.

Si vous débutez et que vous voulez tester avec 2-3 amis, l'auto-hébergement fonctionne. Si vous visez un serveur communautaire avec 10+ joueurs en ligne régulièrement, un hébergeur dédié est le choix le plus fiable.

Questions fréquentes

Hytale utilise-t-il les mêmes plugins que Minecraft ?

Non. Hytale a son propre système de mods et plugins, incompatible avec Bukkit, Spigot, Paper ou Fabric. Les mods Hytale sont développés en Java et utilisent l'API d'Hypixel Studios. L'écosystème est encore jeune (le jeu est en Early Access depuis janvier 2026), mais CurseForge héberge déjà une section dédiée et des plugins de base existent (monitoring, performances, API web).

Les joueurs doivent-ils installer les mods manuellement ?

Non. C'est l'une des différences majeures avec Minecraft. Les mods serveur Hytale se synchronisent automatiquement avec les clients lors de la connexion. Un joueur qui rejoint un serveur moddé reçoit les ressources nécessaires sans rien installer. C'est transparent et immédiat.

Peut-on héberger un serveur Hytale sur un VPS Linux ?

Oui. Le serveur supporte Linux x64 et arm64. Installez Java 25, téléchargez les fichiers via le Hytale Downloader CLI, ouvrez le port UDP 5520, authentifiez le serveur, et lancez le script. Un VPS avec 4 Go de RAM et 2 vCPU suffit pour un petit groupe. Pour 10+ joueurs, visez 8 Go et un CPU performant en mono-thread.

Le serveur client et le serveur doivent-ils être sur la même version ?

Oui, pour l'instant. Le protocole QUIC de Hytale utilise un hash de version qui doit correspondre exactement entre le client et le serveur. Si vous mettez à jour le serveur et qu'un joueur n'a pas encore mis à jour son client, il ne pourra pas se connecter. Hypixel Studios prévoit d'ajouter une tolérance de ±2 versions dans une future mise à jour, mais ce n'est pas encore implémenté.

Comment sauvegarder mon serveur Hytale ?

Le serveur inclut un système de backup automatique activable avec le paramètre --backup au lancement (inclus par défaut dans les scripts start.sh/start.bat). Les sauvegardes sont stockées dans Server/backups/ et créées toutes les 30 minutes par défaut. Pour un backup manuel, copiez simplement le dossier Server/universe/ pendant que le serveur tourne (les fichiers sont conçus pour être copiés à chaud).

Combien de joueurs un serveur Hytale peut-il accueillir ?

Il n'y a pas de limite technique codée en dur. La capacité dépend du hardware. Avec 4 Go de RAM et un CPU correct, comptez 5 à 10 joueurs confortablement. Avec 8 Go et un processeur haute fréquence, 20 à 30 joueurs. Les grands réseaux de serveurs (type Hypixel) utilisent l'architecture multiserveur native de Hytale pour répartir la charge sur plusieurs instances.