ark-unpacker

Ark-Unpacker es una herramienta de descompresión por lotes de recursos del juego Arknights, escrita en Python y distribuida bajo licencia de código abierto BSD-3. La versión actual del proyecto es v5.2 y el autor ha anunciado que migrará gradualmente a la plataforma ArkStudio, más completa en funcionalidades; este proyecto dejará de actualizarse una vez completada la migración. Funciones principales 1. Descomprime por lotes objetos de recursos del juego desde archivos Unity AssetBundle (AB) de Arknights. Admite el algoritmo especial de descompresión para la versión de juego v2.5.04 y superiores; durante la descompresión puede distinguir entre archivos de modelos Spine de personajes de base, retratos animados y personajes de combate; los resultados exportados pueden organizarse en directorios según el nombre del AB de origen. 2. Fusiona por lotes imágenes de canal RGB con imágenes de canal Alpha. 3. Decodifica por lotes archivos de datos FlatBuffers. 4. Ofrece tanto una interfaz de línea de comandos interactiva como la invocación directa mediante parámetros de línea de comandos. Los tipos de recursos compatibles con la exportación incluyen: Sprite (PNG), Texture2D (PNG), AudioClip (WAV), TextAsset (texto o datos binarios), Mesh (OBJ), TypeTree (JSON). Flujo de uso Antes de usarlo es necesario obtener los archivos de recursos del juego. En Android, los recursos se dividen en el directorio assets/AB/Android dentro del paquete de instalación y el directorio Bundles generado por las actualizaciones en caliente; tras combinarlos y sobrescribirlos se obtienen los recursos completos. En PC, se obtienen desde Arknights_Data en el directorio de instalación del lanzador de Hypergryph los recursos iniciales en StreamingAssets/AB/Windows y los recursos de actualización en caliente en PersistentData/Bundles. El repositorio incluye un documento guía para localizar recursos que ayuda a identificar el archivo AB en el que se encuentra un recurso concreto. El programa ofrece un ejecutable para Windows de 64 bits, descargable desde la página de Releases. Basta con colocar la carpeta a descomprimir en el mismo directorio que el programa y ejecutarlo para acceder a la interfaz interactiva. Modos de trabajo - Ejecución con un clic: descomprime los archivos del directorio donde se encuentra el programa y realiza la fusión de imágenes, exportando a las carpetas Unpacked_xxxx y Combined_xxxx. La documentación advierte que no se recomienda usarlo para descomprimir todo el directorio de recursos del juego, para evitar tiempos excesivos y un consumo elevado de recursos. - Descompresión personalizada de recursos: especifica rutas de entrada y salida y selecciona el tipo de recurso. - Fusión personalizada de imágenes: fusiona las imágenes RGB y Alpha de una ruta especificada. - Decodificación personalizada de datos de texto: decodifica los archivos de datos de un directorio especificado. - Exportación personalizada de modelos Spine: exporta modelos de personajes animados Spine. - Extracción personalizada de audio y vídeo Criware USM: extrae audio y vídeo de archivos USM. - Herramientas de extracción y clasificación ArkModels y ArkVoice: funciones personalizadas que requieren consultar documentación específica. Uso desde línea de comandos El programa admite la invocación directa mediante parámetros. El parámetro de modo -m puede ser ab (descompresión), cb (fusión de imágenes), fb (decodificación FlatBuffers), sp (análisis Spine), cu (análisis USM); la entrada y la salida se especifican con -i y -o; -d permite eliminar primero el directorio de salida existente; en modo descompresión pueden usarse --image, --text, --audio, --spine, --mesh, --typetree para seleccionar los tipos de exportación, y -g para agrupar por el nombre del AB de origen; en modo USM pueden usarse --no-video y --no-audio para omitir el procesamiento correspondiente; -l establece el nivel de registro (de 0 a 4). Si se ejecuta sin el parámetro mode, se accede a la interfaz interactiva. Notas El modo de ejecución con un clic no descomprime los archivos AB situados directamente en el directorio del programa, solo procesa los archivos dentro de subcarpetas. El programa ajusta automáticamente la estrategia multiproceso según el número de núcleos de la CPU, por lo que requiere cierta capacidad de CPU y disco; en equipos de gama baja la ejecución puede ser más lenta. Tras ejecutarse, genera en el directorio de trabajo el archivo de configuración ArkUnpackerConfig.json y el archivo de registro ArkUnpackerLogs.log. El repositorio también incluye documentación sobre la guía del archivo de configuración, conocimientos esenciales (imágenes de canal RGB e imágenes de canal A, personajes animados Spine) y guía para desarrolladores.