Comment configurer un serveur Hytale (2026)

Dans ce guide, nous allons voir comment installer, configurer et lister un serveur Hytale sur Windows, Linux et macOS.

Les serveurs Hytale sont un peu différents des autres jeux pour lesquels nous rédigeons des guides de serveur, pour une raison précise : chaque monde Hytale est déjà un serveur. Lorsque vous créez un monde solo, le client lance un serveur local et le rejoint. Le multijoueur fonctionne exactement de la même façon, avec d'autres personnes qui se connectent. Il n'y a pas de « mode serveur » séparé à activer.

Cela signifie aussi que les mods relèvent du serveur plutôt que du client, ce qui est couvert dans notre guide des mods Hytale.

Une remarque sur l'actualité de ce guide : Hytale est en accès anticipé depuis janvier 2026 et Hypixel Studios n'a pas encore publié de document autonome sur la mise en place d'un serveur dédié. Ce qui suit est construit à partir de leur documentation officielle, des notes de patch et des Server Operator Policies, et indique clairement où s'arrête la documentation officielle.

Prérequis

Les exigences minimales publiées par Hytale pour le client sont :

	Minimum
OS	Windows 11 ou Windows 10 x64 (1809), Linux x64 (kernel 6.15), ou Apple Silicon avec macOS Tahoe 26.0
CPU	Intel Core i5-7500, AMD Ryzen 3 1200, ou Apple M1
RAM	8 Go
GPU	Intel UHD 620, AMD Radeon Vega 6, Apple M1, ou une carte GTX 900 / Radeon série 400

Pour un serveur, ignorez la ligne GPU et revoyez tout le reste à la hausse :

• La RAM est la contrainte principale. Le serveur tourne en Java, il garde en mémoire les chunks et entités chargés, et les asset packs s'ajoutent à cela. 8 Go est un minimum pour un petit groupe, et un serveur actif avec des mods en demandera nettement plus.
• La performance mono-thread compte. Comme dans la plupart des jeux à base de blocs, une bonne partie du travail par tick n'est pas parallélisée.
• Le disque dépend entièrement de l'étendue du monde explorée. Les sauvegardes de monde grossissent régulièrement.
• Une licence Hytale, achetée sur hytale.com. Le jeu n'est pas sur Steam.

NOTE - Hytale est réservé à l'Apple Silicon sur macOS. Il n'existe pas de build Intel Mac.

Comprendre le modèle de serveur d'Hytale

Kevin Carstens, Technical Director d'Hytale, l'a dit clairement lorsque le studio a publié sa stratégie de modding : Hytale est différent en ce sens que même en solo, vous rejoignez un serveur local qui vous est propre. Quand la documentation parle de serveurs, elle désigne à la fois le solo et le multijoueur.

En pratique, cela a quelques conséquences à bien intégrer :

• Les mods sont installés une seule fois, par l'hôte. Les joueurs qui rejoignent votre serveur n'installent rien. Leur client vanilla affiche ce que votre serveur lui indique.
• Vos connaissances du solo se transfèrent. Configurer un monde en solo et configurer un serveur relèvent presque de la même compétence.
• Il n'existe pas de client moddé à distribuer. Le studio a indiqué ne pas avoir l'intention de prendre en charge les mods côté client, précisément pour qu'un écosystème fragmenté de clients propres à chaque serveur ne voie jamais le jour.

Univers, mondes et instances

Hytale organise les choses selon une hiérarchie que l'on retrouve tout au long des configs et des notes de patch.

Un univers contient des mondes. Un monde est ce que les joueurs perçoivent comme la carte. Les instances sont des copies distinctes d'un monde, utilisées pour des éléments comme les Portal Devices, et elles peuvent hériter de réglages tels que les dégâts de chute et le PvP depuis le monde par défaut de l'univers.

Vous croiserez ce vocabulaire dans la configuration des plugins, il vaut donc la peine de le connaître avant de commencer à lire les fichiers de config.

Héberger depuis le client

Pour un petit groupe, c'est toute la réponse et cela ne nécessite aucun logiciel supplémentaire.

Créez un monde dans le client, choisissez les mods et asset packs souhaités dans les options New World, puis partagez un code d'invitation à vos amis. Ils se connectent et jouent avec un client totalement vanilla.

Cela convient à un groupe d'amis, et c'est ainsi que la plupart des gens géreront leur première partie multijoueur d'Hytale. Les limites sont évidentes : le monde n'est actif que lorsque votre client tourne, il entre en concurrence avec votre propre jeu pour les ressources, et il est lié à votre machine.

