Selector de Versión

Spark incluye múltiples versiones del motor Ren’Py y te permite elegir cuál usar para cada juego.

Spark incluye las siguientes versiones del motor Ren’Py:

Cuando importas un juego, Spark detecta la versión de Ren’Py que fue empaquetada con el archivo del juego (desde archivos de versión del motor como vc_version.py, __init__.py, o sus equivalentes compilados) y la usa para sugerir un motor compatible.

El script_version.txt del juego es un archivo separado usado internamente por Ren’Py para establecer flags de compatibilidad para la capa de scripting — no es lo mismo que la versión del motor.

Spark ofrece dos estrategias de sugerencia de motor (configurables en Ajustes):

• Preciso (predeterminado) — Recomienda un motor que coincida con la misma versión menor (ej., un juego 7.5.x obtiene el motor 7.5.3)
• Último — Recomienda el último motor dentro de la misma versión mayor (ej., un juego 7.x obtiene el último motor 7.x, un juego 8.x obtiene el último motor 8.x)

La versión del motor en tiempo de ejecución se muestra debajo del botón Iniciar Juego en la pantalla de detalle del juego. Hay dos ajustes de versión que puedes cambiar:

Esto controla qué motor Ren’Py incluido usa Spark para ejecutar el juego.

1. Toca Modificar junto a la versión del motor en la pantalla de detalle del juego
2. Selecciona del selector de versión
3. Toca Confirmar

Si has cambiado el motor y encuentras problemas, puedes revertir:

• La versión original se guarda automáticamente
• Usa el botón Revertir en el selector de versión para volver

Esto actualiza el script_version.txt del juego, que controla cómo se aplica la lógica de compatibilidad interna de Ren’Py. Ren’Py usa este valor para activar o desactivar comportamiento retrocompatible para juegos más antiguos.

Cambiar esto puede resolver problemas donde un juego espera ciertos comportamientos heredados que han sido modificados en versiones más nuevas del motor. Consulta la documentación de cambios incompatibles de Ren’Py para detalles sobre qué cambia entre versiones.

• El juego se cierra al iniciar — Prueba una versión diferente del motor
• Características faltantes — Algunos juegos requieren versiones específicas de Ren’Py
• Problemas de rendimiento — Los motores más nuevos pueden funcionar mejor
• Compatibilidad — Los juegos más antiguos pueden necesitar motores más antiguos

Cada juego en Spark tiene tres modos de lanzamiento opcionales que controlan cuánto del parcheo y la integración en tiempo de ejecución de Spark está activo. Se encuentran en Ajustes del Juego (mantén presionado un juego en la biblioteca).

El Modo Seguro inicia el juego usando un motor Ren’Py vanilla, sin modificar en lugar de la compilación parcheada personalizada de Spark. Las modificaciones del motor y las inyecciones de script de Spark se desactivan, pero el overlay y las funciones en tiempo de ejecución permanecen disponibles.

El botón de inicio se pone verde y dice “Inicio Seguro” cuando este modo está activo.

Cuándo usarlo: Un juego se cierra o se comporta mal y sospechas que los parches del motor de Spark son la causa.

El Modo Avanzado está diseñado para juegos donde el desarrollador ha hecho cambios directamente en la capa de Python del motor Ren’Py. Algunos juegos incluyen un directorio renpy/ modificado con código de motor personalizado — sin estas modificaciones, el juego puede cerrarse o comportarse incorrectamente. Cuando está activado:

• Spark busca un directorio advanced/renpy dentro de la carpeta del juego
• Cualquier archivo fuente de Python encontrado allí sobreescribe las fuentes Ren’Py integradas del motor
• Aparece un selector de versión de motor separado, independiente del selector de versión normal

El botón de inicio se pone rosa y dice “Inicio Avanzado” cuando este modo está activo.

Cuándo usarlo: El juego incluye modificaciones personalizadas al código fuente Python de Ren’Py (un directorio renpy/ modificado). Esto es poco común pero algunos juegos dependen de cambios a nivel de motor para características personalizadas, frameworks de interfaz o soluciones de compatibilidad.

Este modo elimina completamente la capa en tiempo de ejecución de Spark de la sesión del juego. Cuando está activado:

• El overlay de interfaz de Spark (controles del juego, menú rápido, ayudante de teclado, botón de ocultar interfaz) nunca aparece
• Toda la inyección de Python en tiempo de ejecución se omite — seguimiento de diálogos, desbloqueador de galería, configuración de gestos, sincronización de volumen, sistema de traducción y sobreescrituras de mapeo de teclas están desactivados
• El juego se ejecuta con cero modificaciones en tiempo de ejecución de Spark
• Los ajustes basados en RPY (modo desarrollador, consola, cuadro de texto transparente) siguen funcionando porque Ren’Py los carga por sí mismo en lugar de que Spark los inyecte

Cuándo usarlo: Un juego tiene conflictos con las funciones en tiempo de ejecución de Spark y el Modo Seguro por sí solo no resolvió el problema. Esto proporciona máxima compatibilidad y aislamiento al costo de toda la funcionalidad del overlay de Spark.