L2 Server Errors Fix: sete falhas de instalação e suas causas reais

O l2 server errors fix mais rápido é ler a classe da exceção antes de abrir um arquivo de configuração. Um servidor que morre durante o boot e um servidor que sobe para um mundo vazio falham em camadas diferentes, e a mensagem quase sempre nomeia a camada: a JVM, a conexão JDBC, o handshake do login ou o cliente. As falhas abaixo são as que mais aparecem em instalações de L2J, L2JMobius e aCis. Cada entrada é o erro que você vê, o que realmente o causa e o arquivo, porta ou comando específico que resolve.
Java não é reconhecido como comando
No Windows o shell diz java is not recognized as an internal or external command, operable program or batch file. No Linux diz java: command not found. As duas significam a mesma coisa: não há nenhum JDK instalado, ou há um instalado e nem JAVA_HOME nem PATH apontam para ele. O guia de instalação começa aqui por um motivo. Nada depois deste passo pode funcionar.
Instale um build do OpenJDK e depois aponte o ambiente para a raiz do JDK, não para a pasta bin dentro dela.
- Defina
JAVA_HOMEpara o diretório do JDK, por exemploC:\Program Files\Eclipse Adoptium\jdk-25. - Adicione
%JAVA_HOME%\binaoPATHno Windows, ou$JAVA_HOME/binno Linux. - Abra um terminal novo. Mudanças de ambiente não chegam a um shell que já estava rodando.
- Confira os dois comandos,
java -versionejavac -version. Se só um funciona, você instalou um JRE e o build vai falhar depois.
O Windows tem uma instalação de uma linha se você usa winget: winget install EclipseAdoptium.Temurin.25.JDK. Ajuste a versão maior ao seu pack antes de rodar, que é o assunto da terceira seção.

O game server morre com um erro de banco de dados
O console imprime Couldn't init DB connection, ou o driver informa Unknown database 'l2jdb', e o processo encerra algumas linhas depois. O mundo nunca sobe. Existem cinco causas comuns e nenhuma exótica.
- O nome do banco aparece duas vezes na URL JDBC. Uma URL como
jdbc:mariadb://localhost:3306/l2jdb/l2jdbé interpretada como um banco chamadol2jdb/l2jdb. Mantenha um único segmento depois da porta. - O nome do banco está errado. O L2J vem esperando
l2jdb, mas um dump restaurado ou um schema renomeado deixam a configuração apontando para um nome que não existe mais. - O usuário ou a senha estão errados. A conta que o game server usa não é a conta root do MySQL. Teste com as credenciais exatas da configuração em um cliente como o HeidiSQL antes de culpar o servidor.
- O banco nunca foi criado. Um servidor vazio e sem schema falha na primeira query. Criá-lo é um passo separado, coberto mais abaixo.
- O serviço de banco não está rodando. Depois de um reboot, o MariaDB ou o MySQL pode estar parado. Inicie o serviço e tente de novo antes de editar qualquer coisa.
As chaves ficam em arquivos diferentes conforme o pack: config/loginserver.properties e config/server.properties no L2J, dist/game/config/Database.ini no L2JMobius, database.properties na imagem Docker. Os nomes das chaves são URL, Login e Password, com User no lugar de Login em alguns packs. Corrija tanto a configuração do login server quanto a do game server; eles conectam de forma independente e um vai subir tranquilamente enquanto o outro falha.
UnsupportedClassVersionError significa que o JDK não combina com o pack
UnsupportedClassVersionError não é um download corrompido. Significa que os arquivos de classe foram compilados para uma versão de Java mais nova do que a que os executa, ou que o código-fonte espera um nível de linguagem mais novo do que o seu JDK oferece.
- L2JServer oficial atualmente mira Java 21 ou 25. O guia de instalação oficial é escrito para a linha LTS atual.
- Packs antigos de L2J e da era Interlude miram JDK 8. Foram escritos antes de módulos e records, e JDKs mais novos rejeitam partes do código.
- aCis depende da revisão: JDK 8 abaixo da revisão 381, JDK 11 da 381 à 406, JDK 21 a partir da 406. O repositório público informa o alvo da revisão atual.
Ler o número no erro ajuda. A versão maior 52 é Java 8, 55 é Java 11, 61 é Java 17, 65 é Java 21. Se o arquivo de classe for mais novo que o seu runtime, instale o JDK correspondente. Se for mais antigo e o pack ainda se recusar a rodar, o pack está pedindo um mais novo e o build precisa ser recompilado com o nível de compilador correto. Manter vários JDKs instalados e trocar o JAVA_HOME conforme o pack é prática normal, e o guia de configuração de JDK e Eclipse cobre a mecânica da troca.

