Версии документации
Картинки, шрифты и настройки
Для предпросмотра редактору нужны ресурсы — картинки, шрифты и файлы с их описаниями. Сам .bgin часто хранит только ссылки на них.
Если у вас полный комплект редактора
В комплекте есть папка resources. В VS Code выберите File → Open Workspace from File… и откройте Preview.code-workspace из той же папки. Пути уже заполнены. Откройте BGIN и нажмите Refresh.
Оставьте resources рядом с Preview.code-workspace. Если хотите перенести комплект, перенесите их вместе. Открытие одной папки gui вместо рабочего пространства не загружает эти готовые настройки.
Если вы используете свои ресурсы
Используйте ресурсы той версии игры, из которой взят редактируемый файл.
- Откройте
.bginв Binary GIN и нажмите Resources вверху справа. - Внизу окна, возле Extracted archive folder, нажмите Browse… и выберите папку, внутри которой лежат
gui,textures_androidиtexter_fonts. - Нажмите Auto-fill. Редактор попробует сам найти нужные папки.
- Проверьте заполненные пути по таблице ниже. Если что-то не найдено, укажите нужную папку через Browse… рядом с соответствующим полем.
- Нажмите Save folders, закройте окно и нажмите Refresh.
| Поле в окне | Какую папку выбрать |
|---|---|
| Resource root | Общую папку ресурсов, в которой лежат остальные папки. В комплекте это resources. |
| BGIN folder | Папку gui. В ней должны быть, в частности, widgets.bgin со стилями текста и sprites.bgin с описаниями картинок и анимаций. |
| Textures folder | Папку textures_android с картинками. Сохраняйте также файлы с __alpha в имени: они задают прозрачность. |
| Fonts folder | Папку texter_fonts со шрифтами. |
Папки могут называться иначе: выбирайте их по содержимому. BGIN folder принимает сразу папку, отдельные файлы добавлять по одному не нужно. Save folders запоминает пути; файлы при этом остаются на своих местах.
Например, ссылка TextStyle: /Widgets/MM_White_Text означает: взять стиль MM_White_Text из документа с внутренним названием Widgets. Поэтому для текста нужен соответствующий widgets.bgin, а для картинок — sprites.bgin вместе с самими текстурами. Простое переименование файла не меняет это внутреннее название.
Если чего-то не хватает
Откройте 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. |