Comment créer un serveur Hytale — Guide complet 2026

Créer un serveur Hytale demande trois choses : Java 25, les fichiers du serveur Hytale et un port UDP 5520 ouvert. Hytale fournit un logiciel de serveur dédié officiel, vous pouvez donc héberger votre propre monde multijoueur sur Windows, Linux ou macOS dès le premier jour de l'accès anticipé (Early Access). Ce guide parcourt chaque étape — installer Java, s'authentifier, ouvrir les ports, configurer les mondes et ajouter des mods — d'après le manuel officiel Hytale Server Manual publié par Hypixel Studios pour le lancement de l'Early Access le 13 janvier 2026.

Ce qu'il faut pour créer un serveur Hytale

Un serveur Hytale fonctionne sur tout appareil disposant d'au moins 4 Go de mémoire (RAM) et de Java 25 installé, sur les architectures x64 et arm64. Selon le Hytale Server Manual officiel, le serveur lui-même est indépendant de la plateforme — il fonctionne sur Windows, Linux et macOS — tandis que le client Hytale en Early Access prend en charge Windows 10/11 (x64), Linux x64 et macOS Apple Silicon. Il faut aussi une licence Hytale valide, car chaque serveur Hytale doit s'authentifier auprès du service officiel Hytale.

Java 25 UDP 5520 QUIC sur UDP x64 et arm64 500 serveurs / licence Windows · Linux · macOS

Le matériel au-delà du minimum de 4 Go dépend du nombre de joueurs et de leur comportement. Le Hytale Server Manual identifie deux facteurs : la charge CPU augmente avec un grand nombre de joueurs et d'entités (NPC, mobs), tandis que la RAM augmente avec la taille de la zone de monde chargée. Il n'existe pas de chiffre de RAM « correct » unique — Hypixel Studios recommande de surveiller la RAM et le CPU en usage réel et de fixer une limite explicite -Xmx. Les hébergeurs communautaires suggèrent souvent 4–8 Go pour moins de 10 joueurs et 16 Go ou plus pour les grands serveurs publics, mais ce sont des estimations, pas une exigence officielle.

Comment installer Java 25 pour un serveur Hytale

Java 25 est obligatoire pour un serveur Hytale — les versions plus anciennes de Java ne le lanceront pas. Téléchargez Java 25 depuis Adoptium (Eclipse Temurin), choisissez la build 64-bit pour votre système d'exploitation et installez-la. Confirmez ensuite l'installation en ouvrant un terminal et en exécutant :

java --version

La sortie attendue indique Temurin 25, par exemple openjdk 25.0.1 2025-10-21 LTS suivi des lignes de l'environnement Temurin. Si la commande renvoie une version plus ancienne ou « command not found », réinstallez Java 25 et assurez-vous qu'il figure dans le PATH système avant de lancer le serveur Hytale.

Comment obtenir les fichiers du serveur Hytale

Il existe deux façons officielles d'obtenir les fichiers du serveur Hytale. La première est rapide pour les tests, la seconde est conçue pour les serveurs de production qui doivent se mettre à jour facilement.

Méthode 1 : copier depuis votre installation du launcher Hytale

Votre installation du jeu Hytale contient déjà les fichiers du serveur. Ouvrez le dossier d'installation du launcher, copiez le dossier Server et le fichier Assets.zip (environ 3,3 Go) dans un dossier dédié comme C:\HytaleServer. Le chemin d'installation du launcher diffère selon le système d'exploitation :

• 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

Méthode 2 : utiliser la Hytale Downloader CLI

La Hytale Downloader CLI est la méthode recommandée pour les serveurs Hytale de production car elle garde les fichiers faciles à mettre à jour et met en place l'arborescence nécessaire aux mises à jour automatiques. Téléchargez hytale-downloader.zip (Linux et Windows), extrayez-le et lancez ./hytale-downloader pour récupérer la dernière version via l'authentification OAuth2. Indicateurs utiles : -print-version pour voir la version du jeu sans télécharger, et -patchline pre-release pour télécharger depuis le canal pre-release.

Comment lancer et authentifier un serveur Hytale

Lancez un serveur Hytale avec le cache AOT pour démarrer plus vite. Depuis le dossier du serveur, exécutez :

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

