L2 Server Errors Fix: siete fallos de instalación y sus causas reales

El l2 server errors fix más rápido consiste en leer la clase de la excepción antes de abrir un archivo de configuración. Un servidor que muere durante el arranque y un servidor que arranca hacia un mundo vacío fallan en capas distintas, y el mensaje casi siempre nombra la capa: la JVM, la conexión JDBC, el handshake del login o el cliente. Los fallos de abajo son los que más aparecen en instalaciones de L2J, L2JMobius y aCis. Cada entrada es el error que ves, lo que realmente lo causa y el archivo, puerto o comando concreto que lo resuelve.
Java no se reconoce como comando
En Windows la consola dice java is not recognized as an internal or external command, operable program or batch file. En Linux dice java: command not found. Ambas significan lo mismo: no hay ningún JDK instalado, o hay uno instalado y ni JAVA_HOME ni PATH apuntan a él. La guía de instalación empieza aquí por una razón. Nada después de este paso puede funcionar.
Instala un build de OpenJDK y luego apunta el entorno a la raíz del JDK, no a la carpeta bin que hay dentro.
- Define
JAVA_HOMEal directorio del JDK, por ejemploC:\Program Files\Eclipse Adoptium\jdk-25. - Añade
%JAVA_HOME%\binaPATHen Windows, o$JAVA_HOME/binen Linux. - Abre una terminal nueva. Los cambios de entorno no llegan a una shell que ya estaba en ejecución.
- Comprueba ambos comandos,
java -versionyjavac -version. Si solo funciona uno, instalaste un JRE y el build fallará más adelante.
Windows tiene una instalación de una línea si usas winget: winget install EclipseAdoptium.Temurin.25.JDK. Ajusta la versión mayor a tu pack antes de ejecutarlo, que es el tema de la tercera sección.

El game server muere con un error de base de datos
La consola imprime Couldn't init DB connection, o el driver informa Unknown database 'l2jdb', y el proceso termina unas líneas después. El mundo nunca arranca. Hay cinco causas corrientes y ninguna exótica.
- El nombre de la base de datos aparece dos veces en la URL JDBC. Una URL como
jdbc:mariadb://localhost:3306/l2jdb/l2jdbse interpreta como una base de datos llamadal2jdb/l2jdb. Deja un solo segmento después del puerto. - El nombre de la base de datos es incorrecto. L2J viene esperando
l2jdb, pero un dump restaurado o un esquema renombrado dejan la configuración apuntando a un nombre que ya no existe. - El usuario o la contraseña son incorrectos. La cuenta que usa el game server no es la cuenta root de MySQL. Prueba con las credenciales exactas de la configuración desde un cliente como HeidiSQL antes de culpar al servidor.
- La base de datos nunca se creó. Un servidor vacío y sin esquema falla en la primera consulta. Crearla es un paso aparte, que se cubre más abajo.
- El servicio de base de datos no está en ejecución. Después de un reinicio, MariaDB o MySQL pueden estar detenidos. Inicia el servicio y reintenta antes de editar nada.
Las claves viven en archivos distintos según el pack: config/loginserver.properties y config/server.properties para L2J, dist/game/config/Database.ini para L2JMobius, database.properties para la imagen Docker. Los nombres de las claves son URL, Login y Password, con User en lugar de Login en algunos packs. Corrige tanto la configuración del login server como la del game server; se conectan de forma independiente y uno arrancará sin problema mientras el otro falla.
UnsupportedClassVersionError significa que el JDK no coincide con el pack
UnsupportedClassVersionError no es una descarga rota. Significa que los archivos de clase se compilaron para una versión de Java más nueva que la que los ejecuta, o que el código fuente espera un nivel de lenguaje más nuevo del que tu JDK ofrece.
- L2JServer oficial actualmente apunta a Java 21 o 25. La guía de instalación oficial está escrita contra la línea LTS actual.
- Packs antiguos de L2J y de la era Interlude apuntan a JDK 8. Se escribieron antes de los módulos y los records, y los JDK más nuevos rechazan partes del código.
- aCis depende de la revisión: JDK 8 por debajo de la revisión 381, JDK 11 de la 381 a la 406, JDK 21 desde la 406 en adelante. El repositorio público indica el objetivo de la revisión actual.
Leer el número del error ayuda. La versión mayor 52 es Java 8, 55 es Java 11, 61 es Java 17, 65 es Java 21. Si el archivo de clase es más nuevo que tu runtime, instala el JDK correspondiente. Si es más antiguo y el pack sigue negándose a ejecutarse, el pack está pidiendo uno más nuevo y el build necesita recompilarse con el nivel de compilador correcto. Tener varios JDK instalados e ir cambiando JAVA_HOME según el pack es práctica normal, y la guía de configuración de JDK y Eclipse cubre la mecánica del cambio.

