Skip to content

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

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 / ARM64win32-x64 / win32-arm64
macOS Intel / Apple Silicondarwin-x64 / darwin-arm64
Linux с glibc, x64 / ARM64 / ARMv7 с аппаратной плавающей точкойlinux-x64 / linux-arm64 / linux-armhf
Alpine Linux с musl, x64 / ARM64alpine-x64 / alpine-arm64

При работе через WSL, SSH или Dev Containers ориентируйтесь на ОС и архитектуру удалённой среды, где открыта рабочая область. Сборки Linux рассчитаны на glibc 2.36 и новее, сборки Alpine — на Alpine 3.23 и новее. Для редактора нужен VS Code с нативной средой выполнения расширений.

Скачайте подходящий VSIX из релиза 0.6.3 на GitHub.

1. Установите расширение ​

  1. Если вы получили ZIP, распакуйте его. Если есть Preview.code-workspace, оставьте его рядом с папкой resources.
  2. В VS Code откройте Extensions → … → Install from VSIX… и выберите VSIX для вашей платформы. В удалённом окне установите расширение в ту среду, где открыта рабочая область.
  3. Если VS Code предложит перезагрузить окно, согласитесь.

Результат — Binary GIN Editor появился среди установленных расширений.

2. Откройте рабочую область ​

Если комплект содержит Preview.code-workspace, откройте его через File → Open Workspace from File…. Пути к ресурсам уже заданы. С собственными файлами откройте их папку и при необходимости укажите ресурсы. Если вы доверяете содержимому папки, подтвердите доверие в VS Code.

3. Откройте файл в Binary GIN ​

  1. В списке файлов слева откройте resources/gui и выберите нужный .bgin. Свой файл можно открыть через File → Open File….
  2. Если вместо редактора появился текст, нажмите правой кнопкой по вкладке открытого файла → Reopen Editor With… → Binary GIN. Чтобы запомнить выбор для .bgin, в списке редакторов используйте Configure default editor for '*.bgin'… и выберите Binary GIN.
  3. При первом открытии прочитайте условия использования и нажмите I agree to the terms. Закрытие окна не означает согласия.

Результат: появилось дерево экранов и объектов. Окно с условиями появляется после успешного чтения файла.

4. Покажите интерфейс и сделайте первую правку ​

  1. Нажмите кнопку с именем экрана над деревом, найдите экран в окне выбора и нажмите Open.
  2. Нажмите Refresh справа. Если панель изображения скрыта, сначала нажмите Preview вверху.
  3. Выберите объект в дереве и измените нужное свойство под ним.
  4. Нажмите Refresh, чтобы увидеть изменение, и Ctrl+S (на macOS ⌘S), чтобы сохранить файл.

Результат: справа появился предпросмотр. Он обновляется по кнопке Refresh. Папки ресурсов уже настроены в Preview.code-workspace. Если вы открыли только файл без этого рабочего пространства, укажите папки через Resources.

Интерфейс редактора по умолчанию английский. Русский можно включить в Editor settings → Interface language → Русский. Названия кнопок в этом руководстве приведены для английского интерфейса.

Дальнейшая работа ​

Сохраняйте копию исходного файла перед заменой его в игре. Предпросмотр показывает расположение объектов, текст и картинки, но не запускает действия игровых кнопок. Он может отличаться от изображения в игре. Обозначения ~0.0.2…~5.8.0 относятся к форматам BGIN на момент выхода соответствующих версий A8. Можно пробовать файлы соседних версий и других игр того же периода; это не гарантия совместимости. Специальные записи части новых BGIN пока не поддержаны.