Installer un serveur Hytale dédié sur Linux (Java 25 + Hytale Downloader)

Hytale est sorti en Early Access le 13 janvier 2026 et Hypixel Studios distribue un serveur dédié officiel dès le jour 1. Ce guide couvre l’installation complète sur Linux Ubuntu/Debian — depuis le Hytale Downloader jusqu’à votre premier joueur connecté. Toutes les commandes sont vérifiées contre le Hytale Server Manual officiel.

Pas envie de gérer Java, le downloader et les mods ? Louez un serveur Hytale chez HebergTonServ — installation auto, panel intuitif et support 24/7 dès 9,90€/mois.

Pré-requis matériels

Hytale tourne sur Java 25 et utilise QUIC sur UDP (pas TCP comme Minecraft).

Étape 1 — Installer Java 25

Hytale exige Java 25 (OpenJDK ou Oracle JDK).

Ubuntu 22.04 / 24.04

sudo apt update
sudo apt install -y wget gnupg apt-transport-https

# Adoptium (Eclipse Temurin OpenJDK 25)
wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo gpg --dearmor -o /usr/share/keyrings/adoptium.gpg
echo "deb [signed-by=/usr/share/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb $(awk -F= '/VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list

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

Sortie attendue :

openjdk version "25" 2026-01-15

Étape 2 — Créer un utilisateur dédié

sudo useradd -m -s /bin/bash hytale
sudo su - hytale
mkdir ~/hytale-server && cd ~/hytale-server

Tout ce qui suit s’exécute en tant qu’utilisateur hytale.

Étape 3 — Télécharger le Hytale Downloader

Le Hytale Downloader est un outil CLI fourni par Hypixel Studios pour récupérer les fichiers serveur et les assets.

cd ~/hytale-server
wget https://download.hytale.com/HytaleDownloader-linux.tar.gz
tar -xvzf HytaleDownloader-linux.tar.gz
ls
# HytaleDownloader  QUICKSTART.md  README.md

Le lien exact peut évoluer — consultez https://hytale.com/server pour la dernière URL.

Étape 4 — Télécharger les fichiers serveur + assets

./HytaleDownloader

L’outil vous demande :

1. Server version → latest (recommandé)
2. Download assets → yes
3. Output directory → ./server

À la fin vous obtenez :

~/hytale-server/server/
├── HytaleServer.jar          ← exécutable serveur
├── Assets.zip                ← assets (textures, modèles, sons)
├── config.json               ← config principale (généré au 1er run)
├── permissions.json          ← permissions joueurs (généré au 1er run)
└── mods/                     ← dossier mods (.jar)

L’archive complète fait environ 3 Go. Patientez selon votre connexion.

Étape 5 — Ouvrir le port réseau

Hytale utilise QUIC sur UDP (pas TCP). Port par défaut : 5520.

sudo ufw allow 5520/udp
sudo ufw reload

Pas de TCP nécessaire — Hytale fonctionne uniquement en UDP. Forwardez UDP 5520 sur votre routeur.

Étape 6 — Premier démarrage

cd ~/hytale-server/server
java -jar HytaleServer.jar --assets ./Assets.zip --bind 0.0.0.0:5520

Le serveur génère config.json et permissions.json. Attendez le message :

[INFO] Server ready on 0.0.0.0:5520 (QUIC/UDP)

Arrêtez avec Ctrl+C proprement.

Étape 7 — Personnaliser config.json

nano config.json

Exemple :

{
  "server-name": "Mon Serveur Hytale FR",
  "motd": "Bienvenue ! Communaute FR, RP encourage.",
  "max-players": 20,
  "port": 5520,
  "bind-address": "0.0.0.0",
  "world": {
    "name": "Adelphos",
    "seed": "12345678",
    "type": "default"
  },
  "difficulty": "normal",
  "pvp": true,
  "online-mode": true,
  "view-distance": 16,
  "spawn-protection": 16
}

Paramètres clés

Attention : modifier config.json pendant que le serveur tourne fait écraser vos changements au prochain save. Arrêtez le serveur, modifiez, relancez.

Étape 8 — Configurer permissions.json

permissions.json gère les groupes et les permissions joueurs.

