Comment créer un serveur Eaglercraft
Une méthode actuelle, de Paper en local à une adresse WSS utilisable dans le navigateur.
1. Choisir la bonne architecture
Le monde partagé convient à une session courte hébergée par un joueur. Un serveur dédié reste actif sans l'hôte et convient aux mondes persistants, plugins et outils de modération.
Le modèle Paper officiel réduit les réglages pour débuter. Un administrateur existant peut conserver son monde et ajouter EaglerXServer à sa pile.
| Objectif | Parcours | Raison |
|---|---|---|
| Test privé | Modèle Paper officiel | Base compatible |
| Spigot existant | Plugin EaglerXServer | Conserve le monde actuel et l’ensemble des plugins. |
| Réseau de serveurs | BungeeCord ou Velocity | Achemine plusieurs backends |
| Session courte | Monde partagé | Pas d'administration dédiée |
2. Vérifier la version avant l'installation
Vérification GitHub du 25 juillet 2026 : EaglerXServer v1.1.0 a été publié le 7 mai 2026. Le JAR officiel pèse 8 774 817 octets et nécessite Java 17 ou supérieur.
Le client navigateur reste en mise à jour u53, tandis que la passerelle est en v1.1.0. Téléchargez uniquement depuis la release ou le modèle officiels.
3. Comprendre le trajet de la connexion
Le navigateur ne parle pas directement au socket TCP Minecraft. EaglerXServer reçoit WebSocket et transmet la session au serveur Java ou au proxy. Une page HTTPS exige WSS.
Gardez le backend Java privé et terminez TLS sur un reverse proxy fiable. N'activez inject_address que pour transmettre l'adresse réelle.
4. Installer le serveur étape par étape
Sauvegardez d’abord tout monde existant. Travaillez dans un nouveau dossier et gardez une copie de chaque configuration modifiée.
- Installer Java 17 ou plus
Vérifiez un environnement Java 64 bits avec java -version. - Choisir la voie officielle
Utilisez le modèle Paper officiel ou le JAR EaglerXServer v1.1.0 officiel. - Générer la configuration
Démarrez une fois, lisez l'EULA puis modifiez les fichiers créés. - Configurer le listener
Réglez WebSocket, limites, compatibilité et inject_address si nécessaire. - Ajouter WSS sécurisé
Terminez TLS sur un reverse proxy et transmettez WebSocket. - Tester et sauvegarder
Testez WSS depuis un autre réseau et créez une sauvegarde restaurable.
5. Configurer une adresse WSS sécurisée
Un navigateur bloque ws:// depuis une page HTTPS. Utilisez un domaine et un certificat valides, avec les en-têtes Upgrade et Connection transmis.
Les connexions domestiques peuvent nécessiter une redirection de ports et être derrière un NAT opérateur. Utilisez un hébergeur prenant en charge les WebSockets persistants si les connexions entrantes sont impossibles.
Testez le nom public depuis un réseau externe. Un test localhost ne valide ni DNS, ni TLS, ni le pare-feu.
6. Tester et diagnostiquer par couche
Ne modifiez qu’une couche à la fois et consultez les journaux du reverse proxy et du serveur. La console du navigateur aide à distinguer les erreurs TLS et WebSocket des erreurs du protocole Minecraft.
| Symptôme | Couche | Vérification |
|---|---|---|
| Connexion refusée | Listener | Vérifiez que le processus écoute sur le port privé configuré. |
| Contenu mixte | TLS | Remplacez ws:// par wss:// et vérifiez le certificat. |
| 502 / échec de la mise à niveau | Proxy | Transférez les en-têtes WebSocket |
| Erreur de version | Protocol | Vérifiez la compatibilité de ViaVersion |
| Local uniquement | NAT / DNS | Testez depuis l'extérieur |
| Mauvaise IP du joueur | Proxy | Vérifiez inject_address |
7. Sécuriser avant de partager
Une passerelle publique reçoit du trafic automatisé. Préparez authentification, modération, mises à jour et sauvegardes restaurables avant l'ouverture.
- Utilisez une liste blanche ou un plugin d’authentification pour les communautés privées.
- Exécutez le service avec un compte sans droits administrateur et n’exposez que les ports nécessaires.
- Limitez le débit de la passerelle publique et gardez les panneaux d’administration privés.
- Sauvegardez les mondes, les plugins et la configuration ; effectuez un test de restauration.
- Consultez les versions officielles avant une mise à jour et gardez une copie de retour arrière.
Questions fréquentes
Sources officielles
- EaglerXServer — prérequis et configuration
- EaglerXServer v1.1.0 — version publiée et vérifiée
- Modèle Paper officiel — base pour débutants
Prêt à tester la connexion ?
Construisez en privé, validez WSS depuis un autre réseau, puis invitez les joueurs.