Faire tourner un serveur autonome

Pour quelque chose de persistant qui fonctionne sans que vous soyez connecté, il faut faire tourner le serveur à part.

C'est ici que la documentation officielle s'arrête actuellement. Hypixel Studios fournit une référence de l'API Java du serveur et une documentation sur les assets, et gère Server Discovery avec un document de politique complet derrière, donc les serveurs auto-hébergés sont clairement prévus et pris en charge. Ce qui n'a pas encore été publié, c'est un guide pas à pas du type « téléchargez ceci, exécutez cette commande » comme on en trouve pour Valheim ou ARK.

En attendant, les pistes pratiques sont :

• Le launcher Hytale et le gestionnaire de compte. La distribution des serveurs passe par la plateforme propre à Hytale plutôt que par une boutique tierce, donc accounts.hytale.com est l'endroit à consulter en premier.
• Le Discord officiel. Le Discord Hytale réunit les développeurs du studio et c'est là que se trouvent les opérateurs de serveurs actuels. Pour quelque chose qui évolue aussi vite, c'est plus fiable que n'importe quel guide écrit, celui-ci compris.
• Un hébergeur géré. Plusieurs hébergeurs de serveurs de jeux ont ajouté la prise en charge d'Hytale en 2026 et s'occupent de la mise en place pour vous.

NOTE - Le serveur n'est pas obfusqué, et le studio s'est engagé à publier le code source du serveur dans le cadre du programme Hytale Shared Source, lancé en juin 2026. Les joueurs disposant d'une licence peuvent accéder au code source complet du serveur, au protocole réseau et aux assets sur GitHub, selon un modèle d'accès inspiré du programme de code source d'Unreal Engine chez Epic. Si vous êtes technique, c'est la documentation la plus complète qui existe.

Où se trouvent les fichiers du serveur

Sur une installation client, la partie serveur se trouve sous UserData :

C:\Users\<user>\AppData\Roaming\Hytale\UserData

avec Mods pour les mods disponibles globalement et Saves\<World Name> pour chaque monde, chacun ayant son propre dossier mods.

Linux et macOS utilisent le répertoire de données d'application équivalent pour la plateforme, avec la même structure en dessous.

Un serveur autonome conserve la même structure : un répertoire mods pour les plugins et les asset packs, et les données de monde à côté.

Prérequis Linux

Le serveur de Hytale est en Java, il vous faut donc une JVM ainsi que les outils habituels d'entretien de serveur.

Debian et Ubuntu :

sudo apt update
sudo apt install -y openjdk-21-jre-headless screen curl unzip

Fedora, RHEL et Rocky :

sudo dnf install -y java-21-openjdk-headless screen curl unzip

Vérifiez ce que vous avez avec :

java -version

ASTUCE - Vérifiez la version de Java attendue par la version actuelle de Hytale avant de vous engager sur une JVM. Elle a changé pendant l'accès anticipé, et une incompatibilité produit une erreur peu explicite.

Le prérequis Linux de Hytale est un système x64 avec kernel 6.15, ce qui est plus récent que ce que fournissent par défaut plusieurs distributions LTS. Vérifiez avec uname -r avant de commencer.

Installer des mods et des plugins

Les mods vont dans le répertoire mods du serveur et celui-ci les charge au démarrage.

1. Téléchargez le plugin ou l'asset pack, généralement depuis CurseForge.
2. Placez-le dans le répertoire mods du serveur. Les plugins sont des fichiers Java .jar ; les asset packs sont un zip ou un dossier contenant un manifest.json.
3. Redémarrez le serveur.

Les plugins bien conçus créent leur propre dossier sous mods pour la configuration et les données. BetterMap, par exemple, crée mods/bettermap/ avec un config.json à l'intérieur, et enregistre des commandes /bm dont /bm reload pour prendre en compte les changements de configuration sans redémarrage.

Les joueurs n'ont besoin de rien installer. C'est tout l'intérêt du modèle côté serveur.

Notre guide des mods Hytale détaille les quatre catégories de mods et la façon dont les asset packs sont构建...

Configuration

La configuration de Hytale est en JSON, et elle est répartie entre plusieurs emplacements plutôt que centralisée dans un seul fichier de type server.properties.

