12 min de leituraAtualizado em 25 de julho de 2026Verificado para v1.1.0

Como criar um servidor Eaglercraft

Um caminho atual do Paper local até um endereço WSS acessível pelo navegador.

Resposta rápida: Para o primeiro servidor privado, use o modelo oficial Paper 1.12.2. Em uma rede existente, instale EaglerXServer no Spigot, BungeeCord ou Velocity e publique o listener via HTTPS/WSS. Use Java 17 ou superior.

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.

ObjetivoRotaMotivo
Teste privadoModelo Paper oficialBase compatível
Spigot existentePlugin EaglerXServerMantém o mundo atual e o conjunto de plugins.
Rede de servidoresBungeeCord ou VelocityEncaminha vários backends
Sessão curtaMundo compartilhadoSem 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.

  1. Instale Java 17 ou superior
    Confirme um Java de 64 bits com java -version.
  2. Escolha a rota oficial
    Use o modelo Paper oficial ou o JAR oficial EaglerXServer v1.1.0.
  3. Gere a configuração
    Inicie uma vez, leia a EULA e edite os arquivos gerados.
  4. Configure o listener
    Ajuste WebSocket, limites, compatibilidade e inject_address quando necessário.
  5. Adicione WSS seguro
    Finalize TLS em um proxy reverso e encaminhe WebSocket.
  6. 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.

SintomaCamadaVerificação
Conexão recusadaListenerConfirme que o processo está escutando na porta privada configurada.
Conteúdo mistoTLSTroque ws:// por wss:// e verifique o certificado.
502 / atualização falhouProxyEncaminhe os cabeçalhos WebSocket
Erro de versãoProtocolVerifique a compatibilidade do ViaVersion
Apenas localNAT / DNSTeste externamente
IP do jogador incorretoProxyRevise 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

Somente se permitir gateway WebSocket compatível, plugin ou proxy e tráfego WSS persistente.

O teste local pode ser grátis; um servidor público estável normalmente tem custos.

Não. O mundo compartilhado é uma sessão temporária hospedada por um jogador; o servidor dedicado funciona de forma independente e é melhor para mundos permanentes, plugins, moderação e acesso público.

O endereço público wss:// do gateway, não a porta TCP privada do Paper.

Fontes oficiais

Pronto para testar a conexão?

Monte em privado, valide WSS por outra rede e depois convide jogadores.