Zipmod vs. Manifest: Guía Esencial de Modding

Adentrarse en el mundo del modding para los juegos de Illusion puede parecer una tarea titánica al principio. Te encuentras con una avalancha de términos, archivos y estructuras que pueden confundir incluso al usuario más experimentado. Dos de los conceptos más fundamentales y a menudo malinterpretados son los archivos Zipmod y los manifiestos (manifest.xml). Comprender la relación y la diferencia entre ambos no es solo una cuestión de curiosidad técnica; es la clave para instalar, gestionar y solucionar problemas con tus mods de manera eficiente. En este artículo, vamos a desglosar cada componente, explicando su función y cómo trabajan juntos para dar vida a tus personalizaciones en el juego.

¿Qué es Exactamente un Archivo Zipmod?

En su forma más simple, un archivo Zipmod (con la extensión .zipmod) es un paquete contenedor. Imagínalo como una maleta cuidadosamente empacada que contiene todo lo necesario para que un mod funcione correctamente dentro del juego a través de la herramienta Sideloader. Aunque su extensión es .zipmod, en esencia, es un archivo ZIP estándar, lo que significa que puedes abrirlo con programas como 7-Zip o WinRAR para inspeccionar su contenido.

Estos archivos son el estándar para distribuir la mayoría de los mods de Sideloader, como ropa, accesorios, objetos de estudio, peinados y mapas. Sin embargo, es importante señalar que no todo el contenido personalizado viene en este formato; por ejemplo, las poses o las superposiciones (overlays) suelen distribuirse de otra manera.

Un detalle técnico relevante es la compresión. Aunque los Zipmods pueden ser comprimidos usando el algoritmo estándar Deflate, no es la práctica recomendada. El uso de compresión puede ralentizar significativamente los tiempos de carga del juego, ya que el sistema necesita descomprimir los archivos cada vez que accede a ellos. Por esta razón, la mayoría de los creadores de mods distribuyen sus Zipmods sin compresión para garantizar el mejor rendimiento posible.

Los Tres Pilares Fundamentales de un Zipmod

Para que un Zipmod funcione, no basta con meter archivos al azar. Debe seguir una estructura específica que el Sideloader pueda entender. Cada Zipmod se compone de tres elementos principales que trabajan en conjunto:

• El Manifiesto (manifest.xml): Es el documento de identidad del mod. Un archivo XML que contiene la información básica y, en algunos casos, toda la configuración del mod.
• Los Asset Bundles: Son los activos del juego en sí. Contienen los modelos 3D, texturas, shaders y otros elementos visuales que componen el mod.
• Los Metadatos (archivos CSV): Son archivos de texto que actúan como un índice o catálogo, diciéndole al juego qué son los ítems, cómo se llaman, en qué categoría aparecen y a qué Asset Bundle pertenecen.

Ahora, profundicemos en cada uno de estos componentes para entender su rol específico.

El Manifiesto (Manifest.xml): El ADN del Mod

El Manifest es, sin duda, el cerebro de la operación. Es un archivo obligatorio llamado manifest.xml que debe estar ubicado en la raíz del archivo Zipmod. Solo puede haber un manifiesto por Zipmod. Su función principal es proporcionar información de identificación básica sobre el paquete.

La información que típicamente encontrarás en un manifiesto incluye:

• GUID (Globally Unique Identifier): Un identificador único para el mod, crucial para evitar conflictos con otros mods.
• Nombre: El nombre del mod que puede ser visible para el usuario.
• Versión: La versión del mod, útil para el seguimiento de actualizaciones.
• Autor: El nombre o seudónimo del creador del mod.
• Descripción: Un breve texto que describe el contenido del mod.

Ejemplo de un Manifiesto Mínimo:

<manifest schema-ver="1"> <guid>com.75.analplug</guid> <name>[75] Anal plug</name> <version>0.0.2</version> <author>75</author> <description></description> <website></website> <game></game> </manifest>

Sin embargo, el rol del manifiesto puede ser mucho más complejo. Para ciertos tipos de mods, como los mods de cabeza (head mods), shaders o los populares uncensors, el manifiesto no solo contiene información básica, sino que también alberga todos los Metadatos de configuración, eliminando la necesidad de archivos CSV. En estos casos, el archivo XML se expande con etiquetas específicas que le indican al juego cómo manejar assets complejos.

Ejemplo de un Manifiesto de Uncensor:

<?xml version="1.0" encoding="utf-8" standalone="no"?> <manifest schema-ver="1"> <guid>mikke.puffybeaver</guid> <version>1.0</version> <author>Mikke</author> <description>Puffy uncensor for Beaver</description> <website>www.disney.com</website> <KK_UncensorSelector> <body> <guid>mikke.puffybeaver</guid> <displayName>Puffy Beaver</displayName> <sex>Female</sex> <oo_base> <file>chara/PuffyBeaver01.unity3d</file> </oo_base> </body> </KK_UncensorSelector> </manifest>

