Версии документации
Binary GIN Editor
Редактор игровых интерфейсов .bgin для VS Code. Слева вы выбираете экран и его объекты, ниже меняете свойства, справа смотрите результат. Файл .bgin открывается напрямую. Переводить его в JSON перед работой не требуется.
Начиная с 0.6.3 доступны четыре формата BGIN, поиск экранов с группировкой по префиксам и количеством объектов, разнесённый просмотр открытого экрана и отсечение перекрывающих объектов. MCP работает с живыми документами VS Code и несколькими клиентами. Ресурсы можно подключать из части распакованной zdata, а текстуры конвертируются отдельно.
MCP теперь входит в VSIX: Python и отдельная установка адаптера не нужны. Скопируйте настройки подключения в левой панели.
Что понадобится
- VS Code версии 1.105 или новее.
- Файл
bgin-editor-0.6.3-<платформа>.vsix. Он включает модуль чтения, сохранения и предпросмотра BGIN. Устанавливать Python и менятьPATHне нужно. - Для предпросмотра с игровыми картинками и шрифтами нужны ресурсы.
Выберите пакет для среды, где работает расширение
| Среда | Суффикс файла |
|---|---|
| Windows x64 / ARM64 | win32-x64 / win32-arm64 |
| macOS Intel / Apple Silicon | darwin-x64 / darwin-arm64 |
| Linux с glibc, x64 / ARM64 / ARMv7 с аппаратной плавающей точкой | linux-x64 / linux-arm64 / linux-armhf |
| Alpine Linux с musl, x64 / ARM64 | alpine-x64 / alpine-arm64 |
При работе через WSL, SSH или Dev Containers ориентируйтесь на ОС и архитектуру удалённой среды, где открыта рабочая область. Сборки Linux рассчитаны на glibc 2.36 и новее, сборки Alpine — на Alpine 3.23 и новее. Для редактора нужен VS Code с нативной средой выполнения расширений.
Скачайте подходящий VSIX из релиза 0.6.3 на GitHub.
1. Установите расширение
- Если вы получили ZIP, распакуйте его. Если есть
Preview.code-workspace, оставьте его рядом с папкойresources. - В VS Code откройте Extensions → … → Install from VSIX… и выберите VSIX для вашей платформы. В удалённом окне установите расширение в ту среду, где открыта рабочая область.
- Если VS Code предложит перезагрузить окно, согласитесь.
Результат — Binary GIN Editor появился среди установленных расширений.
2. Откройте рабочую область
Если комплект содержит Preview.code-workspace, откройте его через File → Open Workspace from File…. Пути к ресурсам уже заданы. С собственными файлами откройте их папку и при необходимости укажите ресурсы. Если вы доверяете содержимому папки, подтвердите доверие в VS Code.
3. Откройте файл в Binary GIN
- В списке файлов слева откройте
resources/guiи выберите нужный.bgin. Свой файл можно открыть через File → Open File…. - Если вместо редактора появился текст, нажмите правой кнопкой по вкладке открытого файла → Reopen Editor With… → Binary GIN. Чтобы запомнить выбор для
.bgin, в списке редакторов используйте Configure default editor for '*.bgin'… и выберите Binary GIN. - При первом открытии прочитайте условия использования и нажмите I agree to the terms. Закрытие окна не означает согласия.
Результат: появилось дерево экранов и объектов. Окно с условиями появляется после успешного чтения файла.
4. Покажите интерфейс и сделайте первую правку
- Нажмите кнопку с именем экрана над деревом, найдите экран в окне выбора и нажмите Open.
- Нажмите Refresh справа. Если панель изображения скрыта, сначала нажмите Preview вверху.
- Выберите объект в дереве и измените нужное свойство под ним.
- Нажмите Refresh, чтобы увидеть изменение, и Ctrl+S (на macOS ⌘S), чтобы сохранить файл.
Результат: справа появился предпросмотр. Он обновляется по кнопке Refresh. Папки ресурсов уже настроены в Preview.code-workspace. Если вы открыли только файл без этого рабочего пространства, укажите папки через Resources.
Интерфейс редактора по умолчанию английский. Русский можно включить в Editor settings → Interface language → Русский. Названия кнопок в этом руководстве приведены для английского интерфейса.
Дальнейшая работа
- Изменить объект, создать экран, скопировать часть интерфейса.
- Настроить изображение, масштаб и показ выбранного объекта.
- Подключить свои картинки, шрифты и BGIN.
- Выбрать формат и преобразовать BGIN или JSON.
- Подключить MCP и контролировать правки модели.
- Понять обозначения форматов и границы совместимости.
- Файл открылся текстом, write EOF и другие проблемы.
Сохраняйте копию исходного файла перед заменой его в игре. Предпросмотр показывает расположение объектов, текст и картинки, но не запускает действия игровых кнопок. Он может отличаться от изображения в игре. Обозначения ~0.0.2…~5.8.0 относятся к форматам BGIN на момент выхода соответствующих версий A8. Можно пробовать файлы соседних версий и других игр того же периода; это не гарантия совместимости. Специальные записи части новых BGIN пока не поддержаны.