Importar Juegos

Spark admite múltiples métodos para importar juegos Ren’Py a tu dispositivo iOS.

• ZIP (.zip) — El más común
• APK (.apk) — Paquetes de Android
• 7-Zip (.7z) — Alta compresión
• RAR (.rar) — Soporte heredado
• TAR (.tar) — Archivos sin compresión
• Gzip (.gz) — Archivos TAR comprimidos con Gzip
• BZ2 (.bz2) — Archivos TAR comprimidos con Bzip2
• IPA (.ipa) — Archivos de aplicaciones iOS
• APP (.app) — Paquetes de aplicaciones

1. Abre Spark y toca el botón Importar en la biblioteca
2. Navega hasta tu archivo de juego usando el selector de archivos del sistema
3. Selecciona el archivo y espera a que se complete la extracción

Spark verifica el archivo antes de la extracción:

• Calcula el tamaño descomprimido para verificar que tengas suficiente espacio libre
• Detecta si el archivo está protegido con contraseña y te pide que la ingreses si es necesario
• Escanea el contenido del archivo para localizar la carpeta game/

Si se encuentran múltiples carpetas de juego dentro del archivo, se te pedirá que selecciones cuál importar.

El archivo se extrae a un directorio de preparación temporal. Spark monitorea el espacio en disco durante la extracción y se detendrá si el almacenamiento se vuelve críticamente bajo. Las carpetas de artefactos de macOS (__MACOSX) se eliminan automáticamente.

Para archivos APK doblemente empaquetados (un ZIP que contiene un APK dentro), Spark detecta esto y extrae automáticamente ambas capas.

Después de la extracción, Spark organiza los archivos en el directorio final del juego:

• Carpeta del juego — La carpeta game/ que contiene scripts, recursos y archivos se mueve a su ubicación final
• Nombre del juego — Se determina desde android.json (importaciones APK), un archivo .py junto a la carpeta del juego, o el nombre del archivo como alternativa
• Nombres únicos — Si ya existe un juego con el mismo nombre, se añade un sufijo numérico

Spark busca en los archivos extraídos la carpeta del motor Ren’Py incluido (renpy/). Si se encuentra:

• El motor se guarda en el directorio advanced/renpy/ del juego para usar con el Modo Avanzado
• La versión de Ren’Py se lee desde los archivos de versión dentro de la carpeta del motor (ej. vc_version.py, __init__.py, script_version.txt, o sus equivalentes compilados)
• La versión detectada se almacena en los metadatos del juego para la coincidencia del motor
• Para importaciones de APK de Android, se extrae un archivo incluido (private.mp3) para recuperar el motor y detectar la versión de Python

• Fuentes personalizadas — Si el motor incluido con el juego contiene fuentes modificadas (diferentes a las predeterminadas de Ren’Py), se copian a la carpeta del juego para que el juego pueda usarlas en tiempo de ejecución
• Soporte Live2D — El archivo se escanea en busca de bibliotecas Live2D. Si se encuentran, se crea un marcador para que Spark cargue el framework Live2D cuando el juego se inicie

• Se escribe un archivo info.json con el nombre del juego, la versión del motor detectada, el nombre del archivo original y la marca de tiempo de importación
• Se limpian los directorios de preparación y se eliminan los archivos temporales
• Se actualiza la biblioteca de juegos y el nuevo juego aparece en tu biblioteca

• Los juegos grandes (1 GB+) pueden tardar un rato en extraerse
• Algunos formatos de archivo como 7z pueden tardar muchísimo en extraerse si el archivo contiene miles de archivos sueltos. Los juegos idealmente deberían empaquetarse usando archivos .rpa o formatos consolidados similares. Algunas de las bibliotecas de extracción no están optimizadas para estos escenarios
• Si un juego aparece pero no se inicia, intenta cambiar la versión del motor en Ajustes del Juego
• Los archivos APK pueden estar ocultos por el filtro de archivos — desactívalo en Ajustes > Biblioteca de Juegos