{
  "groups": {
    "admin": {
      "permissions": ["*"]
    },
    "moderator": {
      "permissions": ["command.kick", "command.ban", "command.mute"]
    },
    "default": {
      "permissions": ["command.help", "command.spawn"]
    }
  },
  "users": {
    "VotreNomDeJoueur": {
      "groups": ["admin"]
    },
    "Modo1": {
      "groups": ["moderator"]
    }
  }
}

"*" = toutes les permissions. Le wildcard est réservé aux admins de confiance.

Étape 9 — Lancement avec heap Java optimisé

Pour 20 joueurs avec mods, 4 Go de heap Java suffisent :

java -Xms2G -Xmx4G \
  -XX:+UseG1GC \
  -XX:+ParallelRefProcEnabled \
  -XX:MaxGCPauseMillis=200 \
  -jar HytaleServer.jar \
  --assets ./Assets.zip \
  --bind 0.0.0.0:5520

Flags Java

Étape 10 — Service systemd

/etc/systemd/system/hytale.service :

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

[Service]
Type=simple
User=hytale
WorkingDirectory=/home/hytale/hytale-server/server
ExecStart=/usr/bin/java -Xms2G -Xmx4G -XX:+UseG1GC -jar HytaleServer.jar --assets ./Assets.zip --bind 0.0.0.0:5520
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now hytale
sudo journalctl -u hytale -f

Étape 11 — Installer des mods

Hytale supporte les mods/plugins Java (.jar) dans le dossier mods/.

cd ~/hytale-server/server/mods
wget https://example.com/MonPlugin.jar

Redémarrez le serveur — le plugin est chargé au boot.

Les mods Hytale fonctionnent server-side first : les joueurs n’ont pas besoin d’installer le mod côté client (sauf assets visuels).

Sources de mods :

• https://hytale-mods.com (communauté)
• https://mods.hytale.com (officiel, post-launch)
• CurseForge dès lancement officiel des hooks Hytale

Étape 12 — Mettre à jour le serveur

Re-lancez le Hytale Downloader pour récupérer la dernière version :

cd ~/hytale-server
./HytaleDownloader --update

Avant chaque update, sauvegardez votre dossier worlds/ (mondes), config.json et permissions.json.

FAQ

Quelle version de Java pour Hytale ?

Java 25 exclusivement. Java 21 ou inférieur ne fonctionne pas — Hytale utilise des fonctionnalités JDK 25+ (Pattern Matching, Scoped Values).

TCP ou UDP pour Hytale ?

UDP uniquement via le protocole QUIC. Hytale n’utilise pas TCP comme Minecraft Java Edition. Forwardez UDP 5520 sur votre routeur.

Combien de RAM pour mon serveur Hytale ?

4 Go heap Java (-Xmx4G) pour 20 joueurs vanilla. Pour mods lourds + 50 joueurs, prévoyez 8 Go heap (donc 10-12 Go RAM système).

Différence avec Minecraft ?

Hytale supporte les mods server-side first : les joueurs rejoignent un serveur modé sans installer quoi que ce soit côté client. C’est une grosse différence vs Bukkit/Spigot.

Mon serveur n’apparaît pas dans le browser Hytale

Vérifiez : online-mode=true, port UDP 5520 ouvert, bind-address=0.0.0.0, et le serveur authentifié auprès du système Mojang/Hypixel.

Erreur “UnsupportedClassVersionError”

Vous utilisez une version de Java trop ancienne. Désinstallez Java ≤21 et installez Java 25 (Eclipse Temurin recommandé).

server.properties ou config.json ?

Hytale utilise config.json (JSON) et permissions.json au lieu du server.properties de Minecraft. Format différent, paramètres similaires.

Conclusion

Vous avez maintenant un serveur Hytale dédié opérationnel sur Linux avec Java 25 et le Hytale Downloader. Étapes suivantes recommandées :

1. Configurer permissions.json avec votre équipe modo
2. Installer des mods server-side dans mods/
3. Programmer des backups du dossier worlds/ via cron
4. Maîtriser les commandes — voir Commandes admin Hytale

Pas envie de gérer Java 25, le downloader et les mods ? HebergTonServ installe votre serveur Hytale en moins de 5 minutes — Ryzen 9 5950X, Java 25 pré-configuré, Anti-DDoS 5 Tbps et support 24/7 dès 9,90€/mois.

Pour aller plus loin

• Hébergeur Hytale dès 9,90€/mois
• Commandes admin Hytale
• Hytale Server Manual officiel (Hypixel Studios)
• Hytale Modding Strategy