Le serveur Hytale est fourni avec un cache AOT préentraîné (HytaleServer.aot) qui accélère le démarrage en évitant le préchauffage du JIT. Pour gérer la mémoire, ajoutez les indicateurs -Xms et -Xmx — par exemple -Xms2G -Xmx4G. Après le premier lancement, le serveur Hytale se met en pause et attend l'authentification.

Authentifiez le serveur Hytale en tapant /auth login device dans la console du serveur. La console affiche un lien (https://accounts.hytale.com/device) et un code tel que ABCD-1234. Ouvrez le lien dans un navigateur, connectez-vous avec votre compte Hytale et saisissez le code. Le code expire au bout de 900 secondes (15 minutes). En cas de succès, la console affiche « Authentication successful! ». L'authentification permet au serveur Hytale de communiquer avec les API officielles du service et lutte contre les abus — il existe une limite de 500 serveurs par licence Hytale.

Comment configurer les ports et le pare-feu pour un serveur Hytale

Un serveur Hytale utilise le protocole QUIC sur UDP, sur le port par défaut 5520 — vous devez donc rediriger (port forwarding) l'UDP, pas le TCP. C'est la cause la plus fréquente d'échecs de connexion : ne rediriger que le TCP empêche les joueurs de se connecter. Pour héberger derrière un routeur, redirigez le port UDP 5520 vers l'IP locale de la machine serveur, puis autorisez le port dans le pare-feu (firewall) du système d'exploitation.

QUIC gère bien le NAT dans la plupart des cas. Si les joueurs ne se connectent toujours pas, vérifiez que la redirection est en UDP, que l'adresse de liaison est 0.0.0.0 et non 127.0.0.1, et notez que les configurations de NAT symétrique peuvent nécessiter un VPS ou un serveur dédié.

Comment se connecter à votre serveur Hytale

Les joueurs rejoignent un serveur Hytale via Multiplayer → Direct Connect dans le client Hytale. Le format d'adresse est l'IP du serveur suivie du port : utilisez localhost:5520 sur la même machine, l'IP locale comme 192.168.1.100:5520 sur un réseau domestique, ou votre IP publique ou domaine avec l'UDP 5520 redirigé pour jouer par internet. Le serveur Hytale fonctionne indépendamment du client, donc le monde reste en ligne après la fermeture du jeu. Arrêtez-le proprement avec la commande /stop.

Comment configurer le monde d'un serveur Hytale

Un serveur Hytale utilise deux couches de configuration. Le dossier racine contient config.json (paramètres à l'échelle du serveur, dont le bloc de mise à jour automatique), ainsi que permissions.json, whitelist.json et bans.json. Chaque monde a son propre config.json dans universe/worlds/. Les paramètres par monde incluent la graine (seed) du monde, le type de génération et des interrupteurs de gameplay comme le PvP et les dégâts de chute.

{
  "Seed": 1767292261384,
  "WorldGen": { "Type": "Hytale", "Name": "Default" },
  "IsPvpEnabled": false,
  "IsFallDamageEnabled": true,
  "IsSpawningNPC": true,
  "GameplayConfig": "Default"
}

Modifiez les fichiers de configuration d'un serveur Hytale uniquement lorsque le serveur est arrêté. Le Hytale Server Manual avertit que les fichiers de configuration sont lus au démarrage et réécrits lorsque des actions en jeu se produisent, de sorte que les modifications manuelles sur un serveur en cours d'exécution seront probablement écrasées.

Commandes et permissions du serveur Hytale

Le moyen le plus fiable de découvrir les commandes du serveur Hytale est la commande /help, qui liste toutes les commandes prises en charge par votre build précise ; ajoutez --help à n'importe quelle commande pour voir sa syntaxe. La Hytale Server API officielle confirme l'existence de commandes pour les bannissements, la liste blanche (add, remove, list, enable, disable, clear, status) et les permissions, aux côtés des commandes principales comme /auth login device, /stop et /update. Dans la console du serveur, les commandes se tapent sans la barre oblique de début.

Comme la syntaxe exacte des commandes évolue encore entre les builds d'Early Access, la façon la plus sûre d'accorder un accès administrateur sur un serveur Hytale est de modifier permissions.json directement, serveur arrêté. Le fichier a deux sections : groups (chacune définissant un ensemble de permissions) et users (associant l'UUID d'un joueur à un ou plusieurs groupes). Un groupe avec ["*"] a tous les droits d'administrateur, tandis qu'une liste vide est un joueur de base. Les opérateurs contournent toujours la liste blanche.

Comment installer des mods sur un serveur Hytale

Hytale utilise un modèle de modding server-first : tous les mods résident sur le serveur Hytale et sont livrés aux joueurs automatiquement à la connexion. Les joueurs ne téléchargent jamais de mods client ni ne jonglent avec des chargeurs de mods — c'est une différence clé par rapport à des jeux comme Minecraft. Pour ajouter des mods, déposez des fichiers .zip ou .jar (par exemple depuis CurseForge) dans le dossier mods/ du serveur ; le serveur les charge au démarrage et les sert à toute personne qui se connecte.

Le modding Hytale couvre quatre types de contenu. Les Server Plugins sont des fichiers Java .jar compilés qui utilisent la Hytale Server API pour ajouter des mécaniques, des économies, des commandes et des mini-jeux. Les Data Assets sont des fichiers JSON qui définissent blocs, objets, NPC, génération de monde et tables de butin sans code. Les Art Assets sont des sons, modèles et textures, avec intégration Blockbench pour les modèles. Les Save Files sont des mondes et des prefabs que vous pouvez partager. Le client Hytale est un moteur de rendu à code fermé qui n'exécute aucune logique de jeu, c'est pourquoi les mods exclusivement client ne sont pas pris en charge par conception.

Performance du serveur Hytale et view distance

La distance d'affichage (view distance) est le principal facteur d'utilisation de la RAM sur un serveur Hytale. La valeur par défaut de Hytale est de 384 blocs : cela équivaut à 12 chunks Hytale (un chunk Hytale fait 32 blocs) et à environ 24 chunks Minecraft (un chunk Minecraft fait 16 blocs), bien plus que la vue par défaut de 10 chunks de Minecraft. C'est pourquoi Hypixel Studios recommande de plafonner la distance d'affichage maximale autour de 12 chunks (384 blocs) et de la réduire pour un plus grand nombre de joueurs. Commencez prudemment et n'augmentez la valeur que si votre matériel reste stable.

Les partenaires d'hébergement de Hypixel Studios, Nitrado et Apex Hosting, maintiennent des plugins pour les besoins courants du serveur Hytale :

Sauvegardes et mises à jour automatiques du serveur Hytale

Un serveur Hytale dispose d'un système intégré de sauvegarde et de mise à jour automatique. Activez les sauvegardes périodiques avec --backup --backup-dir backups --backup-frequency 30 (les scripts wrapper par défaut les incluent déjà). Testez toujours la restauration d'une sauvegarde avant d'en avoir réellement besoin. Pour les mises à jour automatiques, le serveur Hytale recherche de nouvelles versions, les télécharge dans updater/staging/ et s'arrête avec le code de sortie 8 ; le script wrapper inclus (start.sh ou start.bat) détecte le code 8, remplace les nouveaux fichiers tout en préservant votre configuration, vos mondes et vos mods, puis redémarre.

Contrôlez les mises à jour avec les commandes /update : /update check, /update download, /update apply --confirm, /update status et /update cancel. Le comportement d'auto-application se définit dans le bloc Update du config.json racine via AutoApplyMode (Disabled, WhenEmpty ou Scheduled). Vous pouvez désactiver complètement les mises à jour avec la variable d'environnement HYTALE_DISABLE_UPDATES.

Dépannage du serveur Hytale

La plupart des problèmes de serveur Hytale viennent du réseau, de la mémoire ou de décalages de version. Les solutions ci-dessous couvrent les problèmes les plus fréquents pendant l'Early Access.

• La fenêtre du serveur se ferme aussitôt : HytaleServer.jar ou Assets.zip manque dans le dossier — vérifiez la présence des deux et lancez avec --help.
• Les joueurs ne se connectent pas : seul le TCP a été redirigé au lieu de l'UDP 5520, l'adresse de liaison est 127.0.0.1 au lieu de 0.0.0.0, ou le pare-feu bloque — vérifiez aussi le NAT symétrique.
• Plantages par pression mémoire : augmentez -Xmx. Une hausse de l'utilisation CPU est un symptôme de pression du ramasse-miettes.
• Connexion impossible après une mise à jour du jeu : les versions de protocole du client et du serveur doivent correspondre — mettez à jour le serveur Hytale.
• Les modifications de config ne sont pas enregistrées : modifiez les fichiers de configuration serveur arrêté ; les changements sur un serveur en marche sont écrasés.
• Authentification expirée : relancez /auth login device — le code est valable 900 secondes.

Un réseau de serveurs Hytale : architecture multiserveur

Hytale prend en charge les réseaux multiserveurs nativement, aucun proxy inverse externe comme BungeeCord n'est donc requis. Un serveur Hytale peut transférer un joueur connecté vers un autre serveur avec un paquet de référence (PlayerRef.referToServer(host, port, data)), rediriger un joueur pendant le handshake de connexion, ou envoyer les joueurs déconnectés vers un serveur de repli préconfiguré. Comme les payloads de référence transitent par le client et peuvent être falsifiés, Hypixel Studios conseille de les signer cryptographiquement (par exemple avec HMAC). Des proxys personnalisés peuvent être construits sur Netty QUIC, car Hytale utilise QUIC exclusivement pour la communication client-serveur.

Ce qui arrive aux serveurs Hytale

Plusieurs fonctionnalités du serveur Hytale sont confirmées comme prévues mais pas encore disponibles, à la date du lancement de l'Early Access en 2026. Hypixel Studios a annoncé un catalogue de découverte de serveurs et de mini-jeux dans le client avec des décomptes de joueurs vérifiés, un système de groupe (party) pour se déplacer ensemble entre serveurs, une passerelle de paiement intégrée pour les opérateurs, des endpoints d'API maison (recherche UUID par nom, version du jeu, profils de joueurs, télémétrie serveur) et une tolérance de version de protocole de ±2. La prise en charge des enregistrements SRV est à l'étude mais pas encore disponible. Considérez ceci comme des éléments de feuille de route, pas des fonctionnalités actuelles.

Comment créer un serveur Hytale — Foire aux questions

Peut-on créer un serveur Hytale gratuitement ?

Oui, vous pouvez créer un serveur Hytale gratuitement en l'hébergeant sur votre propre ordinateur — il vous faut seulement Java 25, les fichiers du serveur et un port UDP 5520 redirigé. Il faut tout de même une licence Hytale valide pour authentifier le serveur. Louer un serveur Hytale géré chez un hébergeur coûte de l'argent mais ajoute une disponibilité 24/7 et une configuration en un clic.

De combien de RAM un serveur Hytale a-t-il besoin ?

Un serveur Hytale a besoin d'au moins 4 Go de RAM selon le minimum officiel. L'utilisation réelle dépend surtout de la view distance et de la zone de monde chargée, donc les serveurs plus grands ou plus fréquentés en ont besoin de davantage. Hypixel Studios recommande de surveiller la RAM en usage réel et de fixer une limite explicite -Xmx plutôt que de se fier à un chiffre fixe.

Quel port utilise un serveur Hytale ?

Un serveur Hytale utilise le port UDP 5520 par défaut, via le protocole QUIC. Vous devez rediriger l'UDP, pas le TCP. Le port peut être changé avec l'argument --bind, par exemple --bind 3500.

Les joueurs doivent-ils installer des mods pour rejoindre un serveur Hytale moddé ?

Non. Hytale utilise un modding server-first, donc tous les mods résident sur le serveur Hytale et sont livrés aux joueurs automatiquement à la connexion. Les joueurs ne téléchargent pas de mods client ni n'installent de chargeurs de mods pour rejoindre un serveur Hytale moddé.

Un serveur Hytale peut-il fonctionner sous Linux ?

Oui. Le serveur Hytale est indépendant de la plateforme et fonctionne sous Windows, Linux et macOS, sur les architectures x64 et arm64, à condition que Java 25 soit installé. Le Hytale Server Manual fournit des commandes de pare-feu Linux et un script de lancement Linux.

Combien de serveurs Hytale une licence peut-elle authentifier ?

Une licence Hytale peut authentifier jusqu'à 500 serveurs. Hypixel Studios a fixé cette limite pour prévenir les abus précoces ; les opérateurs qui ont besoin de plus de capacité peuvent contacter le support Hytale.