Skip to content

Версии документации

Конвертация BGIN, отдельный JSON и новый файл ​

Эта страница нужна, если вы хотите получить отдельный текстовый .json или создать новый файл. Для открытия и обычного редактирования .bgin достаточно главного редактора.

Получить JSON из BGIN ​

JSON — текстовое описание экранов, объектов и их свойств. В него удобно копировать правки или передавать структуру интерфейса другим инструментам.

  1. Нажмите значок Binary GIN в левой вертикальной панели VS Code.
  2. Выберите направление BGIN → JSON.
  3. В Source file → Choose… выберите исходный .bgin.
  4. В Output file → Save as… укажите имя нового .json.
  5. Нажмите Convert, затем Open result.

Чтобы получить BGIN обратно, выберите JSON → BGIN, укажите исходный JSON и новый файл .bgin, затем нажмите Convert.

Сначала сохраните изменения через Ctrl+S: преобразование читает файлы с диска. Исходный и выходной файл должны быть разными. При замене готового результата редактор запросит подтверждение и сохранит его прежнюю копию рядом с расширением .bak. Если в открытом результате есть несохранённые правки, сначала сохраните или закройте его.

Преобразование использует тот же встроенный модуль BGIN, что и редактор. Картинки и шрифты для этого действия не требуются.

Создать пустой BGIN ​

В VS Code нажмите Ctrl+Shift+P, найдите BGIN: New File, нажмите Enter и выберите имя и папку нового файла, затем режим формата BGIN. Ещё одна кнопка — Create empty BGIN в боковой панели Binary GIN.

Под Windows файл можно создать и в обычной папке: правая кнопка по свободному месту → Создать → Binary GIN. Расширение добавляет этот пункт при локальном запуске в VS Code. Если пункта нет, откройте боковую панель Binary GIN и нажмите Add BGIN to the New menu, затем откройте меню папки заново.

Файл будет пустым. Откройте его в редакторе, задайте название и создайте первый экран. Пустой BGIN разрешено хранить: VS Code показывает предупреждение. Его JSON выглядит как {"screens": []} без name.

Перед удалением расширения нажмите Remove BGIN from the New menu, если хотите убрать пункт из Проводника. Права администратора не нужны. Эта функция создания доступна при работе локально под Windows, а не через SSH, WSL или удалённый контейнер.

Совместимость старых файлов ​

Вариант формата определяется автоматически. Выбирать версию игры в окне ресурсов не нужно. На предоставленном наборе июня 2013 года проверены чтение и сохранение всех девяти файлов, включая widgets.bgin и sprites.bgin.

Если полученный JSON содержит "format": "legacy", оставьте это поле: оно позволяет сохранить файл в его исходном старом формате. Неизвестные названия типов и свойств тоже сохраняйте. Проверка чтения и записи не означает, что предпросмотр точно повторяет старую игру или что поддержаны все остальные выпуски.

Преобразовать BGIN в другой формат ​

  1. В левой панели выберите BGIN → BGIN.
  2. Укажите исходный сохранённый файл и отдельный файл назначения.
  3. В Target BGIN format выберите ~0.0.2, ~1.6.0, ~3.7.0 или ~5.8.0.
  4. Нажмите Convert. Если данные не представимы без потерь, получите ошибку; результат не записывается вместо существующего файла.

Keep source format удерживает исходный режим. Направления BGIN → JSON и JSON → BGIN остаются доступны; JSON несёт поле format вместе с данными. Конвертер читает сохранённый файл, поэтому перед его использованием сохраните нужные правки открытого документа. Для обычного сохранения смена режима не нужна.

Например, дополнительные значения свойства 5.8.0 нельзя молча удалить ради режима 1.6.0. Неизвестные имена поддерживаемых записей сохраняются как #1234ABCD, дополнительные значения — как value с variants, а цветовые каналы — как color_channels. Не заменяйте эти данные выдуманными именами.

Числа режимов обозначают форматы на момент выхода версий A8. Двоичная пересборка не доказывает совместимость с игровым кодом целевого выпуска. Текстуры конвертируются отдельно.