Como puedes ver, este manifiesto incluye etiquetas como <KK_UncensorSelector> que contienen rutas a archivos de Asset Bundles e información específica que el juego necesita para aplicar la modificación corporal.

Asset Bundles: El Contenido Visual del Mod

Si el manifiesto es el cerebro, los Asset Bundles son el cuerpo. Estos archivos, generalmente con extensiones como .unity3d, contienen los activos del juego que el mod introduce o modifica. Esto incluye:

• Modelos 3D (la malla de un vestido, un accesorio, un mueble).
• Texturas (los colores y detalles de la superficie de los modelos).
• Shaders (programas que definen cómo se renderiza la luz sobre las superficies).

En juegos como AI-Shoujo o Honey Select 2, los Asset Bundles también pueden contener otros datos, como imágenes de los mapas del juego. A diferencia del manifiesto o los archivos CSV, los Asset Bundles pueden ubicarse en cualquier lugar dentro de la estructura de carpetas del Zipmod. El manifiesto o los archivos CSV se encargarán de decirle al Sideloader dónde encontrarlos.

Metadatos en CSV: La Biblioteca de Ítems

Para la gran mayoría de mods de ítems (ropa, accesorios, objetos de estudio), el manifiesto solo proporciona la identificación básica. Toda la información detallada de cada ítem se encuentra en archivos de texto con formato CSV (Comma-Separated Values, o valores separados por comas). Estos archivos actúan como una base de datos que el Sideloader lee para saber qué hay dentro del Zipmod y cómo debe mostrarlo en el juego.

Estos archivos CSV deben estar en rutas muy específicas dentro del Zipmod para que el juego los reconozca. Algunos ejemplos de rutas son:

• Ítems de Personaje:/abdata/chara/list/ (Aquí dentro van CSVs para ropa, pelo, accesorios, etc.)
• Ítems de Estudio:/abdata/studio/info/ (Para muebles, objetos y otros elementos del modo estudio.)
• Mapas:/abdata/list/map/ (Para mapas de estudio o del juego principal.)

Una gran ventaja de este sistema es su flexibilidad. Un solo Zipmod puede contener varios archivos CSV, y cada archivo puede definir múltiples ítems. Esto permite a los creadores empaquetar colecciones enteras de ropa o muebles en un único y conveniente archivo Zipmod.

Tabla Comparativa: Zipmod vs. Manifest

Para resumir las diferencias de forma clara, aquí tienes una tabla comparativa:

Preguntas Frecuentes (FAQ)

Entonces, ¿el manifest es simplemente un archivo dentro del zipmod?

¡Exacto! El Zipmod es el paquete completo, la caja. El manifest.xml es uno de los componentes esenciales que se encuentran dentro de esa caja, junto con los assets y los metadatos CSV.

¿Puedo editar un archivo manifest.xml o un CSV directamente?

Sí, puedes hacerlo. Al ser archivos de texto, puedes abrirlos con un editor simple como el Bloc de Notas. Sin embargo, debes tener mucho cuidado. Un error de sintaxis en el XML del manifiesto o un campo mal formateado en un CSV puede hacer que el mod no se cargue o incluso causar problemas en el juego. Es recomendable hacer una copia de seguridad antes de editar cualquier cosa.

Instalé un mod nuevo (o modifiqué uno) y no aparece en el juego, ¿por qué?

Una de las causas más comunes es el sistema de caché del Sideloader. Para acelerar los tiempos de carga, Sideloader crea una caché de la información de los mods en la carpeta BepInEx/cache. Si modificas un Zipmod, es posible que el juego siga cargando la versión antigua desde la caché. Para forzar una recarga, puedes eliminar el contenido de esa carpeta de caché (es seguro hacerlo, se regenerará la próxima vez que inicies el juego).

¿Todos los mods usan archivos CSV para definir los ítems?

No. Como mencionamos, mods más complejos como los de cabeza (head mods), uncensors o shaders suelen definir toda su estructura y metadatos directamente dentro del archivo manifest.xml, prescindiendo de los archivos CSV.

¿Qué es el GUID y por qué es tan importante?

El GUID (Globally Unique Identifier) es un texto único que identifica a un mod. Es fundamental para que Sideloader pueda diferenciar entre miles de mods de distintos creadores. Si dos mods tuvieran el mismo GUID, causarían un conflicto, y probablemente solo uno de ellos se cargaría correctamente. Por eso, los creadores de mods deben asegurarse de que cada uno de sus trabajos tenga un GUID único.