Importando jogos

O Sakura importa jogos NScripter e ONScripter (incluindo jogos ONScripter-RU como Umineko) diretamente no seu dispositivo — sem precisar de computador. Isto cobre todo o fluxo de importação dentro do app. Se preferir importar a partir de um navegador no seu computador, veja Transferência web.

• Na Biblioteca, toque no cartão Importar jogos (.zip, .7z, .rar, .tar, .gz, .bz2, .exe).
• Se sua biblioteca estiver vazia, a tela Nenhum jogo encontrado tem seu próprio botão Importar.

Isso abre o popup Importação de jogo ONScripter, que lista os tipos de arquivo compatíveis e explica que a pasta raiz do jogo ONScripter será detectada automaticamente. Toque em Selecionar arquivo para abrir o seletor de arquivos do sistema e escolher um único arquivo compactado.

• zip — extraído com ZIPFoundation (ou SSZipArchive se protegido por senha)
• 7z — extraído com PLzmaSDK
• rar — extraído com UnrarKit
• tar / gz / bz2 / tgz — um leitor embutido de streaming tar/gzip/bzip2
• lzh / lha — um extrator LHA nativo
• exe (apenas instaladores/autoextraíveis) — detectado nesta ordem: instalador NSIS, instalador Inno Setup, depois uma varredura dos primeiros 16 MB em busca de um payload autoextraível 7z/zip embutido, e por fim LHA-SFX

1. Preparação. Se o arquivo estiver no iCloud Drive, o Sakura o baixa localmente primeiro. Em seguida verifica o espaço livre — precisando de aproximadamente 3× o tamanho do arquivo se precisar preparar uma cópia, ou 2× se o arquivo já estiver local. Se não houver espaço suficiente, você verá “Espaço em disco insuficiente”: “Não há espaço livre suficiente para extrair este arquivo. Libere espaço de armazenamento e tente novamente.”

2. Verificação de senha. Se o arquivo estiver criptografado (somente zip/rar/7z), você será solicitado: “Este arquivo está protegido por senha. Digite a senha para continuar.” Uma senha incorreta mostra “Senha incorreta. Tente novamente.”

3. Pré-varredura. Antes de extrair, o Sakura varre os nomes das entradas em busca de marcadores reconhecíveis de NScripter/ONScripter — scripts de inicialização como 0.txt, 00.txt, nscript.dat, nscr_sec.dat, nscript.___, 0.utf, 00.utf, pscript.dat, ou script.file (o formato de script compactado usado por jogos ONScripter-RU como Umineko), além de pacotes compactados como arc*.nsa, *.ns2, ou *.sar. Tar e outros formatos que não podem ser pré-varridos são verificados logo após a extração.

   Se nada corresponder, você verá: “Este arquivo não parece ser um jogo ONScripter. Procure arquivos contendo 0.txt, nscript.dat, ou um pacote arc.nsa.”

4. Extração. Uma contagem regressiva curta (“Iniciando…”) ocorre antes da extração começar, com uma porcentagem ao vivo depois e uma opção de Cancelar. Alguns detalhes específicos de formato:

   • Nomes de arquivo em zip são decodificados primeiro como UTF-8, com fallback para Shift-JIS — isso corrige mojibake em arquivos japoneses.
   • Extrações RAR recebem uma verificação de integridade pós-extração dos arquivos essenciais de inicialização; se algum estiver ausente ou truncado, você verá: “Extração RAR incompleta: N arquivos essenciais ausentes ou truncados (ex.: {sample}). Reempacote o jogo como ZIP ou 7z e importe-o.”
   • Pastas __MACOSX são apagadas automaticamente.

5. Detecção da raiz do jogo. O Sakura realiza uma busca limitada (até 6 níveis de profundidade) pela pasta mais rasa que contenha um dos marcadores NScripter acima — assim, um arquivo aninhado como Title 1.0/Title 1.0/game files… ainda é resolvido corretamente.

6. Instalação. O jogo é instalado em sua própria pasta na sua biblioteca, junto com uma pasta Patches vazia para mods ou patches de tradução. Se um arquivo com o mesmo nome já foi importado, um sufixo numérico é adicionado.

Se a extração for cancelada, você verá Cancelado com Fechar / Reiniciar. Se algo der errado, um popup de Erro fatal oferece Fechar ou Importar outro?.

Após uma importação bem-sucedida, a etapa Personalizar permite definir o Nome do jogo (pré-preenchido com o nome detectado) e escolher um Ícone — veja Ícones dos jogos para saber como os candidatos a ícone são encontrados. Toque em Salvar para manter suas escolhas, ou Pular para deixar os padrões.

A tela final confirma “Jogo ONScripter importado” com o nome do jogo, e oferece Fechar ou Ir para o jogo? para abri-lo na hora.

• Está vendo “Formato não compatível” ou “Formato de arquivo não compatível”? Veja as notas de formato acima — instaladores .exe CAB em particular precisam ser extraídos e reempacotados em um computador primeiro.
• Está vendo “Este arquivo não parece ser um jogo ONScripter”? Confira se o arquivo realmente contém os arquivos de script do jogo (e não apenas um instalador ou uma pasta de arquivos não relacionados).
• Para problemas de importação mais gerais, veja Problemas de importação.