Aller au contenu
Hytale

Installer un serveur Hytale

Hytale fournit un serveur dédié officiel sous forme de HytaleServer.jar (Java 25, au moins 4 Go de mémoire, UDP 5520 en QUIC) qui doit être authentifié par un compte Hytale. Le jeu étant en accès anticipé, vérifiez le manuel officiel du support Hytale ; les détails ci-dessous recoupent le support et des guides d'hébergeurs.

Dernière mise à jour : 09/10/2026

Hytale fournit un serveur dédié officiel sous forme de HytaleServer.jar (Java 25, au moins 4 Go de mémoire, UDP 5520 en QUIC) qui doit être authentifié par un compte Hytale. Le jeu étant en accès anticipé, vérifiez le manuel officiel du support Hytale ; les détails ci-dessous recoupent le support et des guides d'hébergeurs.

Installation pas à pas

  1. Vérifiez la machine : Java 25 (x64/arm64), 4 GB RAM min..

  2. Récupérez les fichiers du serveur : dossier Server (avec HytaleServer.jar) et Assets.zip depuis l'installation du jeu, ou via le Hytale Downloader officiel (connexion par code).

  3. Installez Java 25 et vérifiez avec java -version.

  4. Lancez java -jar HytaleServer.jar --assets Assets.zip ; config.json, logs/ et universe/ sont créés au premier démarrage.

  5. Dans la console, exécutez /auth login device, validez le code sur accounts.hytale.com/device, puis /auth persistence Encrypted.

  6. Éditez config.json serveur arrêté (ServerName, MOTD, Password, MaxPlayers, MaxViewRadius).

  7. Ouvrez les ports 5520/UDP dans le pare-feu et sur la box.

  8. Rejoignez avec l'adresse affichée en haut de la console (IP:5520) ; les enregistrements DNS SRV ne sont pas encore pris en charge, utilisez un enregistrement A.

  9. Configurez le démarrage automatique (tâche planifiée ou service systemd).

  10. Planifiez les sauvegardes de universe/ et les mises à jour.

Prérequis

  • Java 25 (x64 ou arm64) ; au moins 4 Go de mémoire, la distance de vue (MaxViewRadius, 12 chunks conseillés au plus) est le principal poste de RAM
  • Un compte Hytale propriétaire du jeu ; une licence est limitée à 500 serveurs
  • Client et serveur doivent utiliser la même version de protocole

Installation locale (Windows)

Créez un dossier (ex. C:\HytaleServer), copiez-y le dossier Server et Assets.zip depuis %appdata%\Hytale\install\release\package\game\latest, puis lancez la commande. Le serveur sur le même PC que le jeu demande au moins 16 Go de RAM au total.

cd C:\HytaleServer
java -Xms4G -Xmx4G -jar HytaleServer.jar --assets Assets.zip

Installation sur VPS / serveur dédié Linux

Sur Ubuntu/Debian : utilisateur non-root, Java 25 (par exemple Eclipse Temurin 25), puis le Hytale Downloader pour récupérer le serveur (connexion par code, jeton enregistré dans .hytale-downloader-credentials.json ; supprimez ce fichier en cas d'erreur d'authentification). Les options exactes du downloader ne sont pas détaillées ici : lisez son aide.

sudo adduser --disabled-password --gecos "" hytale
sudo -iu hytale
mkdir -p ~/hytale-server && cd ~/hytale-server
java -version   # doit afficher 25 / must show 25
java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zip

Ports à ouvrir

  • 5520/UDP: port de jeu par défaut (QUIC), modifiable avec --bind ; pas de TCP à ouvrir

Pare-feu Linux (ufw)

Sous Ubuntu/Debian, autorisez d'abord SSH pour ne pas vous enfermer dehors, puis les ports du jeu.

sudo ufw allow OpenSSH
sudo ufw allow 5520/udp
sudo ufw enable
sudo ufw status

Pare-feu Windows (netsh)

Dans PowerShell lancé en administrateur (ou « cmd » administrateur) :

netsh advfirewall firewall add rule name="Hytale 5520/UDP" dir=in action=allow protocol=UDP localport=5520