Game server ausente na lista do login server
Os dois processos sobem, os dois logs parecem calmos e o cliente mostra uma lista de servidores sem nada dentro. O game server nunca se registrou no login server, então o login server não tem nada para anunciar.
O registro é uma ferramenta, não um valor de configuração. Rode a ferramenta de registro de game server do pack, que grava um arquivo hexid.txt. Copie esse arquivo para a pasta de configuração do login server, ao lado de loginserver.properties, usando o mesmo id que a ferramenta informou. Reinicie o login server e depois o game server, nessa ordem.
Se o arquivo está no lugar e o servidor ainda não aparece, os dois processos não conseguem conversar. Eles usam a porta 9014, e uma regra de firewall local, uma fronteira de rede do Docker ou um painel de hospedagem podem bloqueá-la entre contêineres ou máquinas virtuais mesmo quando ambos estão na mesma máquina. Libere essa porta entre os dois, não para a internet.
Ping 9999 e a barreira do server select
Você faz login, a lista de servidores mostra uma entrada com ping de 9999 milissegundos e clicar nela devolve você à lista. O login funcionou, então credenciais e banco estão certos. O que falhou foi o cliente chegar ao game server.
Duas coisas causam isso: um hostname que o cliente não consegue resolver, ou uma porta que o cliente não consegue alcançar. Confira os hostnames externo e interno na configuração, com as chaves ExternalHostname e InternalHostname no L2J e dentro de Network.ini nos packs Mobius. O externo é o que os jogadores usam para conectar, o interno é o que o login server usa para chegar ao game server. Definir os dois como 127.0.0.1 funciona para um teste local e falha para todo mundo.
Depois abra ou redirecione as portas 2106 e 7777. O README do L2J diz a mesma solução em uma linha:
Set up your IP's properly, forward/open good ports if accessing from outside.
Um servidor atrás de NAT precisa do endereço público no hostname externo e de um redirecionamento para as duas portas. Um servidor em um VPS normalmente precisa do firewall da hospedagem aberto, não só o do sistema operacional. O guia de configuração do game e do login server passa pelas chaves de hostname uma por uma.
O mundo carrega vazio
O servidor sobe, o cliente conecta e o mundo não tem NPCs, nem templates de itens, nem spawns. Nada está quebrado: o schema nunca foi instalado, ou só parte dele foi. As tabelas que os loaders esperam estão faltando e os loaders as ignoram em silêncio.
Rode o instalador de banco de dados do pack antes do primeiro start.
- L2J:
l2jcli.bat db install -sql <path> -u <user> -p <pass> -m FULL -t LOGINe depois o mesmo comando com-t GAME. Os schemas de login e de game são separados. - Packs antigos:
database_installer.shoudatabase_installer.batdentro da pastatools.
Instalações parciais são comuns quando o caminho do SQL está errado ou o instalador para no primeiro erro. Acompanhe a saída dele até o fim em vez de supor que terminou, e depois confira se o banco do game realmente tem tabelas.
Portas e o arquivo hosts do cliente
Quatro portas decidem se uma instalação funciona. Só duas delas pertencem a uma interface pública, e a porta do banco de dados a nenhuma.
| Porta | Função | Exposição |
|---|---|---|
| 2106 | Login server, conexões do cliente | Pública |
| 7777 | Game server, conexões do cliente | Pública |
| 9014 | Login server para game server | Privada, só entre os dois processos |
| 3306 | MySQL ou MariaDB | Nunca pública |
Expor a 3306 é o erro de segurança mais comum em um host de Lineage 2. Nada fora da máquina precisa dela, e uma porta de banco exposta à internet é escaneada em questão de horas. Faça o bind do banco em localhost e deixe só os processos do servidor usarem. Os instaladores do MariaDB estão em mariadb.org; o guia de configuração do banco cobre usuários e bind.
Do lado do cliente, o jogo resolve l2authd.lineage2.com. Aponte esse nome para o seu servidor com uma entrada em hosts, ou lance l2.bin IP=<address> direto. Dois erros quebram isso repetidamente no Windows: o arquivo é salvo como hosts.txt, que o Windows ignora porque não tem extensão, e a entrada aponta para um endereço que o cliente não consegue rotear. Confirme que o arquivo não tem extensão e edite como administrador.
Arquivos de configuração que falham no parse no Windows
Alguns packs se recusam a subir sem nenhum erro legível, ou imprimem uma falha de parse em uma linha que parece correta. A causa usual é a codificação do arquivo. Salve um arquivo .properties do L2J como UTF-8 com byte order mark depois de salvar no Notepad e o loader pode engasgar no primeiro byte não ASCII, porque o BOM é lido como parte da primeira chave.
Para confirmar, confira os três primeiros bytes do arquivo. Um BOM começa com EF BB BF. Salve sem ele, mantenha os valores em ASCII simples e rode o servidor de novo. Arquivos de configuração também diferenciam maiúsculas de minúsculas no Linux, então um caminho que funciona no Windows pode falhar no host.
Referência rápida
As falhas centrais, comprimidas para o momento em que você está encarando um console:
| Erro | Causa real | Correção |
|---|---|---|
| java is not recognized | Sem JDK, ou PATH e JAVA_HOME não definidos | Instale o JDK, defina JAVA_HOME para a raiz do JDK e adicione o bin dela ao PATH |
| Couldn't init DB connection | URL errada, credenciais erradas, banco ausente, serviço parado | Corrija as chaves URL, Login e Password nas configurações de game e login |
| UnsupportedClassVersionError | JDK mais novo ou mais antigo do que o pack espera | Instale o JDK que o pack mira e recompile |
| Lista de servidores vazia, ou ping 9999 | Sem hexid.txt, ou hostnames e portas inalcançáveis | Registre o game server e depois abra 2106 e 7777 |
| Mundo vazio | Schema nunca instalado ou instalado em parte | Rode o instalador de banco do pack para LOGIN e GAME |
Trabalhe de cima para baixo. Cada falha esconde a próxima: um servidor não pode informar um erro de banco até a JVM rodar, e não pode se registrar no login server até o banco conectar. Corrigi-las fora de ordem produz erros novos que parecem não ter relação.
Quando a instalação finalmente estiver estável e o servidor pronto para jogadores, adicione-o pelo formulário de listagem gratuito, ou pegue um posicionamento VIP para ficar à frente da fila no diretório de servidores.
