L2 Server Errors Fix: семь сбоев установки и их реальные причины

Самый быстрый l2 server errors fix — прочитать класс исключения, прежде чем открывать файл конфигурации. Сервер, который падает при загрузке, и сервер, который загружается в пустой мир, ломаются на разных уровнях, и сообщение почти всегда называет уровень: JVM, соединение JDBC, рукопожатие логина или клиент. Сбои ниже встречаются чаще всего при установке L2J, L2JMobius и aCis. Каждый пункт — это ошибка, которую вы видите, то, что на самом деле её вызывает, и конкретный файл, порт или команда, которые её устраняют.
Java не распознаётся как команда
В Windows оболочка пишет java is not recognized as an internal or external command, operable program or batch file. В Linux — java: command not found. Оба означают одно: JDK не установлен, либо установлен, но ни JAVA_HOME, ни PATH на него не указывают. Руководство по установке начинается отсюда не случайно. Ничего после этого шага работать не может.
Установите сборку OpenJDK, затем направьте окружение на корень JDK, а не на папку bin внутри него.
- Задайте
JAVA_HOMEкак каталог JDK, напримерC:\Program Files\Eclipse Adoptium\jdk-25. - Добавьте
%JAVA_HOME%\binвPATHв Windows или$JAVA_HOME/binв Linux. - Откройте новый терминал. Изменения окружения не доходят до уже запущенной оболочки.
- Проверьте обе команды,
java -versionиjavac -version. Если работает только одна, вы установили JRE, и сборка позже упадёт.
В Windows есть установка одной строкой, если вы используете winget: winget install EclipseAdoptium.Temurin.25.JDK. Приведите мажорную версию к своему паку перед запуском — об этом третий раздел.

Игровой сервер падает с ошибкой базы данных
Консоль печатает Couldn't init DB connection, либо драйвер сообщает Unknown database 'l2jdb', и через несколько строк процесс завершается. Мир так и не запускается. Причин пять обычных, экзотических нет.
- Имя базы данных указано в URL JDBC дважды. URL вида
jdbc:mariadb://localhost:3306/l2jdb/l2jdbразбирается как база с именемl2jdb/l2jdb. Оставьте один сегмент после порта. - Имя базы данных неверное. L2J рассчитан на
l2jdb, но восстановленный дамп или переименованная схема оставляют в конфигурации имя, которого больше нет. - Неверны пользователь или пароль. Учётная запись игрового сервера — не root-аккаунт MySQL. Проверьте точные учётные данные из конфигурации в клиенте вроде HeidiSQL, прежде чем винить сервер.
- База данных не была создана. Пустой сервер без схемы падает на первом запросе. Её создание — отдельный шаг, он описан ниже.
- Служба базы данных не запущена. После перезагрузки MariaDB или MySQL могут быть остановлены. Запустите службу и повторите попытку, прежде чем что-то править.
Ключи лежат в разных файлах в зависимости от пака: config/loginserver.properties и config/server.properties для L2J, dist/game/config/Database.ini для L2JMobius, database.properties для Docker-образа. Имена ключей — URL, Login и Password, в некоторых паках вместо Login стоит User. Исправьте конфигурацию и login server, и game server; они подключаются независимо, и один спокойно запустится, пока второй падает.
UnsupportedClassVersionError означает, что JDK не соответствует паку
UnsupportedClassVersionError — это не битая загрузка. Это значит, что файлы классов скомпилированы для более новой версии Java, чем та, что их выполняет, либо исходный код требует более нового уровня языка, чем даёт ваш JDK.
- Официальный L2JServer сейчас ориентирован на Java 21 или 25. Официальное руководство по установке написано под актуальную ветку LTS.
- Старые паки L2J и эпохи Interlude рассчитаны на JDK 8. Они написаны до модулей и records, и новые JDK отвергают часть кода.
- aCis зависит от ревизии: JDK 8 ниже ревизии 381, JDK 11 с 381 по 406, JDK 21 с 406 и далее. Публичный репозиторий указывает цель текущей ревизии.
Помогает прочитать число в ошибке. Мажорная версия 52 — это Java 8, 55 — Java 11, 61 — Java 17, 65 — Java 21. Если файл класса новее вашей среды выполнения, установите подходящий JDK. Если он старее, а пак всё равно отказывается работать, значит пак требует более новый, и сборку нужно перекомпилировать с правильным уровнем компилятора. Держать несколько JDK и переключать JAVA_HOME под каждый пак — обычная практика, а руководство по настройке JDK и Eclipse описывает механику переключения.

