Come creare un server Eaglercraft
Un percorso aggiornato da Paper locale a un indirizzo WSS raggiungibile dal browser.

1. Scegliere la configurazione corretta
Shared World è adatto a una sessione breve ospitata da un giocatore. Un server dedicato resta online indipendentemente ed è adatto a mondi persistenti, plugin e moderazione.
Il template Paper ufficiale è il percorso più semplice per iniziare. Un amministratore esistente può conservare mondo e plugin aggiungendo EaglerXServer.
| Goal | Route | Reason |
|---|---|---|
| Private test | Template Paper ufficiale | 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. Verificare la versione prima dell'installazione
Controllo GitHub del 25 luglio 2026: EaglerXServer v1.1.0 è uscito il 7 maggio 2026. Il JAR ufficiale misura 8.774.817 byte e richiede Java 17 o successivo.
Il client browser resta all'update u53, mentre il gateway è v1.1.0. Scarica solo dalla release o dal template ufficiale.

3. Capire il percorso della connessione
Il browser non si collega direttamente al socket TCP Minecraft. EaglerXServer riceve WebSocket e passa la sessione al server Java o al proxy. Una pagina HTTPS richiede WSS.
Mantieni privato il backend Java e termina TLS su un reverse proxy affidabile. Usa inject_address solo se serve l'indirizzo reale.
4. Configurare il server passo per passo
Back up the world and configuration before changing the server.
- Installare Java 17 o successivo
Verifica un ambiente Java 64 bit con java -version. - Scegliere la fonte ufficiale
Usa il template Paper ufficiale o il JAR EaglerXServer v1.1.0 ufficiale. - Generare la configurazione
Avvia una volta, leggi l'EULA e modifica i file creati. - Configurare il listener
Imposta WebSocket, limiti, compatibilità e inject_address se necessario. - Aggiungere WSS sicuro
Termina TLS su un reverse proxy e inoltra WebSocket. - Testare e salvare
Prova WSS da un'altra rete e crea un backup ripristinabile.

5. Configurare un indirizzo WSS sicuro
Il browser blocca ws:// da una pagina HTTPS. Usa dominio e certificato validi e inoltra gli header Upgrade e Connection.
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.
Prova il nome pubblico da una rete esterna. localhost non verifica DNS, TLS o firewall.
6. Testare e risolvere per livello
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. Proteggere prima della condivisione
Un gateway pubblico riceve traffico automatizzato. Autenticazione, moderazione, aggiornamenti e backup ripristinabili vanno preparati prima del lancio.
- 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.
Domande frequenti
Official sources
- EaglerXServer — requisiti e configurazione
- EaglerXServer v1.1.0 — verified release
- Template Paper ufficiale — beginner baseline
Pronto a provare la connessione?
Configura in privato, verifica WSS da un'altra rete e poi invita i giocatori.