• Les paramètres de monde sont choisis à la création d'un monde, couvrant des éléments comme les dégâts de chute et le PvP, et les instances peuvent les hériter du monde par défaut de l'univers.
• Les configurations de gameplay se trouvent en JSON dans les répertoires de configuration du serveur. Les notes de patch mentionnent des chemins comme GameplayConfigs/Portal.json, ce qui donne une idée de la structure.
• Les configurations de plugins se trouvent dans le dossier propre à chaque plugin dans mods.

Le format et les chemins évoluant encore d'une mise à jour à l'autre, les notes de patch sur hytale.com valent la peine d'être lues à chaque mise à jour. Les notes de l'Update 7, par exemple, ont carrément renommé plusieurs clés de configuration.

AVERTISSEMENT - Lisez les notes de patch avant de mettre à jour un serveur en production. Hytale publie des patchs hebdomadaires en pré-version regroupés dans des versions stables toutes les quelques semaines, et des clés de configuration ont été renommées et supprimées entre elles. Un renommage que vous n'avez pas remarqué signifie qu'un paramètre revient silencieusement à sa valeur par défaut.

Être référencé dans Server Discovery

Server Discovery est le navigateur de serveurs intégré au jeu, sorti avec l'Update 5 en mai 2026. Le référencement est gratuit et le processus est entièrement documenté.

1. Connectez-vous à l'Account Manager et ouvrez la page Server Profiles.
2. Cliquez sur Create server.
3. Renseignez vos informations :
   • Nom et description. C'est sur cela que les joueurs vous jugent, donc précisez ce qu'est réellement votre serveur.
   • Type de serveur, parmi Survival, Adventure/RPG, Creative, PvP, Minigames, Roleplay, Social, Sandbox ou Other.
   • Tag d'audience : Everyone, Teen ou Mature.
   • Régions desservies, parmi dix options couvrant l'Amérique du Nord, l'Amérique du Sud, l'Europe, le Moyen-Orient, l'Asie et l'Océanie.
   • Vérification de domaine via un enregistrement DNS TXT, pour que les joueurs sachent que le listing est bien le vôtre.
4. Soumettez et attendez la modération. Un modérateur vérifie l'exactitude des informations, et le statut sur votre fiche de listing évolue au fil de l'examen.
5. Une fois accepté, configurez votre serveur pour envoyer des heartbeats à l'aide du discovery token présent sur votre fiche de listing.

Les listings sont examinés dans l'ordre d'arrivée. L'équipe sélectionne également des serveurs mis en avant pour la communauté.

Heartbeats

Votre serveur prouve qu'il est actif en envoyant des heartbeats à l'aide du discovery token présent sur votre fiche de listing. Générer ce token se fait via une simple commande à exécuter en tant qu'OP, dans la console ou dans le chat, pour finaliser la liaison.

Si votre serveur cesse d'envoyer des heartbeats pendant plus de deux minutes, il est masqué des listings jusqu'à ce qu'il revienne. C'est un choix de conception sensé, qui fait qu'un serveur instable disparaît discrètement de Discovery plutôt que de frustrer les joueurs qui essaient de le rejoindre.

NOTE - La première version de Discovery est volontairement minimaliste. Les listings se composent d'un nom, d'une description et de tags, sans icônes personnalisées, bannières ni contenu enrichi. Il n'y a pas non plus de nombre de joueurs en direct ni de notation, ce que l'équipe a délibérément omis pour que les serveurs ne puissent pas les falsifier ou les manipuler.

Politiques des opérateurs de serveur

Hypixel Studios publie des Server Operator Policies qui s'appliquent à quiconque héberge un serveur Hytale, pas seulement aux serveurs référencés. Elles méritent d'être lues attentivement si vous comptez faire tourner quelque chose de public. Les points essentiels :

• Des règles de base s'appliquent à tout opérateur. Les serveurs référencés dans Discovery ont des obligations supplémentaires en plus.
• Les serveurs référencés doivent fournir des informations d'opérateur vérifiées, un objectif de réponse de 24 heures pour les signalements de sécurité urgents lorsque cela est raisonnablement possible, des minimums techniques et de qualité, ainsi qu'une auto-évaluation du contenu précise avec des contrôles parentaux.
• Interdit sur tous les serveurs : contenu sexuel, NFT, systèmes blockchain ou crypto exploitatifs, et jeux d'argent réel. Accepter la cryptomonnaie comme moyen de paiement est autorisé.
• Les serveurs référencés doivent prendre en charge les cosmétiques officiels, avec des surcharges de thème limitées autorisées si elles sont déclarées.

Monétisation et partage des revenus

