Лаунчер Lineage 2: патчи без переустановки клиента

Лаунчер Lineage 2 делает три вещи: проверяет файлы клиента у игрока, скачивает отсутствующие или устаревшие и запускает system\L2.exe. Всё остальное, что он показывает, от новостей до кнопок Discord, это обёртка вокруг этих трёх задач. Налажен цикл обновления — патчи становятся рутиной. Сломан — каждое изменение контента превращается в «переустанови клиент» для нескольких сотен человек.
Дальше: цикл обновления, два формата манифеста, которые всё ещё используются, где лежат пакеты на веб-сервере и какие сбои видны только в ночь запуска.
Что лаунчер на самом деле проверяет
Лаунчер сравнивает локальные файлы игрока со списком, опубликованным сервером. В каждой записи путь, размер и контрольная сумма. Хеш совпал — файл актуален. Не совпал — лаунчер скачивает новую копию и заменяет. Это весь механизм, будь то L2Updater.exe 2008 года или лаунчер на .NET 8, написанный в прошлом месяце.
Три вещи отделяют рабочую версию от раздражающей:
- Критические файлы. Небольшой набор файлов должен быть актуален, иначе игра не запустится: клиент с другим протоколом отключается на логине. Помечайте их обязательными и блокируйте кнопку запуска, пока они не обновятся.
- Сжатие. Файлы патча нужно сжимать и распаковывать на лету. Сырой патч на несколько сотен текстур это несколько сотен мегабайт.
- Видимая версия. Когда игрок сообщает о баге, первый вопрос — какая сборка лаунчера и какая ревизия патча у него стоит. Если лаунчер этого не показывает, поддержка превращается в гадание.

Два формата манифеста: хеш с JSON или построчные контрольные суммы
Работают оба. Разница в том, сколько вам придётся программировать самому.
| Подход | Как работает | Кому подходит |
|---|---|---|
| Современный манифест | Удалённый манифест перечисляет каждый файл с хешем. Лаунчер сравнивает, качает только отличия, а отдельная утилита собирает полный и инкрементальный пакеты. Открытый проект l2-launcher-custom устроен именно так: лаунчер на .NET 8, сравнение по хешу, ручной Full Check и PatchBuilder, который создаёт файлы .bz2, манифест files.xml и эндпоинт download.php. | Новые серверы и те, кому не сложно публиковать небольшое .NET-приложение. |
| Классический updates.lst | Текстовый файл, по строке на файл: путь, CRC, размер и флаг обязательности. Оригинальный формат L2Updater использовал строки вида F1=l2text\help.htm|<crc>|<size>|n под заголовком, с собственной записью вроде IAM=L2Updater.exe|<crc>|<size>, чтобы лаунчер мог обновлять сам себя. Утилита-генератор собирает пакет и список. | Паки эпохи Interlude или команды, которым достался уже работающий лаунчер. |
У классического формата есть один приём, о котором стоит знать: флаг ModifyHost, который при первом запуске прописывает l2authd.lineage2.com на IP вашего логин-сервера в файле hosts Windows. Игроку не нужно править файл руками, но лаунчеру нужны права на запись в hosts, из-за чего некоторые антивирусы начинают ругаться.
Упаковка: полная установка и инкрементальный патч это разные продукты
Нужны два артефакта, и они не взаимозаменяемы:
- Полный пакет клиента. Всё целиком, у современного клиента обычно около 10 ГБ, для тех, у кого ничего нет.
- Пакет патча. Только файлы, изменившиеся с прошлой версии, для тех, кто уже на предыдущей сборке.
Собирайте патч сравнением двух сборок папки клиента, а не по памяти о том, какие файлы правили. Разница важна: файл, который вы изменили и откатили, всё равно уедет, а текстура, заменённая другим инструментом, будет пропущена. Храните манифест каждой версии, чтобы делать дельту между любыми двумя, и держите последний полный пакет онлайн постоянно.
Сохраняйте структуру папок внутри архива. Патч, который распаковываетsystemв корень клиента вместо заменыclient\system, оставляет по две копии всего, и клиент при этом запускается, из-за чего баг выглядит случайным.
Всегда включайте критические файлы в каждый патч, даже если они не менялись. Это стоит несколько мегабайт и чинит клиентов, сломанных предыдущим неполным обновлением.

