Версии документации
Форматы BGIN и обозначения версий
Редактор предлагает четыре режима: ~0.0.2, ~1.6.0, ~3.7.0 и ~5.8.0. Это обозначения вариантов двоичного формата BGIN по образцам Asphalt 8, характерным для времени выхода соответствующих версий игры. Это не версии самого редактора и не обязательный номер игры, которому должен соответствовать файл. Знак ~ подчёркивает приблизительный характер такого ориентира.
Как выбрать режим
При открытии редактор определяет вариант по структуре BGIN. Совпадения расширения, общей сигнатуры или номера APK недостаточно. Вверху показан обнаруженный режим. Обычные Save и Save As сохраняют этот режим. При создании нового файла режим выбирается явно; для смены режима используйте конвертер. Ручная замена поля format в JSON не заменяет конвертацию.
| Обозначение | Какой вариант представляет |
|---|---|
| ~0.0.2 | Ранний вариант с буквальными именами типов и свойств; проверены девять предоставленных BGIN июня 2013 года. |
| ~1.6.0 | Вариант с хешированными именами и прежним каталогом, проверенный на ресурсах A8 1.6.0. |
| ~3.7.0 | Вариант с расширенным каталогом из двух таблиц, встречающийся в исследованных ресурсах A8 3.7.0. |
| ~5.8.0 | Вариант с изменённой записью свойств, дополнительными значениями и цветовыми каналами анимации, встречающийся в исследованных ресурсах A8 5.8.0. |
Идентификаторы в переносимом JSON: a8-0.0.2, a8-1.6.0, a8-3.7.0, a8-5.8.0. Они сохраняются вместе с данными при экспорте и повторной сборке.
Другие версии A8 и другие игры
Можно пробовать открывать BGIN из других версий Asphalt 8, а также из других игр, вышедших примерно в тот же промежуток времени. Общий движок мог использовать один вариант формата в нескольких выпусках. Например, файл из соседнего выпуска может определиться как ~3.7.0, хотя номер самой игры отличается.
Это возможность проверки, а не установленный диапазон совместимости. В разных играх, платформах и каналах распространения формат мог меняться независимо. Редактор принимает файл по его реальной структуре. Неоднозначный формат, неподдерживаемые записи или несогласованный каталог дают ошибку; неизвестные данные нельзя молча удалять ради открытия или сохранения.
Успешное открытие не доказывает, что файл загрузится в другой игре. Типы объектов, свойства, внешние ресурсы и поведение движка также могут отличаться. Сначала работайте с копией, затем проверяйте результат в целевой игре.
Что проверено в 0.6.3
| Полученный набор | Файлы с проверенной независимой пересборкой |
|---|---|
| Ранний вариант ~0.0.2 | 9 предоставленных файлов |
| ~1.6.0 | Исходный основной набор A8 1.6.0 |
| ~3.7.0 | 70 из 74 файлов |
| ~5.8.0, основной GUI | 85 из 96 файлов |
| ~5.8.0, мини-игра из APK | 10 из 13 файлов |
Остальные полученные файлы 3.7.0 и 5.8.0 явно отклоняются: специальные записи второй таблицы ещё не поддержаны; у двух файлов 3.7.0 несогласованный каталог. Это неполное покрытие набора, а не полная поддержка каждой версии игры. Неизвестные имена поддерживаемых записей сохраняются как #1234ABCD; дополнительные значения и цветовые каналы также сохраняются. Их неизвестный смысл редактор не угадывает.
Формат файла, ресурсы и предпросмотр
Это разные уровни совместимости:
- Кодек определяет, можно ли прочитать и сохранить двоичную запись BGIN.
- Конвертер проверяет, представимы ли данные в выбранном целевом формате.
- Картинки и шрифты берутся из ресурсов той же версии.
- Предпросмотр использует поддерживаемую модель компоновки, а не запускает игру.
Новые варианты свойств и цветовые каналы 5.8.0 сохраняются, но их выбор и поведение новым движком пока не воспроизводятся в предпросмотре. Успешная конвертация BGIN не даёт старому движку поддержки ETC2/ASTC или оболочек LZ4/Zstd. Текстуры конвертируются отдельной командой. Загрузка изменённых новых ресурсов игрой пока не проверена.