Skip to main content
Вернуться в блог

Что такое файлы Steam Manifest и Lua: простое объяснение

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

17 авг. 2026 г.SteamTools Team
Что такое файлы Steam Manifest и Lua: простое объяснение

Файл .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 либо скачает неверные файлы, либо прервется с ошибкой на середине процесса.

По этой же причине список популярных игр на сайте обновляется каждые пять минут: игры получают патчи постоянно, и чаще всего рабочая конфигурация ломается именно из-за использования манифеста недельной давности.

Когда генератор не может найти манифест

На это есть три основные причины:

  1. Неверный App ID. Быстрее всего сверить идентификатор через SteamDB.
  2. У приложения есть региональные ограничения. Некоторые издатели открывают доступ к манифестам только для определенных регионов магазина. Сейчас мы используем параметры cc=us&l=english, а поддержка дополнительных регионов уже добавлена в нашу дорожную карту.
  3. Приложение полностью удалено из Steam. Иногда Valve выводит игру из оборота и стирает данные ее депо. В этом случае App ID все еще может определяться, но скачивать с серверов уже нечего.

Если генератор возвращает ошибку, текст сообщения обычно подсказывает, с какой именно из трех причин вы столкнулись. На странице FAQ также собран чек-лист для самых распространенных ошибок.


Источник данных: ManifestHub3 — открытый кэш ключей депо Steam под лицензией MIT, на котором работает этот генератор. Изучайте его, делайте форки или запускайте собственное зеркало.

Попробовать генератор →