El game server no aparece en la lista del login server
Los dos procesos arrancan, los dos logs parecen tranquilos y el cliente muestra una lista de servidores sin nada dentro. El game server nunca se registró ante el login server, así que el login server no tiene nada que anunciar.
El registro es una herramienta, no un valor de configuración. Ejecuta la herramienta de registro de game server del pack, que escribe un archivo hexid.txt. Copia ese archivo a la carpeta de configuración del login server, junto a loginserver.properties, usando el mismo id que informó la herramienta. Reinicia el login server y después el game server, en ese orden.
Si el archivo está en su sitio y el servidor sigue sin aparecer, los dos procesos no pueden comunicarse. Usan el puerto 9014, y una regla de firewall local, un límite de red de Docker o un panel de hosting pueden bloquearlo entre contenedores o máquinas virtuales incluso cuando ambos están en la misma máquina. Permite ese puerto entre los dos, no hacia internet.
Ping 9999 y el muro del server select
Inicias sesión, la lista de servidores muestra una entrada con un ping de 9999 milisegundos y al hacer clic te devuelve a la lista. El login funcionó, así que las credenciales y la base de datos están bien. Lo que falló es que el cliente llegue al game server.
Dos cosas lo causan: un hostname que el cliente no puede resolver, o un puerto que el cliente no puede alcanzar. Revisa los hostnames externo e interno en la configuración, con las claves ExternalHostname e InternalHostname en L2J y dentro de Network.ini en los packs Mobius. El externo es al que se conectan los jugadores, el interno es el que usa el login server para llegar al game server. Poner ambos en 127.0.0.1 funciona para una prueba local y falla para todos los demás.
Después abre o redirige los puertos 2106 y 7777. El README de L2J dice la misma solución en una línea:
Set up your IP's properly, forward/open good ports if accessing from outside.
Un servidor detrás de NAT necesita la dirección pública en el hostname externo y una redirección para ambos puertos. Un servidor en un VPS normalmente necesita que se abra el firewall del hosting, no solo el del sistema operativo. La guía de configuración del game y login server repasa las claves de hostname una por una.
El mundo carga vacío
El servidor arranca, el cliente conecta y el mundo no tiene NPCs, ni plantillas de objetos, ni spawns. Nada está roto: el esquema nunca se instaló, o solo se instaló una parte. Las tablas que esperan los loaders no existen y los loaders las omiten en silencio.
Ejecuta el instalador de base de datos del pack antes del primer arranque.
- L2J:
l2jcli.bat db install -sql <path> -u <user> -p <pass> -m FULL -t LOGINy luego el mismo comando con-t GAME. Los esquemas de login y de game son independientes. - Packs antiguos:
database_installer.shodatabase_installer.batdentro de la carpetatools.
Las instalaciones parciales son habituales cuando la ruta SQL es incorrecta o el instalador se detiene en el primer error. Vigila su salida hasta el final en lugar de suponer que terminó, y luego comprueba que la base de datos del game sí tiene tablas.
Puertos y el archivo hosts del cliente
Cuatro puertos deciden si una instalación funciona. Solo dos de ellos pertenecen a una interfaz pública, y el puerto de la base de datos a ninguna.
| Puerto | Función | Exposición |
|---|---|---|
| 2106 | Login server, conexiones del cliente | Público |
| 7777 | Game server, conexiones del cliente | Público |
| 9014 | Login server hacia game server | Privado, solo entre los dos procesos |
| 3306 | MySQL o MariaDB | Nunca público |
Exponer el 3306 es el error de seguridad más común en un host de Lineage 2. Nada fuera de la máquina lo necesita, y un puerto de base de datos expuesto a internet recibe escaneos en cuestión de horas. Ata la base de datos a localhost y deja que solo los procesos del servidor la usen. Los instaladores de MariaDB están en mariadb.org; la guía de configuración de base de datos cubre usuarios y binding.
Del lado del cliente, el juego resuelve l2authd.lineage2.com. Apunta ese nombre a tu servidor con una entrada en hosts, o lanza l2.bin IP=<address> directamente. Dos errores rompen esto una y otra vez en Windows: el archivo se guarda como hosts.txt, que Windows ignora porque no tiene extensión, y la entrada apunta a una dirección a la que el cliente no puede enrutar. Confirma que el archivo no tiene extensión y edítalo como administrador.
Archivos de configuración que fallan al parsear en Windows
Algunos packs se niegan a arrancar sin ningún error legible, o imprimen un fallo de parseo en una línea que parece correcta. La causa habitual es la codificación del archivo. Guarda un archivo .properties de L2J como UTF-8 con byte order mark después de guardarlo con Notepad y el loader puede atragantarse con el primer byte no ASCII, porque el BOM se lee como parte de la primera clave.
Para confirmarlo, revisa los tres primeros bytes del archivo. Un BOM empieza por EF BB BF. Guarda sin él, mantén los valores en ASCII plano y vuelve a ejecutar el servidor. Los archivos de configuración también distinguen mayúsculas y minúsculas en Linux, así que una ruta que funciona en Windows puede fallar en el host.
Referencia rápida
Los fallos centrales, comprimidos para el momento en que estás mirando una consola:
| Error | Causa real | Arreglo |
|---|---|---|
| java is not recognized | No hay JDK, o PATH y JAVA_HOME sin definir | Instala el JDK, define JAVA_HOME a la raíz del JDK y añade su bin al PATH |
| Couldn't init DB connection | URL incorrecta, credenciales incorrectas, base de datos ausente, servicio detenido | Corrige las claves URL, Login y Password en las configuraciones de game y login |
| UnsupportedClassVersionError | JDK más nuevo o más antiguo de lo que espera el pack | Instala el JDK al que apunta el pack y recompila |
| Lista de servidores vacía, o ping 9999 | Falta hexid.txt, o los hostnames y puertos no son alcanzables | Registra el game server y luego abre 2106 y 7777 |
| Mundo vacío | Esquema nunca instalado o instalado parcialmente | Ejecuta el instalador de base de datos del pack para LOGIN y GAME |
Trabaja de arriba abajo. Cada fallo esconde el siguiente: un servidor no puede informar un error de base de datos hasta que la JVM se ejecuta, y no puede registrarse ante el login server hasta que la base de datos conecta. Arreglarlos fuera de orden produce errores nuevos que parecen no tener relación.
Cuando la instalación por fin esté estable y el servidor listo para jugadores, añádelo mediante el formulario de listado gratuito, o toma un emplazamiento VIP para situarte por delante de la cola en el directorio de servidores.
