Este tutorial detalla el uso del proyecto UnityLive2DExtractor, una herramienta diseñada para extraer modelos Live2D Cubism 3 de los AssetBundles de Unity. A continuación, se describe la estructura del proyecto, el punto de entrada de la aplicación y cómo ejecutar la extracción.

Estructura del Proyecto

El proyecto UnityLive2DExtractor presenta la siguiente organización:

UnityLive2DExtractor/
├── UnityLive2DExtractor.sln
├── UnityLive2DExtractor/
│   ├── .gitattributes
│   ├── .gitignore
│   ├── LICENSE
│   ├── README.md
│   ├── UnityLive2DExtractor.csproj
│   ├── Program.cs
│   ├── Live2DExtractor.cs
│   └── ... (otros archivos de código fuente)
└── ... (otros directorios o archivos del proyecto)
  

• UnityLive2DExtractor.sln: Archivo de solución para Visual Studio, que permite gestionar el proyecto.
• UnityLive2DExtractor/: Contiene el código fuente principal.
  • .gitattributes: Configura el comportamiento de Git con archivos específicos.
  • .gitignore: Especifica archivos y directorios que Git debe ignorar.
  • LICENSE: Detalla los términos de la licencia (MIT en este caso).
  • README.md: Proporciona una descripción general y guía de uso del proyecto.
  • UnityLive2DExtractor.csproj: Archivo de proyecto C#, define la configuración de compilación y dependencias.
  • Program.cs: Punto de entrada de la aplicación, contiene la función principal.
  • Live2DExtractor.cs: Implementa la lógica central para la extracción de archivos Live2D de AssetBundles.

Punto de Entrada de la Aplicación

La ejecución de la aplicación comienza en el archivo Program.cs, específicamente en su método Main.

using System;
using System.IO;

namespace UnityLive2DExtractor
{
    class Program
    {
        static void Main(string[] args)
        {
            if (args.Length == 0)
            {
                Console.WriteLine("Por favor, arrastre una carpeta de Live2D al ejecutable o proporcione la ruta de la carpeta como argumento.");
                return;
            }

            string inputFolderPath = args[0];
            string outputFolderPath = Path.Combine(Path.GetDirectoryName(inputFolderPath) ?? "", "Live2DOutput");

            if (!Directory.Exists(outputFolderPath))
            {
                Directory.CreateDirectory(outputFolderPath);
            }

            var extractor = new Live2DExtractor();
            extractor.ProcessAssets(inputFolderPath, outputFolderPath);
        }
    }
}
  

• Main(string[] args): El método de inicio. Procesa los argumentos de línea de comandos y delega la operación de extracción a la clase Live2DExtractor.
• args: Los argumentos pasados al programa, típicamente la ruta a la carpeta que contiene los archivos Live2D dentro de un AssetBundle de Unity.
• Live2DExtractor: La clase responsable de la lógica de extracción, recuperando los componentes de Live2D de los AssetBundles y guardándolos en el directorio de salida especificado.

Configuración y Ejecución

Este proyecto no utiliza archivos de configuración externos; todos los parámetros se manejan a través de argumentos de línea de comandos. Para utilizar la herramienta:

1. Ejecute el archivo UnityLive2DExtractor.exe.
2. Arraste una carpeta que contenga los activos de Live2D (extraídos de un AssetBundle de Unity) directamente sobre el archivo ejecutable.
3. Alternativamente, puede especificar la ruta de la carpeta como argumento en la línea de comandos.

Por ejemplo, si la carpeta de Live2D se encuentra en C:\MiProyecto\ActivosLive2D, puede ejecutar:

UnityLive2DExtractor.exe "C:\MiProyecto\ActivosLive2D"
  

Esto iniciará el proceso de extracción. La herramienta creará automáticamente un subdirectorio llamado Live2DOutput en el mismo nivel que la carpeta de entrada proporcionada, donde se guardarán los archivos Live2D extraídos.