Como criar um servidor Eaglercraft
Um caminho atual do Paper local até um endereço WSS acessível pelo navegador.
1. Escolha a configuração certa
Shared World atende uma sessão curta hospedada por um jogador. Um servidor dedicado funciona de forma independente e é melhor para mundo permanente, plugins e moderação.
O modelo oficial Paper reduz etapas para iniciantes. Quem já opera Java pode preservar mundo e plugins ao adicionar EaglerXServer.
| Goal | Route | Reason |
|---|---|---|
| Private test | Modelo Paper oficial | 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. Verifique a versão antes de instalar
Conferido no GitHub em 25 de julho de 2026: EaglerXServer v1.1.0 foi publicado em 7 de maio de 2026. O JAR oficial tem 8.774.817 bytes e exige Java 17 ou superior.
O cliente do navegador continua no update u53; o gateway usa v1.1.0. Baixe somente da release ou do modelo oficial.
3. Entenda o caminho da conexão
O navegador não acessa diretamente o socket TCP do Minecraft. EaglerXServer recebe WebSocket e entrega a sessão ao servidor Java ou proxy. Uma página HTTPS exige WSS.
Mantenha o backend Java privado, finalize TLS em um proxy confiável e use inject_address apenas quando a IP real for necessária.
4. Configure passo a passo
Back up the world and configuration before changing the server.
- Instale Java 17 ou superior
Confirme um Java de 64 bits com java -version. - Escolha a rota oficial
Use o modelo Paper oficial ou o JAR oficial EaglerXServer v1.1.0. - Gere a configuração
Inicie uma vez, leia a EULA e edite os arquivos gerados. - Configure o listener
Ajuste WebSocket, limites, compatibilidade e inject_address quando necessário. - Adicione WSS seguro
Finalize TLS em um proxy reverso e encaminhe WebSocket. - Teste e faça backup
Teste WSS em outra rede e crie um backup restaurável.
5. Configure um endereço WSS seguro
O navegador bloqueia ws:// em páginas HTTPS. Use domínio com certificado válido e encaminhe os cabeçalhos 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.
Teste o hostname público pela rede móvel. localhost não comprova DNS, TLS, firewall ou roteador.
6. Teste e resolva por camada
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. Proteja antes de compartilhar
Um gateway público recebe tráfego automatizado. Autenticação, moderação, atualizações e backups restauráveis são requisitos de lançamento.
- 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.
Perguntas frequentes
Official sources
- EaglerXServer — requisitos e configuração
- EaglerXServer v1.1.0 — verified release
- Modelo Paper oficial — beginner baseline
Pronto para testar a conexão?
Monte em privado, valide WSS por outra rede e depois convide jogadores.