Come creare un server Eaglercraft
Un percorso aggiornato da Paper locale a un indirizzo WSS raggiungibile dal browser.
1. Scegliere la configurazione corretta
Il mondo condiviso è 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.
| Obiettivo | Percorso | Motivo |
|---|---|---|
| Test privato | Template Paper ufficiale | Base compatibile |
| Spigot esistente | Plugin EaglerXServer | Conserva il mondo attuale e l’insieme dei plugin. |
| Rete di server | BungeeCord o Velocity | Instrada più backend |
| Sessione breve | Mondo condiviso | Senza amministrazione dedicata |
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
Fai prima un backup di ogni mondo esistente. Lavora in una nuova cartella e conserva una copia di ogni configurazione modificata.
- 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.
Le connessioni domestiche possono richiedere il port forwarding ed essere dietro un NAT dell'operatore. Usa un host che supporti WebSocket persistenti quando le connessioni in ingresso non sono disponibili.
Prova il nome pubblico da una rete esterna. localhost non verifica DNS, TLS o firewall.
6. Testare e risolvere per livello
Modifica un solo livello alla volta e leggi i log del reverse proxy e del server. La console del browser aiuta a distinguere gli errori TLS e WebSocket dagli errori del protocollo Minecraft.
| Sintomo | Livello | Controllo |
|---|---|---|
| Connessione rifiutata | Listener | Verifica che il processo sia in ascolto sulla porta privata configurata. |
| Contenuto misto | TLS | Sostituisci ws:// con wss:// e verifica il certificato. |
| 502 / aggiornamento fallito | Proxy | Inoltra gli header WebSocket |
| Errore di versione | Protocol | Controlla la compatibilità di ViaVersion |
| Solo in locale | NAT / DNS | Prova dall'esterno |
| IP del giocatore errato | Proxy | Controlla inject_address |
7. Proteggere prima della condivisione
Un gateway pubblico riceve traffico automatizzato. Autenticazione, moderazione, aggiornamenti e backup ripristinabili vanno preparati prima del lancio.
- Usa una whitelist o un plugin di autenticazione per le community private.
- Avvia il servizio con un account non amministratore ed esponi solo le porte necessarie.
- Limita la frequenza del gateway pubblico e mantieni privati i pannelli di amministrazione.
- Esegui il backup di mondi, plugin e configurazione; prova il ripristino.
- Controlla le release ufficiali prima di aggiornare e conserva una copia per il rollback.
Domande frequenti
Fonti ufficiali
- EaglerXServer — requisiti e configurazione
- EaglerXServer v1.1.0 — versione pubblicata e verificata
- Template Paper ufficiale — base per principianti
Pronto a provare la connessione?
Configura in privato, verifica WSS da un'altra rete e poi invita i giocatori.