Comment créer son serveur Hytale

Vous rêvez de créer un monde persistant pour vous et vos amis, ou d’héberger une expérience de jeu unique pour des milliers de joueurs ? Ce guide vous accompagnera pas à pas dans la création et la configuration de votre propre serveur Hytale personnalisé.

Hytale est conçu pour offrir une flexibilité sans précédent aux créateurs. Maîtriser l’hébergement de votre serveur est la première étape pour débloquer un potentiel de personnalisation illimité, allant des règles de jeu uniques aux mini-jeux complexes et aux mondes générés par les utilisateurs.

Les prérequis

Hardware

Avant de commencer, assurez-vous que votre machine (PC ou dédié) respecte ces points :

Java

La version 25 de Java est indispensable, Hytale ne fonctionnera pas avec une version antérieure.

Astuce : Nous vous recommandons d’installer Adoptium (Temurin) pour obtenir Java 25.

Avec java --version vous pouvez vérifier le version Java installée, par exemple :

openjdk 25.0.1 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS)
OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing)

> /auth login device 
=================================================================== 
AUTORISATION DE L'APPAREIL 
=================================================================== 
Rendez-vous sur : https://accounts.hytale.com/device 
Saisissez le code : ABCD-1234 
Ou rendez-vous sur : https://accounts.hytale.com/device?user_code=ABCD-1234 
=================================================================== 
En attente d'autorisation (expiration dans 900 secondes)... 

[L'utilisateur termine l'autorisation dans le navigateur] 

> Authentification réussie ! Mode : OAUTH_DEVICE

Configuration réseau

Hytale diffère de Minecraft sur un point crucial : il utilise le protocole QUIC sur UDP (et non TCP).

• Port par défaut : 5520 (UDP)
• Règle Pare-feu : Vous devez ouvrir le port 5520 en UDP. Inutile d’ouvrir le TCP.

Commandes rapides pour ouvrir le port :

• Linux (UFW) :
  sudo ufw allow 5520/udp puis sudo ufw reload
• Linux (iptables) :
  sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT
• Windows (PowerShell) :
  New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

Étape 1 : Récupérer les fichiers du serveur

Il existe deux méthodes. Pour un serveur robuste et facile à mettre à jour, la méthode CLI est reine.

Méthode A : Hytale Downloader CLI (recommandé)

Le Hytale Downloader (Linux & Windows) est un outil en ligne de commande qui permet de télécharger les fichiers du serveur et les « assets » (ressources) en utilisant une authentification sécurisée OAuth2.

Pour linux :

1. Préparez le dossier :
   mkdir hytale-server && cd hytale-server
2. Récupérez l’outil :
   wget https://downloader.hytale.com/hytale-downloader.zip
unzip hytale-downloader.zip
chmod +x hytale-downloader-linux-amd64 # Adaptez selon votre OS
3. Lancez le téléchargement :
   Exécutez ./hytale-downloader-linux-amd64.
   
   Le terminal vous demandera d’aller sur oauth.accounts.hytale.com pour autoriser le téléchargement.
   
   Une fois validé, vous obtiendrez l’archive du jeu (ex: 2026.01.13-xxxx.zip).
4. Extraction :
   Dezippez l’archive obtenue. Vous aurez alors un dossier Server/ et un fichier Assets.zip.

Voici la liste des toutes les commandes disponibles sur le hytale downloader :

Méthode B : Manuelle

1. Allez dans le dossier où votre jeu Hytale est installé sur votre PC.
2. Le chemin ressemble généralement à ceci : %appdata%\Hytale\install\release\package\game\latest.
3. Cherchez le dossier nommé « Server » et le fichier « Assets.zip ».
4. Copiez ces deux éléments dans un nouveau dossier tout propre sur votre bureau (nommez-le MonServeurHytale).

Étape 2 : Premier lancement et authentification

Contrairement à d’autres jeux, votre serveur Hytale doit être « lié » à votre compte pour fonctionner. Chaque compte Hytale peut créer jusqu’à 100 serveurs maximum.

Étape 1 : La commande de lancement

1. Dans votre terminal, naviguez dans le dossier Server et lancez le serveur avec cette commande :
   java -jar HytaleServer.jar --assets ../Assets.zip

Étape 2 : Lier le serveur à votre compte

Au premier lancement, le serveur sera en mode « No Server Token Configured ». Il attend votre validation. Regardez la console :

1. Tapez la commande : /auth login device
2. La console affiche un code (ex: ABCD-1234) et une URL.
3. Rendez-vous sur https://accounts.hytale.com/device.
4. Entrez le code.
5. Une fois validé, la console affichera : Authentification réussie ! Mode : OAUTH_DEVICE.

