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
Vérifiez la machine : Java 25 (x64/arm64), 4 GB RAM min..
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).
Installez Java 25 et vérifiez avec java -version.
Lancez java -jar HytaleServer.jar --assets Assets.zip ; config.json, logs/ et universe/ sont créés au premier démarrage.
Dans la console, exécutez /auth login device, validez le code sur accounts.hytale.com/device, puis /auth persistence Encrypted.
Éditez config.json serveur arrêté (ServerName, MOTD, Password, MaxPlayers, MaxViewRadius).
Ouvrez les ports 5520/UDP dans le pare-feu et sur la box.
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.
Configurez le démarrage automatique (tâche planifiée ou service systemd).
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.zipInstallation 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.zipPorts à 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 statusPare-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=5520Pare-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.targetDé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.
