Skip to content

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

Это Binary GIN Editor 0.5.0. Основная версия — Binary GIN Editor 0.6.3.

Binary GIN Editor ​

Редактор игровых интерфейсов .bgin для VS Code. Слева вы выбираете экран и его объекты, ниже меняете свойства, справа смотрите результат. Файл .bgin открывается напрямую. Переводить его в JSON перед работой не требуется.

Что понадобится ​

  • VS Code версии 1.105 или новее.
  • Файл bgin-editor-0.5.0-<платформа>.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.5.0 на 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. Выберите экран в списке Screen над деревом.
  2. Нажмите Refresh справа. Если панель изображения скрыта, сначала нажмите Preview вверху.
  3. Выберите объект в дереве и измените нужное свойство под ним.
  4. Нажмите Refresh, чтобы увидеть изменение, и Ctrl+S (на macOS ⌘S), чтобы сохранить файл.

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

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

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

Сохраняйте копию исходного файла перед заменой его в игре. Предпросмотр показывает расположение объектов, текст и картинки, но не запускает действия игровых кнопок. Он может отличаться от изображения в игре. Основной проверенный набор — Asphalt 8 1.6.0; также проверено чтение и сохранение девяти предоставленных файлов июня 2013 года. Это не гарантирует поддержку всех версий и других игр.