> /auth login device 
=================================================================== 
AUTORISATION DE L'APPAREIL 
=================================================================== 
Rendez-vous sur : https://accounts.hytale.com/device 
Saisissez le code : ABCD-1234 
Ou rendez-vous sur : https://accounts.hytale.com/device?user_code=ABCD-1234 
=================================================================== 
En attente d'autorisation (expiration dans 900 secondes)... 

[L'utilisateur termine l'autorisation dans le navigateur] 

> Authentification réussie ! Mode : OAUTH_DEVICE

> /auth login device 
=================================================================== 
AUTORISATION DE L'APPAREIL 
=================================================================== 
Rendez-vous sur : https://accounts.hytale.com/device 
Saisissez le code : ABCD-1234 
Ou rendez-vous sur : https://accounts.hytale.com/device?user_code=ABCD-1234 
=================================================================== 
En attente d'autorisation (expiration dans 900 secondes)... 

[L'utilisateur termine l'autorisation dans le navigateur] 

> Authentification réussie ! Mode : OAUTH_DEVICE

Optimisation et configuration du lancement

Maintenant que le serveur tourne, il faut le rendre fluide. Tout se joue sur la RAM et la configuration Java.

Allocation de mémoire (RAM)

Java n’utilise pas automatiquement toute la mémoire disponible. Une allocation insuffisante peut provoquer des ralentissements (lag) et des saccades.

java -Xms<taille> -Xmx<taille> -jar HytaleServer.jar ...

• -Xms : Définit l’allocation initiale de la mémoire.
• -Xmx : Définit la limite maximale de mémoire.

Exemple pour 8 Go de RAM :

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

Recommandations :

• Petit serveur : 4 Go
• Serveur moyen : 6-8 Go
• Grand/public : 10-16 Go

Laissez toujours 1 à 2 Go de mémoire libre pour le système d’exploitation.

 Cache Ahead-Of-Time (AOT)

Le serveur Hytale inclut un cache AOT (HytaleServer.aot) qui peut améliorer considérablement les temps de démarrage en sautant la phase de « réchauffement » du JIT (Just-In-Time compilation).

Utilisation :
Ajoutez l’argument suivant à votre commande de démarrage du serveur :

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

Port du serveur

Le port par défaut est 5520. Modifiez-le si nécessaire.

java -jar HytaleServer.jar --assets PathToAssets.zip --bind 0.0.0.0:25565

View distance

La distance d’affichage est le principal facteur de consommation de RAM sur votre serveur.

• Hytale utilise une distance d’affichage par défaut d’environ 384 blocs (12 chunks), ce qui est significativement plus élevé que certains jeux similaires.
• Recommandation : Pour équilibrer performance et gameplay, envisagez de limiter la distance d’affichage maximale à 12 chunks. Ajustez cette valeur en fonction du nombre de joueurs attendus et des ressources de votre serveur.

Pour modifier la valeur, éditez MaxViewRadius dans le config.json général du serveur.

Structure des fichiers

Une fois lancé, votre dossier va se remplir de nouveaux fichiers. Voici les plus importants pour vous :

Attention : Les modifications manuelles de ces fichiers pendant que le serveur est en cours d’exécution peuvent être écrasées. Arrêtez toujours votre serveur avant de modifier ces fichiers.

Pour en découvrir d’avantage sur le structure des fichiers et dossiers de votre serveur, consultez le guide dédié.

Paramètres globaux

Les paramètres les plus courants et de base d’un serveur Hytale sont modifiables dans le fichier config.json :

{
  "Version": 3,
  "ServerName": "Hytale Server",
  "MOTD": "",
  "Password": "",
  "MaxPlayers": 999,
  "MaxViewRadius": 16,
  "LocalCompressionEnabled": false,
  "Defaults": {
    "World": "default",
    "GameMode": "Adventure"
  },
  "ConnectionTimeouts": {
    "JoinTimeouts": {}
  },
  "RateLimit": {},
  "Modules": {},
  "LogLevels": {},
  "Mods": {},
  "DisplayTmpTagsInStrings": false,
  "PlayerStorage": {
    "Type": "Hytale"
  }
}

Il existe également des fichiers de configuration dédiés pour vos mondes et vos mods/plugins. Pour aller plus loin, consultez le guide dédié.

Mises à jour du serveur

Quand une nouvelle version de Hytale est disponible, le Hytale Downloader CLI facilite la mise à jour de votre serveur.

Il est important de s’assurer que le downloader lui-même est à jour avant de l’utiliser pour mettre à jour le serveur :

