Версии документации
Отдельный JSON и создание пустого файла
Эта страница нужна, если вы хотите получить отдельный текстовый .json или создать новый файл. Для открытия и обычного редактирования .bgin достаточно главного редактора.
Получить JSON из BGIN
JSON — текстовое описание экранов, объектов и их свойств. В него удобно копировать правки или передавать структуру интерфейса другим инструментам.
- Нажмите значок Binary GIN в левой вертикальной панели VS Code.
- Выберите направление BGIN → JSON.
- В Source file → Choose… выберите исходный
.bgin. - В Output file → Save as… укажите имя нового
.json. - Нажмите Convert, затем Open result.
Чтобы получить BGIN обратно, выберите JSON → BGIN, укажите исходный JSON и новый файл .bgin, затем нажмите Convert.
Сначала сохраните изменения через Ctrl+S: преобразование читает файлы с диска. Исходный и выходной файл должны быть разными. При замене готового результата редактор запросит подтверждение и сохранит его прежнюю копию рядом с расширением .bak. Если в открытом результате есть несохранённые правки, сначала сохраните или закройте его.
Преобразование использует тот же встроенный модуль BGIN, что и редактор. Картинки и шрифты для этого действия не требуются.
Создать пустой BGIN
В VS Code нажмите Ctrl+Shift+P, найдите BGIN: New File, нажмите Enter и выберите имя и папку нового файла. Ещё одна кнопка — 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", оставьте это поле: оно позволяет сохранить файл в его исходном старом формате. Неизвестные названия типов и свойств тоже сохраняйте. Проверка чтения и записи не означает, что предпросмотр точно повторяет старую игру или что поддержаны все остальные выпуски.