Где пакеты лежат на веб-сервере
Каталог updater это статический файловый хостинг с манифестом рядом. Его может отдавать ваш сайт, а может и простой каталог nginx:
/updater/
files.xml
download.php
system/
textures/
maps/
...
- Отдавайте по HTTPS. Лаунчер, качающий исполняемые файлы по открытому HTTP, это man-in-the-middle, который только ждёт своего часа.
- Ждите пиков трафика. Пуш патча отправляет одни и те же сотни мегабайт всем, кто онлайн. Если updater делит канал с игровым сервером, игроки почувствуют патч как лаг, поэтому держите их на разных хостах, когда можете.
- Кешируйте полный пакет, но никогда манифест. Манифест должен отдаваться с заголовками no-cache, чтобы клиенты не сравнивали себя со старым списком.
Целостность клиента и ложные срабатывания антивируса
Две проблемы приходят вместе с публикацией лаунчера:
- Игроки с изменённым клиентом. Проверка хешей ловит изменённые и подменённые файлы. Если нужно больше, некоторые лаунчеры ставят в клиент небольшую DLL для проверки целостности и базового поиска читов. Решите до запуска, готовы ли вы за это отвечать: опытный читер снимает такую защиту первым делом.
- Предупреждения антивируса. Исполняемый файл, который пишет внутрь папки игры, выглядит подозрительно для эвристики. Крупные серверы публикуют понятную заметку с просьбой добавить папку игры в исключения, и некоторые всё равно получают метку после каждой пересборки. Подпись бинарника снижает шум, но не убирает его.
Лаунчерам с самообновлением нужна собственная проверка хеша, иначе изменённый лаунчер можно распространить игрокам как «обновление». Держите запись самого лаунчера в манифесте и отказывайтесь запускаться, если она не совпадает.
Сбой, который никто не отлаживает: другой протокол
Лаунчер может обновиться идеально и всё равно оставить игроков без входа, потому что доставленный клиент говорит на другом протоколе, чем принимает сервер. Настройка AllowedProtocolRevisions перечисляет ревизии, с которыми сервер будет работать, например 267;268;271;273 для сборки High Five. Если папка system клиента на другом протоколе, симптом это экран логина и следом отключение без полезной ошибки.
Зафиксируйте точную сборку клиента, на которой основан ваш патч, отправляйте эту папку system в каждом полном пакете и считайте клиент из другого источника неподдерживаемым. Руководство по системным файлам клиента объясняет, как проверяется ревизия и какие файлы трогать нельзя.
Чек-лист дня запуска
- Сделайте Full Check на чистой установке и запустите игру из лаунчера. Дважды, на разных машинах.
- Измените один файл на сервере, пересоберите манифест и убедитесь, что лаунчер забирает именно этот файл и ничего кроме.
- Оборвите скачивание на середине. Лаунчер должен восстановиться, а не оставить повреждённый файл, проходящий проверку размера.
- Проверьте на машине со свежеустановленным антивирусом: это ближайшее к опыту нового игрока.
- Опубликуйте ручное скачивание патча для тех, у кого лаунчер просто не идёт. Такие есть всегда.
Когда патч работает, сделайте так, чтобы его скачали
Лаунчер полезен только тем, у кого клиент уже установлен. Для остальных вход это ваш листинг. Поставьте сервер перед игроками, которые ищут по хронике и рейтам, с бесплатным листингом на L2Calendar, а если нужен верх категории в день открытия, VIP-размещение это платный вариант. Руководство по сайту сервера разбирает страницу скачивания и регистрацию, на которые опирается лаунчер.
