Что такое файлы Steam Manifest и Lua: простое объяснение
Что содержат файлы .manifest и Lua, зачем они нужны SteamTools и как бесплатный генератор собирает их для любого App ID.

Файл .manifest — одна из наименее задокументированных частей экосистемы Steam. Он не является частью официального клиента Steam, не скачивается вместе с игрой, и вы никогда не увидите его в интерфейсе Steam. Но для работы SteamTools он критически необходим. Ниже — краткое объяснение того, что на самом деле находится внутри такого файла.
Что делает файл манифеста
Манифест — это крошечный (обычно 1–4 КБ) текстовый файл, в котором перечислены все депо (depots), составляющие игру в Steam, а также зашифрованный ключ, необходимый SteamTools для обращения к CDN-серверам Steam за этим депо.
Реальный пример (фрагмент) для приложения с одним депо:
"appbuild"
{
"appid" "400"
"name" "Portal"
"buildid" "1234567"
"depots"
{
"400"
{
"manifest" "1234567890abcdef..."
"size" "9876543210"
}
}
}
Длинная шестнадцатеричная строка — это ключ расшифровки депо (depot decryption key). Без него SteamTools не сможет узнать, какие фрагменты игры нужно запрашивать, а CDN Steam просто отклонит запрос.
Почему важно имя файла
SteamTools ищет в своей папке depotcache файлы со строго заданным именем вида <AppID>_<branch>.manifest. Если вы переименуете рабочий манифест из 400_public.manifest в 400-beta.manifest и положите его в каталог другой ветки, SteamTools откажется выполнять установку — имя файла служит индексом.
Именно поэтому наш генератор всегда выдает пару файлов с названием ветки в имени файла. Если вам нужна стандартная ветка public, просто не трогайте поле ветки; если же вам целенаправленно нужна ветка beta или experimental, введите ее название перед нажатием кнопки генерации.
Почему манифест привязан к конкретной игре и ветке
Каждая ветка в Steam (public, beta, experimental, internal и т. д.) получает собственный buildid и собственные ключи расшифровки. У одного и того же App ID может существовать полдюжины разных манифестов — по одному на каждую активную ветку. Скрипт Lua как раз и указывает SteamTools, какой ветке отдавать приоритет, если локально присутствует сразу несколько файлов.
Когда манифесты устаревают
Манифесты привязаны к конкретной сборке (build). Как только для игры выходит обновление, старый манифест становится бесполезным: у новой сборки меняются фрагменты файлов, их размеры и (зачастую) ключи. Если попытаться установить игру по устаревшему манифесту, SteamTools либо скачает неверные файлы, либо прервется с ошибкой на середине процесса.
По этой же причине список популярных игр на сайте обновляется каждые пять минут: игры получают патчи постоянно, и чаще всего рабочая конфигурация ломается именно из-за использования манифеста недельной давности.
Когда генератор не может найти манифест
На это есть три основные причины:
- Неверный App ID. Быстрее всего сверить идентификатор через SteamDB.
- У приложения есть региональные ограничения. Некоторые издатели открывают доступ к манифестам только для определенных регионов магазина. Сейчас мы используем параметры
cc=us&l=english, а поддержка дополнительных регионов уже добавлена в нашу дорожную карту. - Приложение полностью удалено из Steam. Иногда Valve выводит игру из оборота и стирает данные ее депо. В этом случае App ID все еще может определяться, но скачивать с серверов уже нечего.
Если генератор возвращает ошибку, текст сообщения обычно подсказывает, с какой именно из трех причин вы столкнулись. На странице FAQ также собран чек-лист для самых распространенных ошибок.
Источник данных: ManifestHub3 — открытый кэш ключей депо Steam под лицензией MIT, на котором работает этот генератор. Изучайте его, делайте форки или запускайте собственное зеркало.