gen1 recomp macOS: Guia de configuração nativa para Mac

gen1 recomp macOS é uma recriação nativa para PC da Geração I de Pokémon, construída com um mecanismo Lua feito à mão e o framework LÖVE2D. Ele recria a experiência suportada de Red, Blue e Yellow sem emular o hardware do Game Boy ou converter diretamente o código assembly original.

O aplicativo fornece o mecanismo e usa dados extraídos de uma ROM de jogo legalmente obtida durante a configuração. Ele não inclui arquivos de jogos da Nintendo e não deve ser baixado de sites de redistribuição não oficiais.

O ponto de entrada oficial do projeto é o repositório GitHub do Gen1 Recomp. Use a página de GitHub Releases para builds para download e notas de release. O projeto informa que gen1recomp.com não é uma fonte autorizada de download.

A instalação mais segura no macOS usa o asset de release destinado ao Mac em vez de um arquivo-fonte. Pacotes de release podem incluir arquivos necessários para o aplicativo, então preserve a pasta original ou a estrutura do bundle do aplicativo após o download.

Após a primeira execução, importe os dados do jogo pelo fluxo de configuração do aplicativo. A build para Mac não substitui a necessidade de uma ROM de Red, Blue ou Yellow obtida legalmente. Guarde um backup intacto da sua ROM fora da pasta do Gen1 Recomp.

O processo da primeira execução deve ser concluído em uma ordem controlada. Comece com uma ROM limpa e suportada, verifique o jogo base, configure as opções de entrada e exibição e depois crie um backup do save.

A build para macOS armazena os dados de save separadamente da ROM original. O local exato do suporte do aplicativo pode depender do caminho de dados do LÖVE e da configuração da release, então use as opções de gerenciamento de save do próprio aplicativo ou inspecione o diretório de dados do usuário em vez de assumir que a pasta da ROM contém seus saves.

Para usar controle, conecte o dispositivo antes de abrir o aplicativo sempre que possível e depois revise os mapeamentos de controle. O teclado é uma opção de fallback confiável, enquanto o comportamento de Bluetooth, USB e controles compatíveis pode variar conforme a versão do macOS e o dispositivo.

Evite colocar arquivos de emulador, ROM hacks patchados ou dados não relacionados dentro da pasta do aplicativo enquanto estiver solucionando problemas. Uma pasta base limpa facilita identificar se o problema vem da build para Mac, dos dados importados do jogo ou de um mod posterior.

Gen1 Recomp inclui um Mod Manager integrado para pacotes da comunidade compatíveis. Mods comuns e o DramaticShape Voxel Mod separado não devem ser tratados como conteúdo idêntico. Confirme a versão-alvo de cada pacote, a versão do jogo suportada, as dependências e as instruções de instalação antes de ativá-lo.

Use a Gen1 Recomp Wiki para instruções específicas do projeto. Para a experiência voxel, consulte o repositório do DramaticShape Voxel Mod e siga as notas atuais de compatibilidade.

Um fluxo de trabalho confiável de mods no Mac é:

• Importe um pacote por vez.
• Mantenha o ZIP original intacto quando o Mod Manager esperar um arquivo compactado.
• Verifique se o mod suporta Red, Blue, Yellow ou apenas uma versão.
• Siga as instruções de dependência e ordem de carregamento.
• Faça backup dos saves antes de modificações que alterem a jogabilidade.
• Desative primeiro o mod mais recente quando surgir um problema.
• Teste o jogo base antes de relatar um crash.

O Save Editor integrado pode gerenciar Pokémon do grupo, caixas do PC, itens, dados da Pokédex e flags de eventos. Faça alterações pequenas, preserve o save original e teste o arquivo editado no jogo antes de substituir o backup. Alterações grandes ou inconsistentes podem fazer um save deixar de carregar ou alterar inesperadamente o progresso da história.

A maioria dos problemas no macOS pode ser reduzida ao voltar para uma configuração mínima. Primeiro confirme que o bundle do aplicativo está completo e depois teste a ROM e o jogo base sem mods.

Ao diagnosticar uma falha na inicialização, siga esta ordem:

1. Feche o Gen1 Recomp.
2. Confirme que o bundle do aplicativo foi totalmente extraído.
3. Inicie a build sem mods.
4. Verifique se a mesma ROM legalmente obtida funciona na configuração limpa.
5. Mova ou desative temporariamente os mods.
6. Teste o modo em janela e os controles padrão.
7. Consulte as Issues do GitHub do projeto para sintomas correspondentes.

Para o Link Play, ambos os jogadores devem usar a mesma release do Gen1 Recomp, dados de jogo compatíveis de Red, Blue ou Yellow e mods que alterem a jogabilidade de forma correspondente. O host pode precisar permitir o aplicativo pelo firewall e configurar a porta UDP selecionada. Teste na mesma rede local antes de tentar uma sessão pela internet.

Se um save falhar após a edição, preserve o arquivo com falha para comparação e restaure o backup mais recente. Confirme que o backup carrega sem mods antes de fazer uma edição menor e mais direcionada.