Guia de L2JMobius setup: do clone ao primeiro login

L2Calendar Team11.09.202611 min de leitura

Guia de L2JMobius setup: compile e rode o servidor

Um l2jmobius setup limpo leva uma tarde se você seguir a ordem que o projeto espera: build primeiro, banco de dados segundo, configuração terceiro e só então iniciar os servidores. A maioria das primeiras tentativas falha porque alguém pula o instalador do banco, inicia o game server antes do login server ou compila com a versão errada do Java. Este guia percorre o caminho completo, do clone do repositório ao primeiro personagem entrando, e lista os erros que travam as pessoas em cada etapa. Os comandos exatos refletem o layout atual do projeto; a pasta da sua crônica pode diferir em pequenos detalhes.

Pré-requisitos: Java, banco de dados e a crônica certa

Deixe tudo isso pronto antes de tocar no código. Faltar um deles é a causa mais comum de build falho.

JDK do Java. Releases recentes do L2JMobius miram um JDK moderno, a linha C4 atual exige JDK 25, e pastas de crônicas anteriores podem usar outra versão. Confira o readme.txt na pasta da sua crônica e instale exatamente aquele JDK.
Um motor de banco de dados. MySQL 5.7+ ou MariaDB 10.3+. Crie um banco dedicado com collation utf8mb4 para o tratamento correto de caracteres.
Uma ferramenta de build. Apache Ant, acionado pelo build.xml na raiz da crônica que você está compilando.
Hardware. Pelo menos 4 GB de RAM para testar (16 GB+ recomendados com jogadores online) e cerca de 10 GB de disco livre para o código, a saída do build e o banco.

Escolha uma pasta de crônica e trabalhe só dentro dela. O L2JMobius entrega uma distribuição autocontida por crônica, e misturar pastas ou schemas causa falhas evitáveis.

Passo 1: clone o repositório e compile com Ant

Clone o projeto, abra na sua IDE e rode o build do Ant.

Clone https://gitlab.com/MobiusDevelopment/L2J_Mobius.git (o código completo está no GitLab).
Importe os projetos no Eclipse ou IntelliJ, e garanta que a IDE aponte para o JDK que você instalou, não para um embutido.
Clique com o botão direito em build.xml e rode como build do Ant. Espere o BUILD SUCCESSFUL.
Pegue a distribuição empacotada no diretório build (um zip que você extrai para uma pasta de trabalho como C:\L2J_Mobius, ou o caminho que escolher no Linux).

Se o build falhar de imediato, é quase sempre a versão do Java ou uma instalação do Ant faltando. Resolva isso antes de investigar qualquer outra coisa.

Passo 2: configure o MySQL ou MariaDB

Instale e inicie o serviço de banco, depois crie o schema e um usuário para o servidor.

No Windows, o XAMPP é uma forma conveniente de iniciar o MySQL, mas confira se a versão incluída ainda atende ao mínimo acima; uma instalação avulsa de MySQL ou MariaDB é a escolha mais segura. No Linux, use o gerenciador de pacotes e o systemctl.
Crie o banco e um usuário dedicado, e conceda a ele privilégios nesse banco.
Use utf8mb4 no banco para que nomes de personagens não latinos sejam armazenados corretamente.

Mantenha as credenciais à mão. Você vai inseri-las em dois arquivos de configuração, não em um.

Guia de L2JMobius setup: compile e rode o servidor (2) — Lineage II © NCSOFT

Passo 3: rode o instalador do banco e configure as conexões

O instalador do banco cria as tabelas e carrega os dados base. Pulá-lo é o erro de setup número um.

Abra a pasta db_installer na distribuição extraída.
Edite config/Database.ini dentro do instalador com seu host, nome do banco, usuário e senha.
Rode o instalador (no Windows, o DatabaseInstaller.vbs fornecido; no Linux, o launcher shell ou java -jar DatabaseInstaller.jar).
Escolha a opção de instalar tanto o schema de login quanto o de game, e deixe que ele crie as tabelas e importe os dados base.

