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
O mundo compartilhado atende a uma sessão curta hospedada por um jogador. Um servidor dedicado funciona de forma independente e é melhor para mundos permanentes, plugins e moderação.
O modelo oficial Paper reduz etapas para iniciantes. Quem já opera Java pode preservar mundo e plugins ao adicionar EaglerXServer.
| Objetivo | Rota | Motivo |
|---|---|---|
| Teste privado | Modelo Paper oficial | Base compatível |
| Spigot existente | Plugin EaglerXServer | Mantém o mundo atual e o conjunto de plugins. |
| Rede de servidores | BungeeCord ou Velocity | Encaminha vários backends |
| Sessão curta | Mundo compartilhado | Sem administração dedicada |
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
Faça backup de qualquer mundo existente antes. Trabalhe em uma pasta nova e mantenha uma cópia de cada configuração alterada.
- 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.
Conexões domésticas podem exigir encaminhamento de portas e estar atrás de NAT de nível de operadora. Use um host com WebSockets persistentes quando não houver acesso de entrada.
Teste o hostname público pela rede móvel. localhost não comprova DNS, TLS, firewall ou roteador.
6. Teste e resolva por camada
Altere uma camada por vez e leia os logs do proxy reverso e do servidor. O console do navegador ajuda a diferenciar falhas de TLS e WebSocket de falhas do protocolo Minecraft.
| Sintoma | Camada | Verificação |
|---|---|---|
| Conexão recusada | Listener | Confirme que o processo está escutando na porta privada configurada. |
| Conteúdo misto | TLS | Troque ws:// por wss:// e verifique o certificado. |
| 502 / atualização falhou | Proxy | Encaminhe os cabeçalhos WebSocket |
| Erro de versão | Protocol | Verifique a compatibilidade do ViaVersion |
| Apenas local | NAT / DNS | Teste externamente |
| IP do jogador incorreto | Proxy | Revise 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 uma lista de permissões ou um plugin de autenticação para comunidades privadas.
- Execute o serviço com uma conta sem privilégios de administrador e exponha apenas as portas necessárias.
- Limite a taxa do gateway público e mantenha os painéis de administração privados.
- Faça backup dos mundos, plugins e configurações; teste a restauração.
- Consulte as versões oficiais antes de atualizar e mantenha uma cópia para rollback.
Perguntas frequentes
Fontes oficiais
- EaglerXServer — requisitos e configuração
- EaglerXServer v1.1.0 — publicação verificada
- Modelo Paper oficial — base para iniciantes
Pronto para testar a conexão?
Monte em privado, valide WSS por outra rede e depois convide jogadores.