Skip to content

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

Картинки, шрифты и настройки ​

Для предпросмотра редактору нужны ресурсы — картинки, шрифты и файлы с их описаниями. Сам .bgin часто хранит только ссылки на них.

Если у вас полный комплект редактора ​

В комплекте есть папка resources. В VS Code выберите File → Open Workspace from File… и откройте Preview.code-workspace из той же папки. Пути уже заполнены. Откройте BGIN и нажмите Refresh.

Оставьте resources рядом с Preview.code-workspace. Если хотите перенести комплект, перенесите их вместе. Открытие одной папки gui вместо рабочего пространства не загружает эти готовые настройки.

Если вы используете свои ресурсы ​

Используйте ресурсы той версии игры, из которой взят редактируемый файл.

  1. Откройте .bgin в Binary GIN и нажмите Resources вверху справа.
  2. В Source layout выберите Extracted archive, затем через Browse… выберите папку, внутри которой лежат gui, textures_android и texter_fonts.
  3. Нажмите Auto-fill. Редактор попробует сам найти нужные папки.
  4. Проверьте заполненные пути по таблице ниже. Если что-то не найдено, укажите нужную папку через Browse… рядом с соответствующим полем.
  5. Нажмите Save folders, закройте окно и нажмите Refresh.
Поле в окнеКакую папку выбрать
Resource rootОбщую папку ресурсов, в которой лежат остальные папки. В комплекте это resources.
BGIN folderПапку gui. В ней должны быть, в частности, widgets.bgin со стилями текста и sprites.bgin с описаниями картинок и анимаций.
Textures folderПапку с картинками, ZIP-вариантами JPK или корень assetpacks. Сохраняйте также файлы с __alpha в имени: они задают прозрачность.
Fonts folderПапку texter_fonts со шрифтами.

Папки могут называться иначе: выбирайте их по содержимому. BGIN folder принимает сразу папку, отдельные файлы добавлять по одному не нужно. Save folders запоминает пути; файлы при этом остаются на своих местах.

Например, ссылка TextStyle: /Widgets/MM_White_Text означает: взять стиль MM_White_Text из документа с внутренним названием Widgets. Поэтому для текста нужен соответствующий widgets.bgin, а для картинок — sprites.bgin вместе с самими текстурами. Простое переименование файла не меняет это внутреннее название.

Часть распакованной zdata / Play Asset Delivery ​

Для новых ресурсов выберите Source layout → Unpacked zdata / Play Asset Delivery, затем папку zdata, files, assetpacks либо конкретную assets/data. Нажмите Auto-fill, проверьте найденные пути и сохраните их. Версия и ревизия берутся из структуры выбранных папок, а не из режима BGIN. При нескольких версиях common_pack выберите конкретную папку или задайте пути вручную.

text
zdata/
  files/assetpacks/
    common_pack/<версия>/<ревизия>/assets/data/
      gui/
      texter_fonts/
    textures_pack1/<версия>/<ревизия>/assets/data#tcf_astc/
      textures1.jpk

Полный архив игры не нужен. Достаточно нужных BGIN с их определениями (обычно widgets.bgin и sprites.bgin), используемых текстур с альфа-масками и шрифтов. Можно оставить лишь нужные папки или выбрать их независимо вручную. Не найденные при автозаполнении поля сохраняют уже введённые пути: проверьте их.

ZIP-варианты JPK читаются по запросу без распаковки всего архива. Исходники не меняются. Два совпадающих имени текстуры в разных пакетах дают ошибку: оставьте один согласованный набор версии и GPU-варианта. Наличие всего пакета не означает, что все его файлы нужны для конкретного экрана.

В исследованной 5.8.0 основной GUI находится в common_pack, а текстуры — в textures_pack*. Play Asset Delivery может хранить их во внутреннем хранилище приложения; путь меняется между выпусками. Отсутствие OBB в Android/obb не означает отсутствия ресурсов. На закрытом устройстве используйте уже доступную распакованную копию; готовая папка установщика также подходит.

Конвертация текстур отдельно ​

Сохранение BGIN и смена его формата не конвертируют текстуры. Команда BGIN: Convert Texture Separately в палитре команд предлагает исходную PVR-текстуру (она может иметь расширение .tga) и отдельный файл назначения для режима ~1.6.0:

  • Remove outer compression снимает дополнительную оболочку, сохраняя GPU-блоки и уровни mip. ETC2/ASTC для старого режима этим способом отклоняются.
  • RGBA8 декодирует все уровни mip в несжатые пиксели; размер увеличивается.

Отдельную альфа-текстуру конвертируйте отдельным вызовом. Исходник не заменяется. Предпросмотр понимает поддерживаемые PVR с ETC2/ASTC и LZ4/старым Zstd, но это не даёт старой игре возможности их читать. Путь PVR движка 1.6.0 не читает эти новые оболочки и GPU-форматы. Это не утверждение об отсутствии любого ETC2 во всех путях загрузки движка. Загрузка перекодированных ресурсов игрой пока не проверена.

Если чего-то не хватает ​

Откройте View → Problems: VS Code покажет, какой файл не найден. Под изображением есть Render notes с замечаниями предпросмотра. Исправьте путь или добавьте нужный файл и снова нажмите Refresh. Если окно редактора не открывается, см. решение проблем.

Язык и справка ​

Editor settings → Interface language переключает английский и русский язык кнопок редактора. Синие кнопки Editor guide, GIN documentation и значки справки у объектов открывают документацию на выбранном языке. Кнопка Terms of use в настройках повторно открывает условия использования.

Font language в предпросмотре выбирает вариант игрового шрифта. Это отдельная настройка: она не переводит текст интерфейса или строки вида $STR_….

Если нужно задать настройки через VS Code

Нажмите Ctrl+, и найдите нужный ключ. Для обычной работы достаточно кнопок редактора.

КлючДля чего нужен
bgin.languageen или ru: язык редактора.
bgin.resourceFoldersПути, сохранённые через Resources. Относительные пути задаются от папки проекта VS Code; без открытого проекта — от папки BGIN.
bgin.previewНачальные настройки предпросмотра. У открывавшегося ранее редактора могут быть свои сохранённые значения.
bgin.windowsExplorerNewFileВключает создание пустого BGIN через Проводник Windows.