Agora configure os dois servidores para alcançar esse banco. Edite o mesmo bloco de conexão em login/config/Database.ini e em game/config/Database.ini. Se eles forem diferentes da configuração do instalador, os servidores iniciam e depois falham ao ler dados.

Passo 4: inicie o login server, depois o game server

A ordem importa. O game server se registra no login server, então o login server precisa estar ativo primeiro.

Inicie o login server a partir da pasta login. Espere a mensagem de que está escutando (porta padrão 2106).
Inicie o game server a partir da pasta game. Espere ele reportar que está escutando (porta padrão 7777) e que se registrou com sucesso.
Ajuste a memória da JVM em java.cfg para cada processo. O game server precisa de bem mais heap que o login server.

Se o game server registrar uma falha de registro, as credenciais do banco ou o estado do login server são as causas usuais, não a rede.

Passo 5: case o protocolo do cliente e entre no jogo

Um servidor rodando é só metade do trabalho. O cliente precisa falar a mesma versão de protocolo que a crônica que você compilou.

Verifique se a versão de protocolo do cliente corresponde à pasta da crônica (clientes de Chronicle 4, por exemplo, costumam usar o protocolo 656). Uma incompatibilidade aparece como desconexão imediata na seleção de personagem.
Aponte o endereço do servidor e a porta de login do cliente para a sua máquina se estiver testando localmente.
Crie uma conta de jogo pelo login server, entre e confirme que seu primeiro personagem carrega.

Erros comuns de L2JMobius setup e correções

"Cannot connect with client" ou desconexão imediata. Quase sempre é incompatibilidade de protocolo: confirme que a versão do cliente corresponde à crônica.
O build falha na checagem do Java. Seu JDK está na versão errada para aquela pasta de crônica. Instale a versão que o readme especifica.
O game server inicia, mas personagens não se movem nem carregam. Normalmente significa que o instalador do banco nunca rodou, ou que login e game apontam para bancos diferentes. Rode o instalador de novo e reconcilie os dois arquivos de configuração.
Conexão recusada ao banco de dados. O serviço de banco não está rodando, ou as credenciais em Database.ini estão erradas.
O servidor dá lag com jogadores online. Revise o heap da JVM em java.cfg e as configurações do banco antes de culpar o código.

Depois do primeiro login: liste seu servidor e seja encontrado

Um l2jmobius setup funcionando é o começo, não o lançamento. Verifique a estabilidade com um teste privado e publique um anúncio preciso, com crônica, rates e horário de abertura, na listagem gratuita da L2Calendar. Quando estiver pronto para competir por atenção nas semanas de lançamento, o destaque VIP coloca o servidor na frente de jogadores que estão buscando aberturas novas. O pack te faz rodar; a descoberta é o que enche o seu servidor.

Perguntas frequentes

Qual versão do Java o L2JMobius precisa?

Depende da crônica. Releases recentes miram um JDK moderno, e a linha C4 atual exige JDK 25. Pastas de crônicas anteriores podem especificar outra versão, então confira sempre o readme.txt na pasta que você está compilando e compile só aquela crônica.

Preciso de XAMPP para o L2JMobius setup?

Não, mas é uma forma conveniente de rodar o MySQL no Windows. No Linux você pode instalar MySQL ou MariaDB direto. O servidor só precisa de um banco MySQL 5.7+ ou MariaDB 10.3+ acessível com o schema instalado.

Por que meu cliente desconecta logo depois de conectar?

A versão de protocolo do cliente não corresponde à pasta de crônica que você compilou. Cada patch do retail muda opcodes de pacote, então você precisa casar o build certo de cliente com a crônica certa. Confirme o protocolo que a crônica espera antes de investigar mais.

Posso rodar um banco L2JMobius para várias crônicas?

Não. Cada pasta de crônica entrega o próprio schema e dados iniciais, e eles diferem o bastante para que misturá-los quebre os dois. Rode um banco por implantação de crônica e use o db_installer incluído para aquela crônica.