Seletor de Versão

O Spark inclui múltiplas versões do motor Ren’Py e permite escolher qual usar para cada jogo.

O Spark inclui as seguintes versões do motor Ren’Py:

Ao importar um jogo, o Spark detecta a versão do Ren’Py que foi empacotada com o arquivo do jogo (a partir de arquivos de versão do motor como vc_version.py, __init__.py, ou seus equivalentes compilados) e usa isso para sugerir um motor compatível.

O script_version.txt do jogo é um arquivo separado usado internamente pelo Ren’Py para definir flags de compatibilidade para a camada de scripting — não é o mesmo que a versão do motor.

O Spark oferece duas estratégias de sugestão de motor (configuráveis nas Configurações):

• Preciso (padrão) — Recomenda um motor correspondente à mesma versão menor (ex.: um jogo 7.5.x recebe o motor 7.5.3)
• Último — Recomenda o motor mais recente dentro da mesma versão maior (ex.: um jogo 7.x recebe o último motor 7.x, um jogo 8.x recebe o último motor 8.x)

A versão do runtime do motor é exibida abaixo do botão Iniciar Jogo na tela de detalhes do jogo. Há duas configurações de versão que você pode alterar:

Controla qual motor Ren’Py incluído o Spark usa para executar o jogo.

1. Toque em Modificar ao lado da versão do motor na tela de detalhes do jogo
2. Selecione no seletor de versão
3. Toque em Confirmar

Se você alterou o motor e encontrou problemas, pode reverter:

• A versão original é salva automaticamente
• Use o botão Reverter no seletor de versão para voltar

Isso atualiza o script_version.txt do jogo, que controla como a lógica de compatibilidade interna do Ren’Py é aplicada. O Ren’Py usa esse valor para ativar ou desativar comportamento retrocompatível para jogos mais antigos.

Alterar isso pode resolver problemas onde um jogo espera certos comportamentos legados que foram modificados em versões mais recentes do motor. Veja a documentação de mudanças incompatíveis do Ren’Py para detalhes sobre o que muda entre versões.

• O jogo trava ao iniciar — Tente uma versão diferente do motor
• Recursos ausentes — Alguns jogos exigem versões específicas do Ren’Py
• Problemas de desempenho — Motores mais recentes podem ter melhor desempenho
• Compatibilidade — Jogos mais antigos podem precisar de motores mais antigos

Cada jogo no Spark possui três modos de inicialização opcionais que controlam quanta integração de patches e runtime do Spark está ativa. Eles são encontrados nas Configurações do Jogo (pressione e segure um jogo na biblioteca).

O Modo Seguro inicia o jogo usando um motor Ren’Py vanilla, não modificado em vez do build personalizado com patches do Spark. As modificações e injeções de script do motor do Spark são desativadas, mas o overlay e recursos de runtime permanecem disponíveis.

O botão de iniciar fica verde e exibe “Inicialização Segura” quando este modo está ativo.

Quando usar: Um jogo trava ou se comporta mal e você suspeita que os patches de motor do Spark são a causa.

O Modo Avançado é projetado para jogos onde o desenvolvedor fez alterações diretamente na camada Python do motor Ren’Py. Alguns jogos são distribuídos com um diretório renpy/ modificado contendo código personalizado do motor — sem essas modificações, o jogo pode travar ou se comportar incorretamente. Quando ativado:

• O Spark procura por um diretório advanced/renpy dentro da pasta do jogo
• Quaisquer arquivos fonte Python encontrados ali substituem as fontes Ren’Py integradas do motor
• Um seletor de versão de motor separado aparece, independente do seletor de versão normal

O botão de iniciar fica rosa e exibe “Inicialização Avançada” quando este modo está ativo.

Quando usar: O jogo inclui modificações personalizadas no código fonte Python do Ren’Py (um diretório renpy/ modificado). Isso é incomum, mas alguns jogos dependem de alterações no nível do motor para recursos personalizados, frameworks de UI ou soluções alternativas de compatibilidade.

Este modo remove completamente a camada de runtime do Spark da sessão do jogo. Quando ativado:

• A UI de overlay do Spark (controles do jogo, menu rápido, auxiliar de teclado, botão de ocultar UI) nunca aparece
• Toda injeção Python de runtime é ignorada — rastreamento de diálogos, desbloqueador de galeria, configuração de gestos, sincronização de volume, sistema de tradução e substituições de mapa de teclas são todos desativados
• O jogo roda com zero modificações de runtime do Spark
• Configurações baseadas em RPY (modo desenvolvedor, console, textbox transparente) ainda funcionam porque o Ren’Py as carrega sozinho ao invés do Spark injetá-las

Quando usar: Um jogo conflita com os recursos de runtime do Spark e o Modo Seguro sozinho não resolveu o problema. Isso fornece máxima compatibilidade e isolamento ao custo de toda a funcionalidade de overlay do Spark.