Comment Configurer un Serveur Hytale

Votre guide complet pour créer, configurer et exécuter un serveur Hytale dédié.

Ce Que Vous Apprendrez

Configuration requise et installation de Java

Obtention et exécution des fichiers serveur

Configuration de l'authentification et du pare-feu

Configuration et plugins recommandés

Configuration Requise

Configuration Minimale

4 Go de RAM minimum
Java 25 (nous recommandons Adoptium)
Architecture x64 ou arm64 supportée

Facteurs de Ressources

CPU: Nombre élevé de joueurs/entités
RAM: Grande zone de monde chargée, haute distance de vue

Tip: Surveillez l'utilisation RAM et CPU pendant que le serveur fonctionne. L'utilisation des ressources dépend fortement du comportement des joueurs. Expérimentez avec le paramètre -Xmx de Java pour définir les limites de mémoire.

Étape 1 : Installer Java 25

Télécharger Java 25

Téléchargez et installez Java 25 depuis Adoptium (recommandé).

Vérifier l'Installation

Exécutez cette commande pour confirmer que Java est installé :

java --version

Sortie attendue :

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)

Étape 2 : Obtenir les Fichiers Serveur

Il y a deux façons d'obtenir les fichiers serveur :

Option A : Copier depuis le Launcher

Idéal pour les tests rapides. Trouvez les fichiers dans votre dossier d'installation du launcher :

Windows: %appdata%\Hytale\install\release\package\game\latest

Linux: $XDG_DATA_HOME/Hytale/install/release/package/game/latest

macOS: ~/Application Support/Hytale/install/release/package/game/latest

Copiez le dossier Server et Assets.zip dans votre répertoire serveur.

Recommandé

Option B : Hytale Downloader CLI

Idéal pour les serveurs de production. Facile à maintenir à jour. Téléchargez l'outil CLI et exécutez :

./hytale-downloader # Télécharger la dernière version

./hytale-downloader -print-version # Afficher la version

./hytale-downloader -check-update # Vérifier les mises à jour

Étape 3 : Lancer le Serveur

Commande de Lancement

Démarrez le serveur avec :

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

Le flag -XX:AOTCache utilise le cache AOT pré-entraîné pour des temps de démarrage plus rapides.

Authentifier Votre Serveur

Après le premier lancement, authentifiez votre serveur pour activer les connexions des joueurs :

> /auth login device
===================================================================
DEVICE AUTHORIZATION
===================================================================
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234
===================================================================
Waiting for authorization...

[Complete authorization in browser]

> Authentication successful! Mode: OAUTH_DEVICE

Note: Il y a une limite de 100 serveurs par licence de jeu Hytale.

Changer le Port

Le port par défaut est 5520. Changez-le avec l'argument --bind :

java -jar HytaleServer.jar --assets Assets.zip --bind 3500

Étape 4 : Configurer le Pare-feu

Important: Hytale utilise le protocole QUIC sur UDP (pas TCP). Configurez votre pare-feu et la redirection de port pour UDP uniquement.

Pare-feu Windows

New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

Linux (ufw)

sudo ufw allow 5520/udp

Redirection de Port

Si vous hébergez derrière un routeur, redirigez le port UDP 5520 (ou votre port personnalisé) vers votre machine serveur. La redirection TCP n'est pas nécessaire.

Structure des Fichiers Serveur

Organisation des Répertoires

Répertoires

.cache/ - Cache pour les fichiers optimisés
logs/ - Fichiers de logs du serveur
mods/ - Mods installés
universe/ - Données de sauvegarde du monde et des joueurs

Fichiers de Configuration

config.json - Configuration du serveur
permissions.json - Configuration des permissions
bans.json - Joueurs bannis
whitelist.json - Joueurs en liste blanche

Plugins Recommandés

Installez des mods en téléchargeant des fichiers .zip ou .jar et en les plaçant dans le dossier mods/.

Nitrado:WebServer

Plugin de base pour les applications web et les APIs.

Nitrado:Query

Expose le statut du serveur (nombre de joueurs, etc.) via HTTP.

Nitrado:PerformanceSaver

Limite dynamiquement la distance de vue en fonction de l'utilisation des ressources.

ApexHosting:PrometheusExporter

Expose des métriques détaillées du serveur et de la JVM.

Trucs et Astuces

Distance de Vue

La distance de vue est le principal facteur d'utilisation de la RAM. Nous recommandons de limiter la distance de vue maximale à 12 chunks (384 blocs) pour la performance et le gameplay. La valeur par défaut de Hytale de 384 blocs équivaut approximativement à 24 chunks Minecraft.

Sauvegardes Automatiques

Activez les sauvegardes automatiques avec les arguments en ligne de commande :

java -jar HytaleServer.jar --assets Assets.zip --backup --backup-frequency 30

Désactiver Sentry (Développement)

Lors du développement de plugins, désactivez le rapport d'erreurs Sentry pour éviter de soumettre vos erreurs de développement :

java -jar HytaleServer.jar --assets Assets.zip --disable-sentry

Référence des Commandes

Afficher tous les arguments disponibles :

java -jar HytaleServer.jar --help

Arguments Courants

Argument	Description
--assets <Path>	Répertoire des assets (défaut : ../HytaleAssets)
-b, --bind <Address>	Adresse d'écoute (défaut : 0.0.0.0:5520)
--auth-mode	Mode d'authentification : authenticated ou offline
--backup	Activer les sauvegardes automatiques
--backup-frequency <Int>	Intervalle de sauvegarde en minutes (défaut : 30)
--allow-op	Autoriser les commandes opérateur

Prochaines Étapes

Installer des Plugins

Ajoutez des plugins essentiels pour la modération, l'économie et les fonctionnalités de jeu.

Configurer Votifier

Connectez-vous aux listes de serveurs et récompensez les joueurs qui votent pour votre serveur.

Guide de Modération

Apprenez les meilleures pratiques pour gérer votre communauté serveur.

Lister Votre Serveur

Ajoutez votre serveur à notre répertoire et attirez des joueurs.

Rejoignez la Communauté

Une fois votre serveur prêt, rejoignez ces serveurs dans le classement.

🔥 HYCUBE.GG — #1 Hytale Server

🇩🇪

High-performance Survival + RPG server with fair PvP, zero P2W, active community and long-term progression. We don’t chase short-term hype. We bui...

1 votes

Hyvoxel

🇷🇴

HyVoxel este un server românesc de Hytale, aflat în stadiul BETA, creat pentru jucătorii care caută distracție, competiție și o comunitate activă....

0 votes

Mapletale

🇬🇧

Mapletale - Cozy adventure SMP hosted in the EU region, great for players who want a chill place to hang out and play together 🍁 - Features inclu...

2 votes

Raimu

🇩🇪

Raimu - an actually working Hytale PvP server out now in beta! brought to you by limetta, Raimu is a new Hytale server offering a free-for-all PvP...

17 votes

Browse All Servers