Importando Jogos

O Spark suporta múltiplos métodos para importar jogos Ren’Py para o seu dispositivo iOS.

• ZIP (.zip) — Mais comum
• APK (.apk) — Pacotes Android
• 7-Zip (.7z) — Alta compressão
• RAR (.rar) — Suporte legado
• TAR (.tar) — Arquivos sem compressão
• Gzip (.gz) — Arquivos TAR comprimidos com Gzip
• BZ2 (.bz2) — Arquivos TAR comprimidos com Bzip2
• IPA (.ipa) — Arquivos de aplicativos iOS
• APP (.app) — Pacotes de aplicativos

1. Abra o Spark e toque no botão Importar na biblioteca
2. Navegue até o arquivo do jogo usando o seletor de arquivos do sistema
3. Selecione o arquivo e aguarde a conclusão da extração

O Spark verifica o arquivo antes da extração:

• Calcula o tamanho descomprimido para verificar se você tem espaço livre suficiente
• Detecta se o arquivo é protegido por senha e solicita que você insira a senha se necessário
• Escaneia o conteúdo do arquivo para localizar a pasta game/

Se múltiplas pastas de jogo forem encontradas dentro do arquivo, será solicitado que você selecione qual deseja importar.

O arquivo é extraído para um diretório temporário de preparo. O Spark monitora o espaço em disco durante a extração e irá parar se o armazenamento ficar criticamente baixo. Pastas de artefatos do macOS (__MACOSX) são removidas automaticamente.

Para arquivos APK duplamente empacotados (um ZIP contendo um APK dentro), o Spark detecta isso e extrai automaticamente ambas as camadas.

Após a extração, o Spark organiza os arquivos no diretório final do jogo:

• Pasta do jogo — A pasta game/ contendo scripts, recursos e arquivos é movida para seu local final
• Nome do jogo — Determinado a partir do android.json (importações APK), um arquivo .py próximo à pasta do jogo, ou o nome do arquivo compactado como fallback
• Nomeação única — Se um jogo com o mesmo nome já existir, um sufixo numérico é adicionado

O Spark procura nos arquivos extraídos pela pasta do motor Ren’Py incluído (renpy/). Se encontrado:

• O motor é salvo no diretório advanced/renpy/ do jogo para uso com o Modo Avançado
• A versão do Ren’Py é lida a partir dos arquivos de versão dentro da pasta do motor (por exemplo, vc_version.py, __init__.py, script_version.txt, ou seus equivalentes compilados)
• A versão detectada é armazenada nos metadados do jogo para correspondência de motor
• Para importações de APK Android, um arquivo incluído (private.mp3) é extraído para recuperar o motor e detectar a versão do Python

• Fontes personalizadas — Se o motor incluído com o jogo contém fontes modificadas (diferentes das fontes padrão do Ren’Py), elas são copiadas para a pasta do jogo para que o jogo possa usá-las em tempo de execução
• Suporte Live2D — O arquivo é escaneado em busca de bibliotecas Live2D. Se encontradas, um marcador é criado para que o Spark carregue o framework Live2D quando o jogo for iniciado

• Um arquivo info.json é escrito com o nome do jogo, versão do motor detectada, nome do arquivo original e timestamp da importação
• Diretórios de preparo são limpos e arquivos temporários são removidos
• A biblioteca de jogos é atualizada e o novo jogo aparece na sua biblioteca

• Jogos grandes (1 GB+) podem demorar para extrair
• Alguns formatos de arquivo como 7z podem levar um tempo extremamente longo para extrair se o arquivo contiver milhares de arquivos soltos. Jogos devem idealmente ser empacotados usando arquivos .rpa ou formatos consolidados similares. Algumas das bibliotecas de extração não são otimizadas para esses cenários
• Se um jogo aparece mas não inicia, tente alterar a versão do motor nas Configurações do Jogo
• Arquivos APK podem estar ocultos pelo filtro de arquivo — desative-o em Configurações > Biblioteca de Jogos