./hytale-downloader-linux-amd64 -check-update # Ou l'exécutable correspondant à votre OS

Une fois le downloader à jour, vous pouvez procéder à la mise à jour des fichiers du serveur :

1. Arrêter Votre Serveur Hytale :
   Avant toute mise à jour, assurez-vous que votre serveur est complètement arrêté pour éviter la corruption de données.
2. Exécuter le Hytale Downloader :
   Pour télécharger la dernière version du serveur Hytale et les fichiers d’assets associés :
   ./hytale-downloader-linux-amd64 # Ou l'exécutable de votre OS
   
   Le downloader téléchargera l’archive la plus récente (par exemple, 2026.01.13-50e69c385.zip ou 2026.01.15-c04fdfe10.zip) dans votre répertoire actuel.
   
   Il peut utiliser un CACHE_DIRECTORY (.cache/) pour éviter des téléchargements redondants.
3. Extraire les Nouveaux Fichiers :
   unzip [NOM_DE_L_ARCHIVE_TELECHARGEE].zip # Ex: unzip 2026.01.15-c04fdfe10.zip
   
   Cela extraira les dossiers Server/ et le fichier Assets.zip.
   Remplacez les anciens fichiers du serveur par ces nouveaux.
   
   Conseil : Si vous souhaitez télécharger une version spécifique ou un canal de pré-version, utilisez les options :
   • ./hytale-downloader -patchline pre-release
   • ./hytale-downloader -download-path my_custom_server.zip
4. Remplacer les Anciens Fichiers :
   Copiez les nouveaux dossiers Server/ et le fichier Assets.zip extraits dans votre répertoire de serveur principal, en écrasant les versions précédentes.
5. Lancer le Serveur Hytale :
   java -jar Server/HytaleServer.jar --assets Assets.zip
   
   Votre serveur redémarrera avec la nouvelle version. Il est possible que vous deviez refaire une authentification si les jetons ont expiré ou si une nouvelle procédure de sécurité l’exige.
   
   Utilisez /auth login device dans la console du serveur si un avertissement (NO SERVER TOKENS CONFIGURED) apparaît.

Devenir administrateur du serveur

Pour vous donner les droits d’administrateur du serveur, rendez-vous sur notre guide dédié.

Mods et plugins recommandés

Hytale promet un univers de possibilités infinies, et une grande partie de cette promesse repose sur ses outils de modding, en particulier les plugins.

Contrairement aux « mods » traditionnels de certains jeux, les plugins Hytale sont conçus pour s’intégrer de manière transparente à l’architecture du serveur

Où trouver vos mods et plugins Hytale ?

La première étape est de trouver des mods et plugins fiables.

• CurseForge : C’est la plateforme de référence pour les mods Hytale (ainsi que pour d’autres jeux). Vous y trouverez une vaste sélection de Packs et Plugins : https://www.curseforge.com/hytale
• Modtale : Un autre répertoire communautaire émergent pour découvrir du contenu Hytale : https://modtale.net/
• GitHub / Communautés : Certains développeurs publient leurs projets directement sur GitHub ou les partagent via les serveurs Discord dédiés au modding Hytale.

Conseil de Pro : 
Avant de télécharger, vérifiez toujours la description du mod pour la compatibilité (version de Hytale) et les dépendances requises.

Téléchargez toujours depuis des sources fiables pour éviter les logiciels malveillants

Installation de mods / plugins

Les plugins Java (.jar) s’installent côté serveur. Les étapes varient légèrement selon que vous utilisez un serveur hébergé ou que vous hébergez le vôtre.

1. Arrêtez votre serveur pour éviter la corruption des fichiers pendant le transfert.
2. Naviguez dansle dossier mods/ . C’est ici que les plugins sont stockés.
3. Uploadez le fichier .jar de votre plugin.
4. Démarrez votre serveur. Le plugin sera automatiquement chargé au démarrage.
5. Configurez le plugin : au lancement, un fichier config.json a été créé dans le répertoire mods/nomduplugin/

Plugins recommandés

Voici quelques plugins recommandés pour vos serveurs :

Modérer son serveur: kick & ban

Hytale rend la gestion des joueurs simple grâce à trois commandes essentielles : kick, ban et unban.

Pour bannir ou débannir un joueur de votre serveur :

• /ban <player_name_or_uuid>
• /unban <player_name_or_uuid>

Pour kicker un joueur :

/kick <player_name_or_uuid>

Sécuriser l’accès au serveur avec la whitelist

Pour sécuriser l’accès à votre serveur, vous pouvez utiliser une whitelist.

Pour la mettre en place, consultez ce guide complet.