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
Shared World 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.
| Goal | Route | Reason |
|---|---|---|
| Private test | Modèle Paper officiel | Compatible baseline |
| Existing Spigot | EaglerXServer plugin | Keep world and plugins |
| Server network | BungeeCord or Velocity | Route several backends |
| Short session | Shared World | No dedicated administration |
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
Back up the world and configuration before changing the server.
- 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.
Home connections may require router forwarding and may be behind carrier-grade NAT. Use a host that supports persistent WebSockets when inbound access is unavailable.
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
Change one layer at a time and inspect browser, reverse-proxy, and server logs.
| Symptom | Layer | Check |
|---|---|---|
| Connection refused | Listener | Confirm the private port |
| Mixed content | TLS | Use wss:// and a valid certificate |
| 502 / upgrade failed | Proxy | Forward WebSocket headers |
| Version error | Protocol | Check ViaVersion compatibility |
| Local only | NAT / DNS | Test externally |
| Wrong player IP | Proxy | Review 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.
- Use authentication or a whitelist.
- Run as a non-administrator and expose only required ports.
- Rate-limit the gateway and keep admin panels private.
- Back up worlds, plugins, and configuration, then test restoration.
- Use official releases and keep a rollback copy.
Questions fréquentes
Official sources
- EaglerXServer — prérequis et configuration
- EaglerXServer v1.1.0 — verified release
- Modèle Paper officiel — beginner baseline
Prêt à tester la connexion ?
Construisez en privé, validez WSS depuis un autre réseau, puis invitez les joueurs.