Игрового сервера нет в списке login server
Оба процесса запускаются, оба лога выглядят спокойно, а клиент показывает список серверов, в котором пусто. Игровой сервер так и не зарегистрировался на login server, поэтому login server нечего объявлять.
Регистрация — это инструмент, а не значение конфигурации. Запустите инструмент регистрации игрового сервера из пака, он записывает файл hexid.txt. Скопируйте этот файл в папку конфигурации login server, рядом с loginserver.properties, используя тот же id, который сообщил инструмент. Перезапустите login server, затем игровой сервер, именно в этом порядке.
Если файл на месте, а сервер всё равно не появляется, два процесса не могут связаться. Они используют порт 9014, и локальное правило брандмауэра, граница сети Docker или панель хостинга могут блокировать его между контейнерами или виртуальными машинами, даже когда оба на одной машине. Разрешите этот порт между ними, а не в интернет.
Пинг 9999 и стена при выборе сервера
Вы входите в систему, список серверов показывает запись с пингом 9999 миллисекунд, а нажатие на неё возвращает вас в список. Вход сработал, значит учётные данные и база в порядке. Не сработало то, что клиент не доходит до игрового сервера.
Причин две: имя хоста, которое клиент не может разрешить, или порт, до которого клиент не может добраться. Проверьте внешнее и внутреннее имена хостов в конфигурации, это ключи ExternalHostname и InternalHostname в L2J и раздел в Network.ini в паках Mobius. Внешнее — то, к чему подключаются игроки, внутреннее — то, через которое login server достигает игрового. Если задать оба как 127.0.0.1, это сработает для локальной проверки и не сработает для всех остальных.
Затем откройте или пробросьте порты 2106 и 7777. README L2J говорит то же самое одной строкой:
Set up your IP's properly, forward/open good ports if accessing from outside.
Серверу за NAT нужен публичный адрес во внешнем имени хоста и проброс обоих портов. Серверу на VPS обычно нужно открыть брандмауэр хостинга, а не только брандмауэр ОС. Руководство по настройке game и login server разбирает ключи имён хостов по одному.
Мир загружается пустым
Сервер запускается, клиент подключается, а в мире нет NPC, нет шаблонов предметов и нет спавнов. Ничего не сломано: схема не была установлена или установлена лишь частично. Таблиц, которые ждут загрузчики, нет, и загрузчики молча их пропускают.
Запустите установщик базы данных из пака до первого старта.
- L2J:
l2jcli.bat db install -sql <path> -u <user> -p <pass> -m FULL -t LOGIN, затем ту же команду с-t GAME. Схемы login и game раздельные. - Старые паки:
database_installer.shилиdatabase_installer.batв папкеtools.
Частичные установки обычны, когда путь к SQL неверен или установщик останавливается на первой ошибке. Смотрите его вывод до конца, а не предполагайте, что он завершился, затем проверьте, что в базе игрового сервера действительно есть таблицы.
Порты и файл hosts на клиенте
Четыре порта решают, работает ли установка. Только два из них принадлежат публичному интерфейсу, а порт базы данных — ни одному.
| Порт | Назначение | Доступ |
|---|---|---|
| 2106 | Login server, подключения клиента | Публичный |
| 7777 | Game server, подключения клиента | Публичный |
| 9014 | Login server к game server | Приватный, только между двумя процессами |
| 3306 | MySQL или MariaDB | Никогда не публичный |
Открыть 3306 — самая частая ошибка безопасности на хосте Lineage 2. Ничему вне машины он не нужен, а порт базы данных, смотрящий в интернет, сканируют в течение часов. Привяжите базу к localhost и позвольте пользоваться ею только процессам сервера. Установщики MariaDB лежат на mariadb.org; руководство по настройке базы данных описывает пользователей и привязку.
Со стороны клиента игра разрешает l2authd.lineage2.com. Направьте это имя на свой сервер записью в hosts или запускайте l2.bin IP=<address> напрямую. Две ошибки раз за разом ломают это в Windows: файл сохранён как hosts.txt, который Windows игнорирует, потому что расширения нет, и запись указывает на адрес, до которого клиент не может маршрутизировать. Убедитесь, что у файла нет расширения, и редактируйте его от имени администратора.
Файлы конфигурации, которые не разбираются в Windows
Некоторые паки отказываются запускаться вообще без читаемой ошибки или печатают сбой разбора на строке, которая выглядит правильной. Обычная причина — кодировка файла. Сохраните .properties-файл L2J как UTF-8 с byte order mark после сохранения в Notepad, и загрузчик может поперхнуться на первом не-ASCII байте, потому что BOM читается как часть первого ключа.
Чтобы убедиться, проверьте первые три байта файла. BOM начинается с EF BB BF. Сохраните без него, держите значения в простом ASCII и перезапустите сервер. Файлы конфигурации в Linux ещё и чувствительны к регистру, так что путь, работающий в Windows, может не работать на хосте.
Быстрая справка
Основные сбои, сжатые для момента, когда вы смотрите в консоль:
| Ошибка | Реальная причина | Решение |
|---|---|---|
| java is not recognized | Нет JDK, либо PATH и JAVA_HOME не заданы | Установите JDK, задайте JAVA_HOME как корень JDK, добавьте его bin в PATH |
| Couldn't init DB connection | Неверный URL, неверные учётные данные, нет базы, служба остановлена | Исправьте ключи URL, Login и Password в конфигурациях game и login |
| UnsupportedClassVersionError | JDK новее или старее, чем ожидает пак | Установите JDK, на который рассчитан пак, и пересоберите |
| Пустой список серверов или пинг 9999 | Нет hexid.txt, либо имена хостов и порты недоступны | Зарегистрируйте игровой сервер, затем откройте 2106 и 7777 |
| Пустой мир | Схема не устанавливалась или установлена частично | Запустите установщик базы из пака для LOGIN и GAME |
Двигайтесь сверху вниз. Каждый сбой скрывает следующий: сервер не может сообщить об ошибке базы, пока не заработает JVM, и не может зарегистрироваться на login server, пока не подключится база. Исправление их не по порядку даёт новые ошибки, которые выглядят несвязанными.
Когда установка наконец стабильна и сервер готов для игроков, добавьте его через бесплатную форму добавления или возьмите VIP-размещение, чтобы стоять впереди очереди в каталоге серверов.
