aCis Pack Setup: сборка и запуск сервера Interlude C6
Сборка (setup) пака aCis — самый прямой путь к серверу Interlude C6, близкому к ретейлу и полностью под вашим контролем. aCis ("another Crappy interlude server") — это Java-эмулятор, построенный на наработках L2J и привязанный к одной хронике, и именно поэтому владельцы приватных серверов снова и снова возвращаются к нему. Его GeoData переиспользуется в других паках, поведение близко к ретейлу, а проект настроен именно под Interlude, а не растянут на десяток хроник. В этом руководстве владелец сервера пройдёт через предварительные требования, сборку Ant, установщик базы данных, конфигурацию, рукопожатие hexid и патч на стороне клиента, включая ловушку сборки на JDK 21, которая останавливает большинство первых установок.
Что такое aCis и почему админы Interlude выбирают его
Название aCis расшифровывается как "another Crappy interlude server". Это Java-эмулятор сервера Lineage 2, производный от работы над L2J, и в отличие от универсальных проектов он нацелен на одну хронику: Interlude (C6). В этой узкой направленности и есть смысл. Поскольку коду никогда не приходится обслуживать Kamael, Gracia или более поздние системы, поведение остаётся близким к ретейловому Interlude, quests и skills настроены под ту эпоху, а GeoData, поставляемый с aCis, достаточно хорош, чтобы другие паки его переиспользовали.
Проект следует модели freemium. Публичные исходники бесплатны, а самые новые и отточенные ревизии доступны сторонникам, которые вкладывают деньги или код. Если вам нужны свежие исправления, вы либо донатите, либо присылаете merge requests. Фóрум сообщества на acis.i-live.eu — это место, где живут ревизии, changelog и темы поддержки, а публичный репозиторий находится на gitlab.com/Tryskell/acis_public.
Для контекста: L2JMobius поддерживает множество хроник и очень активен, что делает его сильным универсальным выбором. aCis — противоположная ставка: только Interlude, ценимый за верность ретейлу. Если ваш сервер — это проект Interlude C6, такая сделка обычно того стоит.
Предварительные требования: JDK, MariaDB, Eclipse и Ant
До первой сборки нужно четыре вещи: JDK, MariaDB, Eclipse (пакет IDE for Java Developers) и Ant. В Windows пакет MariaDB идёт с HeidiSQL — удобный способ позже просмотреть обе базы данных. Сам MariaDB — это стандартная установка с mariadb.org.
Версия JDK не опциональна, потому что зависит от ревизии aCis, которую вы собираете:
| Ревизия aCis | Требуемый JDK |
|---|---|
| Ниже 381 | JDK 8 |
| 381 до 406 | JDK 11 |
| Выше 406 | JDK 21 |
Текущие публичные ревизии находятся в диапазоне 4xx, так что JDK 21 — современный выбор. Подходят и Liberica JDK 21, и OpenJDK 21. Важная деталь — направить Eclipse и Ant на тот же JDK 21, под который нацелены исходники. Смешивание более нового или более старого JDK, чем ожидает ревизия, — частая причина непонятного вывода сборки.
Получение исходников: публичные ревизии и сборки для сторонников
Начните с публичного репозитория. Клонируйте его в рабочую папку и проверьте номер ревизии в readme или changelog, чтобы знать, с каким JDK и каким набором возможностей вы работаете. Поскольку новые ревизии закрыты поддержкой, публичное дерево может отставать от bleeding edge, и это ожидаемо, а не признак сломанной загрузки.
Если вы поддерживаете живой сервер и зависите от свежих исправлений, ревизии для сторонников — честный путь обновления. Просмотрите changelog на форуме перед решением, потому что некоторые ревизии меняют ключи конфигурации или ожидания к базе данных, и вам захочется запланировать окно обслуживания, а не патчить вслепую.
Импорт и сборка с Ant (и ловушка JDK 21)
Проект поставляется со скриптом Ant build.xml. В Eclipse импортируйте проект aCis_gameserver, дайте ему разрешить jars в lib/, а затем запустите сборку Ant. Результат — l2jserver.jar, который кладётся в папку libs/ gameserver. На Ubuntu 22 или 24 также есть community-установщик, который ставит JDK 21, MariaDB, Apache с PHP и Adminer, и Ant, создаёт пользователя базы данных и обе базы, заполняет установщик и файлы конфигурации, собирает пак и всё раскладывает. Эта автоматизация экономит много времени, хотя вам всё равно стоит прочитать, что именно она меняет.
Гоча сборки, которую стоит знать на современных JDK: на JDK 18 и новее использование Security Manager в Apache Ant выбрасывает ошибку UnsupportedOperationException: Setting a Security Manager is not supported. Это не проблема кода aCis. Чистое решение — использовать свежую версию Eclipse и Ant, чья сборка больше не полагается на устаревший Security Manager. Если вы застряли на старом toolchain, можно передать свойство Ant -Dant.securitymanager.usage.warn=true, чтобы это обойти, но обновление Eclipse — более аккуратное решение.
Если сборка проходит, но сервер не запускается, первое, что нужно проверить, — это JRE в Eclipse. Он должен быть JDK 21, как и исходники, а не более новый JDK, который ваша машина предпочитает по случайности.
Установка баз данных и настройка пака
Установщик базы данных — это database_installer.sh в Linux или соответствующий .bat в Windows. Он создаёт и наполняет базу данных логина и базу данных игры — это две отдельные схемы. Убедитесь, что введённые учётные данные совпадают с пользователем, которого MariaDB настроен принимать, и запустите установщик снова после обновления пака, если ревизия меняет схему.
Вся конфигурация живёт в папке config/:
server.propertiesдля game server: rates, порты и переключатели геймплея.loginserver.propertiesдля login server: работа с аккаунтами и проверка hexid.hexid.txt— файл, который привязывает зарегистрированный game server к login server.geoengine.propertiesдля GeoData, pathfinding и связанных настроек производительности.npcs.properties,players.properties,siege.properties,clans.propertiesиevents.propertiesдля всего остального мира.
Читайте каждый файл перед изменением. Большинство сбоев запуска при первой сборке — это неверные учётные данные базы данных, неверный порт или ключ конфигурации, который переименовала более новая ревизия.
Регистрация hexid, порядок запуска и патч клиента
hexid генерируется, когда вы регистрируете game server, а затем копируется, чтобы login server его принял. Если login server отклоняет game server, виновником почти всегда является hexid: перегенерируйте его, положите туда, где ожидается hexid.txt, и убедитесь, что обе стороны согласованы.
Порядок запуска важен. Сначала поднимите login server, затем game server. Запуск game server раньше login server — надёжный способ увидеть ошибки соединения, не имеющие никакого отношения к вашей реальной конфигурации.
На стороне клиента вам нужен клиент Interlude C6 плюс пропатченная папка system. Классический клиент Interlude использует протокол 746, так что патч должен соответствовать этому протоколу, иначе клиент не сможет подключиться, даже если сервер абсолютно здоров.
Когда сервер запущен, практичный следующий шаг — показать его игрокам. Вы можете разместить его через /addnews, сравнить свои позиции с более широким каталогом в /all-servers и занять более сильное место через /addnews_vip. Работающий пак aCis — это лишь половина дела; понятное размещение в каталоге превращает его в населённый сервер.