Открыть сервисСервис

InstallScript.vdf в Steam: назначение и формат

InstallScript.vdf — текстовый файл в формате Valve Data Format (VDF), который используется в цифровой дистрибуции Steam для автоматического выполнения установочных действий при первом запуске игры. Файл содержит команды, управляющие созданием ярлыков на рабочем столе, регистрацией библиотек, записью в реестр Windows и другими операциями, которые обычно выполняются установщиком.

Назначение

Steam распаковывает игры в библиотеку Steam без классического установщика (MSI, NSIS). Чтобы воспроизвести поведение традиционных установщиков, Valve внедрила механизм InstallScript — набор скриптовых команд, которые Steam-клиент исполняет в момент первой установки или первого запуска игры. Скрипты позволяют:

  • создавать ярлыки на рабочем столе и в меню «Пуск»;
  • регистрировать библиотеки DLL в реестре Windows;
  • устанавливать зависимости (например, DirectX, Visual C++ Redistributable);
  • писать данные в реестр (пути к игре, настройки);
  • запускать внешние установщики компонентов.

Для большинства игр InstallScript не требуется: Steam использует стандартную схему распаковки. Файл применяется в основном для старых проектов и игр, которые изначально распространялись через классические установщики.

Формат VDF

VDF — простой текстовый формат с иерархической структурой, разработанный Valve. Синтаксис напоминает INI, но поддерживает вложенные блоки. Структура InstallScript.vdf выглядит так:

`` "InstallScript" { "1" { "BuildId" "123456" "Script" "installscript.vdf" } } ``

Основные элементы синтаксиса:

  • ключи и значения заключаются в двойные кавычки;
  • блоки объявляются фигурными скобками;
  • комментарии начинаются с символа //;
  • имена ключей нечувствительны к регистру.

Структура InstallScript

Типичный InstallScript.vdf содержит несколько разделов:

РазделНазначение
InstallScriptКорневой блок, содержит версию и идентификатор
1Номер шага установки
BuildIdИдентификатор сборки игры
ScriptПуть к файлу со скриптовыми командами

Скриптовые команды задаются в отдельном файле (обычно installscript.vdf или installscript.txt) и используют специальные директивы Steam, например:

  • CreateShortcut — создание ярлыка;
  • WriteRegistry — запись в реестр;
  • RunProcess — запуск внешнего процесса;
  • AddToPath — добавление каталога в переменную PATH.

Где находится файл

InstallScript.vdf располагается в корне папки игры в библиотеке Steam. Путь по умолчанию:

`` C:\Program Files (x86)\Steam\steamapps\common\<Название игры>\InstallScript.vdf ``

Для пользователей Linux и macOS файл имеет схожую структуру, но директивы, связанные с реестром Windows, игнорируются.

Как открыть InstallScript.vdf

Файл является обычным текстовым документом, поэтому открывается любым текстовым редактором:

  1. Перейти в папку игры в библиотеке Steam.
  2. Найти файл InstallScript.vdf в корне каталога.
  3. Открыть его через Блокнот, Notepad++, VS Code или другой редактор.
  4. При необходимости изменить содержимое и сохранить файл.

Для изменения скриптовых команд потребуется отредактировать отдельный файл с директивами (обычно installscript.vdf в подкаталоге scripts).

Редактирование и ограничения

Изменение InstallScript.vdf возможно, но имеет ряд ограничений:

  • Steam-клиент проверяет целостность файлов игры; при обнаружении изменений файл будет восстановлен из манифеста.
  • Для сохранения изменений требуется отключение проверки целостности или использование отдельных инструментов.
  • Изменение скриптов может привести к некорректной работе игры или нарушению её функциональности.

Применение

InstallScript.vdf активно используется в старых играх, которые требуют установки дополнительных компонентов или записи данных в реестр. Механизм также применяется в модификациях и пользовательских сборках, где требуется автоматизация установочных действий.

Интересные факты

  • Формат VDF используется Valve не только для InstallScript, но и для конфигурации серверов, настроек Steam-клиента и описания пакетов.
  • В некоторых играх InstallScript.vdf содержит команды установки модов или дополнений.
  • Файл может быть зашифрован или сжат в старых сборках, что затрудняет его ручное редактирование.

Источники

Заметили ошибку или не согласны с информацией в статье? Напишите нам support@bfometr.ru