Problemas de Importação

Sintoma: Ao tentar importar, o arquivo do jogo está acinzentado ou não visível.

Causa: O filtro de extensão de arquivo do Spark mostra apenas formatos reconhecidos por padrão.

Solução:

1. Vá em Settings > Game Library
2. Desative o File Extension Filter
3. Tente importar novamente

Isso é especialmente comum com arquivos APK.

Sintoma: A importação parece ser concluída, mas nenhum jogo aparece na biblioteca.

Possíveis Causas:

1. Estrutura de jogo inválida — O arquivo não contém um jogo Ren’Py válido

   • Solução: Verifique se o arquivo contém uma pasta game/ com arquivos .rpy ou .rpa

2. Diretórios aninhados — O jogo está muito profundo na estrutura do arquivo

   • Solução: Extraia o arquivo em um PC primeiro, depois transfira apenas a pasta do jogo

3. Arquivo corrompido — O arquivo está danificado

   • Solução: Baixe o arquivo novamente

Sintoma: A importação falha com o erro “Unable to find the ‘game’ folder. Is this a Ren’Py title? It is possible that the game was packaged in an unknown way.”

Causa: O Spark procura uma pasta game/ no arquivo extraído, que é a estrutura padrão para jogos Ren’Py. Se nenhuma for encontrada, a importação não pode continuar. Isso pode acontecer quando:

• O arquivo não é um jogo Ren’Py
• O jogo foi empacotado de forma não padrão (repack não oficial, estrutura de pastas personalizada)
• O arquivo está duplamente empacotado e a detecção automática do Spark não encontrou o jogo interno

Soluções:

1. Verifique se o arquivo é realmente um jogo Ren’Py contendo uma pasta game/
2. Tente usar o arquivo oficial do jogo do desenvolvedor original em vez de uma versão reempacotada
3. Se o arquivo contém um jogo Ren’Py válido mas o Spark não consegue detectá-lo, reporte para a equipe de suporte no Discord ou por e-mail

Sintoma: A importação falha com o erro “Legacy Method — Unable to find game folder.”

Causa: Após a detecção primária da pasta do jogo falhar, o Spark tenta uma varredura legada de fallback que procura recursivamente em todo o arquivo extraído por uma pasta game/. Este erro significa que mesmo a detecção legada não conseguiu localizar um jogo válido.

Soluções:

• A estrutura do arquivo provavelmente é incompatível. Tente uma versão diferente ou um arquivo de outra plataforma do jogo
• Extraia o arquivo em um PC, verifique a estrutura de pastas e reempacote como um ZIP padrão com a pasta game/ no nível esperado
• Reporte o problema para a equipe de suporte com o nome do jogo

Sintoma: O jogo não inicia com a mensagem “Unable to determine Ren’Py Version. Aborting Launch.” ou um prompt pedindo para especificar a versão do motor.

Causa: O Spark não conseguiu detectar automaticamente qual versão do Ren’Py o jogo requer.

Solução: Abra Configurações do Jogo (mantenha pressionado o jogo), toque em Modify ao lado da versão do Ren’Py e selecione manualmente a versão correta do motor. Se não tiver certeza, tente a versão 7.x mais recente para jogos mais antigos ou a versão 8.x mais recente para jogos mais novos.

Sintoma: O lançamento falha com o erro “The requested engine version was not found.”

Causa: A versão do motor selecionada para o jogo não está disponível no dispositivo.

Solução: Abra Configurações do Jogo e selecione uma versão diferente disponível do motor.

Sintoma: A importação falha com um erro mostrando o tamanho estimado descompactado e o espaço disponível.

Causa: Seu dispositivo não tem espaço de armazenamento livre suficiente para extrair o arquivo. Geralmente, você precisa de pelo menos 2x o tamanho do arquivo (o arquivo em si mais os arquivos extraídos).

Solução: Libere espaço no seu dispositivo e tente novamente. Use o Gerenciador de Armazenamento para identificar jogos ou backups que podem ser removidos.

Sintoma: A importação falha com “Unable to determine the uncompressed archive size. Is the archive corrupt?”

Causa: O Spark não conseguiu ler os metadados do arquivo para calcular o tamanho descompactado. O arquivo pode estar corrompido ou em uma variante não suportada do formato.

Solução: Baixe o arquivo novamente e tente outra vez. Se o problema persistir, o arquivo pode usar um formato não padrão — reporte para a equipe de suporte.

Sintoma: A importação falha com “Unable to obtain file permission from the operating system.”

Causa: O iOS não concedeu ao Spark permissão para acessar o arquivo selecionado. Isso pode ocorrer com arquivos de certos provedores de armazenamento em nuvem ou locais externos.

Solução: Tente copiar o arquivo para a seção No Meu iPhone/iPad no app Arquivos primeiro, e depois importe de lá.

Sintoma: O indicador de progresso congela ou um erro não listado aparece durante a importação.

Soluções:

• Certifique-se de ter espaço de armazenamento suficiente (pelo menos 2x o tamanho do arquivo)
• Para arquivos muito grandes (2 GB+), a importação pode levar vários minutos — tenha paciência
• Alguns formatos de arquivo como 7z podem ser extremamente lentos com milhares de arquivos soltos
• Se o erro persistir, reporte para a equipe de suporte com a mensagem de erro e o nome do jogo

Sintoma: Após importar um APK, o jogo tem um nome incorreto ou genérico.

Causa: O nome do jogo não pôde ser determinado a partir dos metadados do APK.

Solução: Mantenha pressionado o jogo na biblioteca e renomeie-o manualmente.