12 min di letturaAggiornato il 25 luglio 2026Verificato per v1.1.0

Come creare un server Eaglercraft

Un percorso aggiornato da Paper locale a un indirizzo WSS raggiungibile dal browser.

Risposta rapida: Per il primo server privato usa il template ufficiale Paper 1.12.2. In una rete esistente aggiungi EaglerXServer a Spigot, BungeeCord o Velocity e pubblica il listener tramite HTTPS/WSS con Java 17 o successivo.

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.

GoalRouteReason
Private testTemplate Paper ufficialeCompatible baseline
Existing SpigotEaglerXServer pluginKeep world and plugins
Server networkBungeeCord or VelocityRoute several backends
Short sessionShared WorldNo 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.

  1. Installare Java 17 o successivo
    Verifica un ambiente Java 64 bit con java -version.
  2. Scegliere la fonte ufficiale
    Usa il template Paper ufficiale o il JAR EaglerXServer v1.1.0 ufficiale.
  3. Generare la configurazione
    Avvia una volta, leggi l'EULA e modifica i file creati.
  4. Configurare il listener
    Imposta WebSocket, limiti, compatibilità e inject_address se necessario.
  5. Aggiungere WSS sicuro
    Termina TLS su un reverse proxy e inoltra WebSocket.
  6. 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.

SymptomLayerCheck
Connection refusedListenerConfirm the private port
Mixed contentTLSUse wss:// and a valid certificate
502 / upgrade failedProxyForward WebSocket headers
Version errorProtocolCheck ViaVersion compatibility
Local onlyNAT / DNSTest externally
Wrong player IPProxyReview 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

Solo se consente un gateway WebSocket compatibile, plugin o proxy e traffico WSS persistente.

Il test locale può esserlo, ma un server pubblico stabile normalmente comporta costi.

No. Shared World è una sessione temporanea ospitata da un giocatore; il server dedicato è indipendente.

L'indirizzo pubblico wss:// del gateway, non la porta TCP privata di Paper.

Official sources

Pronto a provare la connessione?

Configura in privato, verifica WSS da un'altra rete e poi invita i giocatori.