Si vous encaissez de l'argent pour quoi que ce soit sur votre serveur, cette section vous concerne.

• La monétisation doit être honnête et légale. Les serveurs All Ages ne peuvent afficher que des publicités adaptées à toute la famille. Les serveurs Teen, mature et adulte doivent divulguer les achats qui affectent le gameplay.
• Les objets aléatoires payants doivent publier des probabilités numériques, une divulgation du « coût attendu », et conserver des registres pendant douze mois. Les achats aléatoires doubles sont totalement interdits.
• Le partage des revenus s'applique à tous les serveurs monétisés, et il est de 0 % pendant les deux premières années, jusqu'au 13 janvier 2028.

Ce dernier point est une véritable échéance à noter dans votre calendrier si vous construisez quelque chose de commercial.

NOTE - Lorsque ces politiques entrent en conflit avec l'EULA ou les Conditions d'utilisation de Hytale, l'EULA et les CGU prévalent, sauf lorsque les politiques sont explicitement désignées comme des Conditions Supplémentaires pour les serveurs listés.

Redirection de ports

Hytale n'a pas publié de port serveur par défaut dans sa documentation publique, donc vérifiez la configuration de votre propre serveur plutôt que de vous fier à un numéro trouvé ailleurs.

La démarche générale est la même que pour n'importe quel serveur de jeu :

1. Trouvez le port sur lequel votre serveur écoute, dans sa configuration ou sa sortie de démarrage.
2. Redirigez-le sur votre routeur vers l'adresse IP interne de la machine serveur.
3. Autorisez-le à travers le pare-feu du système d'exploitation.

# Debian/Ubuntu with ufw, substituting your actual port
sudo ufw allow <port>/tcp

# Fedora/RHEL with firewalld
sudo firewall-cmd --permanent --add-port=<port>/tcp
sudo firewall-cmd --reload

La vérification de domaine pour Discovery utilise un enregistrement DNS TXT plutôt que quelque chose orienté réseau, donc cette partie ne nécessite aucun port ouvert.

Maintenir le serveur actif sous Linux

Une fois que vous avez une commande de démarrage fonctionnelle, encapsulez-la pour qu'elle survive aux déconnexions et aux redémarrages.

La version rapide avec screen :

screen -S hytale ./start.sh

Détachez-vous avec CTRL + A puis D, rattachez-vous avec screen -r hytale.

La version propre, en tant qu'unité systemd à /etc/systemd/system/hytale.service :

[Unit]
Description=Hytale Dedicated Server
After=network.target

[Service]
Type=simple
User=hytale
WorkingDirectory=/home/hytale/server
ExecStart=/home/hytale/server/start.sh
Restart=on-failure
RestartSec=15
KillSignal=SIGINT
TimeoutStopSec=120

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now hytale

KillSignal=SIGINT et un TimeoutStopSec généreux laissent au serveur le temps de sauvegarder le monde à l'arrêt plutôt que d'être tué en pleine écriture. Cela compte plus qu'il n'y paraît.

Suivez le journal avec journalctl -u hytale -f.

Sauvegardes

Hytale ne propose pas de système de sauvegarde automatique comme le fait Valheim, alors considérez les sauvegardes comme votre responsabilité.

Sauvegardez l'intégralité du répertoire de données du serveur, mondes et mods inclus, selon un planning régulier. Une tâche cron avec rsync ou tar vers un autre disque suffit amplement :

0 */6 * * * tar czf /backups/hytale-$(date +\%Y\%m\%d-\%H\%M).tar.gz /home/hytale/server/UserData

Deux raisons spécifiques à Hytale font que cela compte plus que d'habitude :

• Accès anticipé. Les mises à jour arrivent chaque semaine pendant la pré-version et les choses cassent réellement.
• Les mods écrivent dans les mondes. Retirer un mod qui a ajouté des blocs ou des entités peut laisser un monde dans un mauvais état, exactement comme dans n'importe quel jeu de blocs.

Sauvegardez avant chaque mise à jour, pas seulement selon un planning.

Écrire vos propres plugins

Si vous comptez gérer un serveur sérieusement, vous finirez par écrire quelque chose pour lui.

Les plugins Hytale sont en Java, et la documentation de la Server API est générée depuis le serveur lui-même, couvrant les paquets sous com.hypixel.hytale. La référence des assets documente le format JSON de chaque asset chargé par le serveur, généré depuis les codecs propres au serveur.

Deux points à connaître concernant la direction prise :

