Версии документации
Картинки, шрифты и настройки
Для предпросмотра редактору нужны ресурсы — картинки, шрифты и файлы с их описаниями. Сам .bgin часто хранит только ссылки на них.
Если у вас полный комплект редактора
В комплекте есть папка resources. В VS Code выберите File → Open Workspace from File… и откройте Preview.code-workspace из той же папки. Пути уже заполнены. Откройте BGIN и нажмите Refresh.
Оставьте resources рядом с Preview.code-workspace. Если хотите перенести комплект, перенесите их вместе. Открытие одной папки gui вместо рабочего пространства не загружает эти готовые настройки.
Если вы используете свои ресурсы
Используйте ресурсы той версии игры, из которой взят редактируемый файл.
- Откройте
.bginв Binary GIN и нажмите Resources вверху справа. - В Source layout выберите Extracted archive, затем через Browse… выберите папку, внутри которой лежат
gui,textures_androidиtexter_fonts. - Нажмите Auto-fill. Редактор попробует сам найти нужные папки.
- Проверьте заполненные пути по таблице ниже. Если что-то не найдено, укажите нужную папку через Browse… рядом с соответствующим полем.
- Нажмите 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 выберите конкретную папку или задайте пути вручную.
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.language | en или ru: язык редактора. |
bgin.resourceFolders | Пути, сохранённые через Resources. Относительные пути задаются от папки проекта VS Code; без открытого проекта — от папки BGIN. |
bgin.preview | Начальные настройки предпросмотра. У открывавшегося ранее редактора могут быть свои сохранённые значения. |
bgin.windowsExplorerNewFile | Включает создание пустого BGIN через Проводник Windows. |