Pare-feu de l'hébergeur et redirection de ports (NAT)

Si le serveur est chez un hébergeur (OVH, Hetzner, Scaleway…), ouvrez les mêmes ports dans son pare-feu réseau (« security group »). Pour un hébergement à domicile, redirigez les ports (NAT) de votre box vers l'IP locale fixe de la machine. Testez depuis l'extérieur (connexion mobile ou ami) : un test depuis votre réseau ne prouve rien.

Démarrage automatique et supervision

Créez /etc/systemd/system/<nom>.service, puis : sudo systemctl daemon-reload && sudo systemctl enable --now <nom>. Logs : journalctl -u <nom> -f.

[Unit]
Description=Hytale server
After=network-online.target
Wants=network-online.target

[Service]
User=hytale
WorkingDirectory=/home/hytale/hytale-server
ExecStart=/usr/bin/java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zip
Restart=on-failure
RestartSec=15

[Install]
WantedBy=multi-user.target

Démarrage automatique sous Windows (tâche planifiée)

Créez une tâche planifiée « Au démarrage » exécutant le script de lancement, avec les droits les plus élevés et « Exécuter même si l'utilisateur n'est pas connecté ».

Mises à jour, sauvegardes et redémarrages

Arrêtez le serveur, relancez Hytale Downloader, puis redémarrez. Sauvegardez universe/ avant chaque mise à jour importante. Le serveur vérifie la présence d'une nouvelle version à chaque démarrage : redémarrer suffit en général. Sauvegardez avant de changer de patchline (release/pre-release) : les mondes d'une pré-version peuvent ne plus s'ouvrir sur une version plus ancienne.

# backup
tar czf ~/backup-$(date +%F).tar.gz -C ~/server universe/

Déclarer et trouver votre serveur

Une fois le serveur public, ajoutez-le sur https://game-rank.com/jeux/hytale (site du propriétaire de cet outil) pour que les joueurs le trouvent, le suivent et votent pour lui.

Dépannage

  • Injoignable depuis l'extérieur mais OK en localhost : pare-feu du système, pare-feu de l'hébergeur ou redirection NAT manquants, ou mauvais protocole (UDP/TCP). Vérifiez chaque couche une par une.
  • Connexion refusée après une mise à jour du jeu : client et serveur doivent avoir la même version. Relancez la mise à jour du serveur puis redémarrez-le.
  • Le serveur se ferme aussitôt : lancez-le depuis une console pour lire l'erreur, vérifiez la RAM libre, le disque et les prérequis logiciels.
  • « Authentification requise » ou connexion perdue au redémarrage : refaites /auth login device et vérifiez /auth persistence (Memory = perdu au redémarrage ; choisissez Encrypted).
  • Mémoire insuffisante ou lag : réduisez MaxViewRadius (/maxviewradius <rayon>) avant d'augmenter la RAM.

Questions fréquentes

Hytale a-t-il un serveur dédié officiel ?
Oui : HytaleServer.jar, documenté par le support Hytale. Le jeu est en accès anticipé, les options et formats (config.json…) peuvent changer.
Pourquoi pas de générateur de config.json ?
Seuls quelques champs (ServerName, MOTD, Password, MaxPlayers, MaxViewRadius, sauvegardes) sont documentés par des tiers, sans schéma officiel : nous ne l'inventons pas. Éditez le fichier généré, serveur arrêté.
Que sauvegarder ?
Le dossier universe/ (mondes et données joueurs), plus config.json et permissions.json.
Peut-on lancer sans compte (mode hors ligne) ?
Des guides mentionnent --auth-mode offline pour du développement ; ce n'est pas la voie normale pour un serveur public. Vérifiez avec --help.

Outils pour votre serveur Hytale

Hytale
HytaleAccès libre
Générez la commande Java de votre serveur Hytale : mémoire, --assets, --bind, mode d'authentification et sauvegardes automatiques.
LancementJavaOuvrir
Documentation
Hytale
HytaleAccès libre
Générez les règles ufw, iptables et Windows (netsh) pour ouvrir les ports de votre serveur Hytale : 5520/UDP.
Pare-feuPortsOuvrir
Documentation