• Il n'y a aucun scripting textuel et il n'y en aura pas. Le studio a soutenu que le scripting à la Lua est un faux compromis qui oblige les programmeurs à jongler entre deux langages tandis que les designers apprennent encore à programmer.
• Le scripting visuel est le plan retenu à la place, dans l'esprit des Blueprints d'Unreal, les programmeurs pouvant l'étendre en exposant de nouveaux nodes depuis Java. L'outil Trigger Volume sorti avec l'Update 5 en est un premier élément, et il a été explicitement conçu avec un support pour les mods afin que les moddeurs puissent ajouter leurs propres effets.

Dépannage

Je ne trouve pas le téléchargement du serveur dédié. Comme évoqué plus haut, il n'existe pas encore de guide officiel de mise en place d'un serveur autonome. Consultez accounts.hytale.com et demandez sur le Discord officiel.

Mon annonce n'apparaît pas dans Discovery. Vérifiez son statut sur la fiche d'annonce. Elle est peut-être encore dans la file de modération, ce qui peut être lent lors d'une vague de lancement. Si elle a été acceptée puis a disparu, votre serveur a probablement cessé d'envoyer des heartbeats.

Des joueurs disent avoir besoin de mods pour rejoindre. Ce n'est pas le cas. Le modding Hytale est côté serveur, et quiconque prétend le contraire décrit un autre jeu.

Un réglage de configuration est revenu à sa valeur par défaut après une mise à jour. Lisez les notes de patch. Des clés de configuration ont été renommées et supprimées entre les mises à jour, et une clé renommée signifie que votre valeur est ignorée.

Le serveur ne démarre plus après une mise à jour. Vérifiez la version de Java attendue par la build actuelle, et lisez les notes de patch pour les changements majeurs. Si le problème est apparu juste après l'ajout d'un plugin, retirez-le et testez à nouveau.

Noyau Linux trop ancien. Hytale demande un noyau 6.15 x64. Plusieurs distributions LTS en proposent un plus ancien. Vérifiez avec uname -r.

Puis-je faire tourner un serveur sur macOS ? Le client n'est disponible que sur Apple Silicon sous macOS, et le côté serveur est la partie la moins documentée d'un jeu déjà jeune. Une VM Linux ou un serveur loué est la voie de moindre résistance.

Conclusion

Le modèle de serveur de Hytale est le plus épuré de tous les jeux couverts par ces guides, une fois que l'idée centrale est comprise : chaque monde est un serveur, les mods sont installés une seule fois par l'hôte, et les joueurs rejoignent avec un client vanilla et rien d'autre.

Pour un groupe d'amis, héberger depuis le client avec un code d'invitation suffit véritablement. Pour quelque chose de persistant et public, les parties entièrement documentées aujourd'hui sont Server Discovery et les Server Operator Policies, toutes deux à lire attentivement avant de lancer quoi que ce soit. La mise en place du serveur autonome en elle-même est la pièce qui attend encore une documentation officielle, et le Discord reste la réponse honnête en attendant qu'elle arrive.

Nous réécrirons cette section correctement dès que Hypixel Studios la publiera.

Voir aussi

• Hytale Documentation - Le hub officiel de documentation pour héberger des serveurs et créer des mods.
• Hytale Server API reference - L'API Java, pour les développeurs de plugins.
• Asset reference - Le format JSON de chaque asset chargé par le serveur.
• Server Operator Policies - Lecture obligatoire pour quiconque héberge publiquement.
• Hytale Account Manager - Là où se trouvent les Server Profiles et les listings Discovery.
• Official Server Lists announcement - Le processus complet de Discovery, et la source de cette section.
• Hytale Modding Strategy and Status
• Official Hytale Discord
• Hytale Wiki
• TMC App - Notre propre application, avec un navigateur de serveurs, des graphiques de latence en direct et du RCON. Open source sous GPL-3.0 et encore en développement très précoce, donc l'essayer ou laisser un retour est sincèrement apprécié.

Hytale est en accès anticipé et évolue rapidement, donc ce guide devra être mis à jour plus souvent que la plupart des autres. Si vous trouvez une instruction qui ne correspond plus à ce que vous observez, ou si vous avez mis en place un serveur autonome et pouvez combler les lacunes ci-dessus, merci de le signaler ou d'ouvrir une pull request sur le dépôt GitHub de ce guide. Les contributions à celui-ci en particulier seraient vraiment utiles.

Rejoignez notre serveur Discord si vous avez des questions ou souhaitez de l'aide concernant un serveur ou du modding !