Об этом проекте

Ark-Unpacker — это инструмент для пакетного извлечения ресурсов игры «Arknights», написанный на Python и распространяемый под лицензией BSD-3. Текущая версия проекта — v5.2; автор объявил о постепенном переходе на более функциональную платформу ArkStudio, после завершения миграции обновления данного проекта будут прекращены. Основные возможности 1. Пакетное извлечение игровых ресурсов из файлов Unity AssetBundle (AB) игры «Arknights». Поддерживается специальный алгоритм распаковки для версий игры v2.5.04 и выше; при распаковке можно различать Spine-модели базовых персонажей, динамических иллюстраций и боевых персонажей; результаты экспорта можно раскладывать по каталогам в соответствии с именами исходных AB-файлов. 2. Пакетное объединение изображений RGB-канала и Alpha-канала. 3. Пакетное декодирование файлов данных FlatBuffers. 4. Одновременно предоставляются два способа работы: интерактивный интерфейс командной строки и прямой вызов через командную строку. Поддерживаемые типы экспортируемых ресурсов: Sprite (PNG), Texture2D (PNG), AudioClip (WAV), TextAsset (текстовые или байтовые данные), Mesh (OBJ), TypeTree (JSON). Порядок использования Перед использованием необходимо получить файлы игровых ресурсов. Ресурсы Android-версии делятся на две части: каталог assets/AB/Android внутри установочного пакета и каталог Bundles, создаваемый при горячем обновлении; после объединения и перезаписи получаются полные ресурсы. В PC-версии исходные ресурсы StreamingAssets/AB/Windows и ресурсы горячего обновления PersistentData/Bundles берутся из каталога Arknights_Data в установочной директории лаунчера Hypergryph. В репозитории предоставлено руководство по поиску ресурсов, помогающее определить, в каком AB-файле находится нужный ресурс. Программа предоставляет исполняемый файл для 64-разрядной Windows, который можно скачать со страницы Releases. Поместите папку для распаковки и программу в один каталог и запустите программу, чтобы войти в интерактивный интерфейс. Режимы работы - Выполнение в один клик: распаковка файлов из каталога, в котором находится программа, и выполнение объединения изображений с экспортом в папки Unpacked_xxxx и Combined_xxxx. В документации не рекомендуется использовать этот режим для распаковки всего каталога игровых ресурсов, так как это может занять слишком много времени и потреблять слишком много ресурсов. - Пользовательская распаковка ресурсов: указание путей ввода и вывода и выбор типа ресурсов. - Пользовательское объединение изображений: объединение RGB-изображений и Alpha-изображений из указанного пути. - Пользовательское декодирование текстовых данных: декодирование файлов данных из указанного каталога. - Пользовательский экспорт Spine-моделей: экспорт моделей анимированных персонажей Spine. - Пользовательское извлечение аудио и видео Criware USM: извлечение аудио и видео из файлов USM. - Инструменты извлечения и сортировки ArkModels и ArkVoice: специализированные функции, требующие ознакомления с отдельной документацией. Использование из командной строки Программа поддерживает прямой вызов через параметры. Параметр режима -m может принимать значения ab (распаковка), cb (объединение изображений), fb (декодирование FlatBuffers), sp (разбор Spine), cu (разбор USM); вход и выход задаются параметрами -i и -o; параметр -d позволяет предварительно удалить существующий выходной каталог; в режиме распаковки можно выбрать типы экспорта с помощью --image, --text, --audio, --spine, --mesh, --typetree, а параметр -g группирует файлы по именам исходных AB-файлов; в режиме USM можно пропустить соответствующую обработку с помощью --no-video и --no-audio; параметр -l задаёт уровень журналирования (от 0 до 4). При запуске без параметра mode программа переходит в интерактивный интерфейс. Примечания Режим выполнения в один клик не распаковывает AB-файлы, находящиеся непосредственно в каталоге программы, а обрабатывает только файлы во вложенных папках. Программа автоматически настраивает многопроцессную стратегию в зависимости от количества ядер CPU и предъявляет определённые требования к производительности CPU и жёсткого диска; на устройствах с низкой конфигурацией работа может быть медленной. После запуска в рабочем каталоге создаются файл конфигурации ArkUnpackerConfig.json и файл журнала ArkUnpackerLogs.log. В репозитории также предоставлены руководство по файлу конфигурации, необходимые базовые знания (изображения RGB-канала и A-канала, анимированные персонажи Spine) и руководство для разработчиков.