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
Файл является обычным текстовым документом, поэтому открывается любым текстовым редактором:
- Перейти в папку игры в библиотеке Steam.
- Найти файл
InstallScript.vdfв корне каталога. - Открыть его через Блокнот, Notepad++, VS Code или другой редактор.
- При необходимости изменить содержимое и сохранить файл.
Для изменения скриптовых команд потребуется отредактировать отдельный файл с директивами (обычно installscript.vdf в подкаталоге scripts).
¶Редактирование и ограничения
Изменение InstallScript.vdf возможно, но имеет ряд ограничений:
- Steam-клиент проверяет целостность файлов игры; при обнаружении изменений файл будет восстановлен из манифеста.
- Для сохранения изменений требуется отключение проверки целостности или использование отдельных инструментов.
- Изменение скриптов может привести к некорректной работе игры или нарушению её функциональности.
¶Применение
InstallScript.vdf активно используется в старых играх, которые требуют установки дополнительных компонентов или записи данных в реестр. Механизм также применяется в модификациях и пользовательских сборках, где требуется автоматизация установочных действий.
¶Интересные факты
- Формат VDF используется Valve не только для InstallScript, но и для конфигурации серверов, настроек Steam-клиента и описания пакетов.
- В некоторых играх InstallScript.vdf содержит команды установки модов или дополнений.
- Файл может быть зашифрован или сжат в старых сборках, что затрудняет его ручное редактирование.
¶Источники
- Документация Valve Developer Community: InstallScript
- Valve Developer Community: Valve Data Format (VDF)
- Steamworks Documentation: Steamworks SDK
