- Instalar mods no Gen1 Recomp: Use o Mod Manager integrado em vez de copiar arquivos aleatórios manualmente.
- Verificação de compatibilidade: Confirme se o mod é compatível com a sua versão do Gen1 Recomp e com a versão Red, Blue ou Yellow.
- Teste seguro: Faça backup dos saves e teste o jogo sem mods antes de ativar novos pacotes.
- Recuperação de conflitos: Desative primeiro os mods adicionados recentemente e depois reative os pacotes um por um para identificar problemas.
Instalar mods no Gen1 Recomp: o que preparar
O Gen1 Recomp é uma recriação nativa em Lua e LÖVE2D que usa dados de jogo de uma ROM de Pokémon Red, Blue ou Yellow obtida legalmente. Ele não é um emulador tradicional e não inclui arquivos de ROM protegidos por direitos autorais. Antes de instalar mods, certifique-se de que a aplicação base abre corretamente e chega à tela de título.
O fluxo mais seguro é simples: instale a versão oficial, importe seus dados de jogo compatíveis, crie um save funcional e só então adicione modificações compatíveis. Isso oferece um ponto de recuperação limpo caso um pacote visual, de jogabilidade, script ou interface cause um erro.
Aplicação base
- Baixe o Gen1 Recomp do repositório oficial no GitHub.
- Use o pacote de lançamento para o seu sistema operacional.
- Extraia o arquivo compactado completo antes de abrir.
Dados de jogo compatíveis
- Use um dump limpo de um cartucho de Pokémon Red, Blue ou Yellow de sua posse legal.
- Mantenha um backup intacto fora da pasta de instalação.
- Evite testar com um hack de ROM não verificado.
Pacote de mod
- Escolha um pacote desenvolvido especificamente para o Gen1 Recomp.
- Leia a versão, as dependências e as observações de suporte ao jogo.
- Mantenha o ZIP original intacto até a importação.
| Preparação | Ação recomendada | Por que isso importa |
|---|---|---|
| Versão oficial | Use a página de Releases no GitHub | Evita downloads modificados ou não oficiais |
| Primeira inicialização | Confirme que o jogo base chega à tela de título | Separa problemas da aplicação de conflitos de mods |
| Backup de save | Copie o save ativo e as pastas de dados do usuário | Protege o progresso antes de mudanças grandes |
| Origem do mod | Siga a página oficial do projeto do autor | Fornece notas de compatibilidade e migração |
Nunca baixe ou distribua arquivos de ROM por meio de um guia de mods. O Gen1 Recomp fornece a engine, enquanto os usuários precisam fornecer os dados do jogo a partir de sua própria cópia obtida legalmente.
Como instalar mods com o Mod Manager
O Mod Manager integrado é o método preferido para instalar mods no Gen1 Recomp. Ele ajuda a organizar pacotes, exibir o conteúdo instalado, ativar e desativar modificações e reduzir o risco de danificar a aplicação base. Instale um mod por vez para que cada alteração possa ser testada antes de adicionar o próximo pacote.
Verifique a versão do mod
Consulte a página oficial do projeto do mod e confirme que ele é voltado para o Gen1 Recomp, e não para um emulador convencional, um hack de ROM ou outro projeto de recompilação. Anote a versão exigida do Gen1 Recomp, a versão do jogo compatível, as dependências e o formato de instalação.
Preserve o ZIP original
Baixe o pacote de lançamento pronto para uso quando ele estiver disponível. Não coloque um ZIP dentro de outro ZIP, não renomeie arquivos internos de metadados e não adicione uma pasta de nível superior desnecessária. Uma estrutura de arquivo incorreta pode impedir que o gerenciador detecte o pacote.
Abra o Mod Manager
Inicie o Gen1 Recomp depois de confirmar que o jogo sem mods funciona. Abra o Mod Manager integrado e selecione a opção de importação ou adição de mod. Escolha o pacote baixado e aguarde o gerenciador identificar o mod.
Revise e ative
Leia o nome detectado, a versão, as dependências e as informações de compatibilidade. Ative o pacote somente depois de revisar esses detalhes. Reinicie o Gen1 Recomp se o gerenciador solicitar e, em seguida, confirme que o mod aparece na lista de instalados.
Teste antes de adicionar mais
Carregue um save de teste e verifique a funcionalidade afetada pelo mod. Por exemplo, examine uma interface alterada, entre em um mapa impactado por um pacote visual ou teste uma regra de jogabilidade em uma situação controlada. Mantenha o novo pacote desativado se o jogo base não iniciar corretamente.
| Etapa de instalação | O que verificar | Pare se |
|---|---|---|
| Compatibilidade | Projeto-alvo, versão de lançamento, versão do jogo | O pacote foi feito para outra engine |
| Arquivo | Estrutura e metadados originais do ZIP | Os arquivos estão aninhados ou faltando |
| Importação | O nome e a versão do mod aparecem no gerenciador | O pacote não é detectado |
| Ativação | O jogo abre com um mod ativado | A tela de título trava |
| Teste | A funcionalidade afetada funciona em um save de teste | O progresso ou o carregamento se comporta de forma anormal |
Importe e teste um único pacote por vez. Um perfil de mods pequeno e documentado é mais fácil de manter do que uma grande coleção ativada sem uma ordem de carregamento conhecida.
Gerenciar compatibilidade, ordem de carregamento e atualizações
A maioria dos problemas com mods vem de arquivos sobrepostos, dependências desatualizadas ou pacotes que alteram os mesmos scripts e assets. O mod carregado por último pode sobrescrever uma alteração anterior, então siga a ordem recomendada por cada autor sempre que um pacote incluir instruções de dependência.
Separe os mods comuns da comunidade do DramaticShape Voxel Mod. O projeto voxel é uma modificação comunitária distinta, com seus próprios requisitos de compatibilidade, configurações de câmera, batalhas em 3D e considerações de desempenho. Não presuma que um recurso mostrado em um pacote voxel faça parte da aplicação base do Gen1 Recomp.
| Categoria de mod | Alterações típicas | Prioridade de compatibilidade |
|---|---|---|
| Mod de interface | Menus, apresentação de texto, exibição de comandos | Geralmente com menor risco, mas a verificação de versão ainda importa |
| Mod visual | Sprites, efeitos, escala, apresentação | Teste junto com outros pacotes visuais |
| Mod de jogabilidade | Pokémon, golpes, itens, regras, encontros | Alta prioridade; pode afetar saves ou Link Play |
| Mod de script ou mapa | Eventos, mapas, NPCs, progressão | Alta prioridade; conflitos podem bloquear o progresso |
| Mod voxel | Renderização 3D, câmeras, batalhas, modelos | Trate como um projeto separado com requisitos específicos |
Perfil estável
Mantenha uma versão testada do Gen1 Recomp, um save confiável e uma lista curta de mods compatíveis. Registre a ordem de ativação após cada teste bem-sucedido.
Perfil de atualização
Instale uma nova versão base separadamente, abra-a sem mods, verifique a ROM e o save e depois restaure os pacotes compatíveis um por um.
Perfil de recuperação
Mantenha um backup sem mods e um save modificado separado. Isso permite comparar o comportamento sem sobrescrever a configuração limpa.
Ao atualizar um mod instalado, desative a versão antiga antes de importar a substituta. Remova cópias duplicadas para que o gerenciador não carregue duas versões ao mesmo tempo. Preserve arquivos de configuração somente quando a nova versão oferecer suporte explícito a eles.
Para grandes atualizações do Gen1 Recomp, siga esta ordem:
- Faça backup dos saves, das configurações e da pasta de mods.
- Teste a nova aplicação base sem mods.
- Confirme que a ROM de sua posse legal é carregada normalmente.
- Atualize os pacotes de framework ou dependências necessários.
- Importe os mods dependentes individualmente.
- Teste o jogo após cada ativação.
Uma atualização da aplicação base pode alterar sistemas internos usados pelos mods. Desative temporariamente pacotes desatualizados até que seus autores confirmem o suporte à versão instalada.
Solucione instalações de mods quebradas
Se o Gen1 Recomp parar de abrir depois de uma mudança em um mod, volte para a menor configuração que ainda funcione. Feche o jogo, abra o Mod Manager e desative o pacote instalado ou atualizado mais recentemente. Se a aplicação abrir novamente, teste esse pacote separadamente antes de restaurar o restante do perfil.
| Sintoma | Causa provável | Primeira ação de recuperação |
|---|---|---|
| O mod não aparece na lista | Estrutura de arquivo incorreta ou pacote não compatível | Verifique novamente o ZIP original e os requisitos do projeto |
| A tela de título trava | Pacote incompatível ou danificado | Desative o mod mais recente |
| Erros visuais | Renderizador em conflito ou arquivos visuais desatualizados | Volte para as configurações gráficas padrão |
| O save não carrega | Edição inválida ou alteração persistente de jogabilidade | Restaure o backup de save mais recente |
| O Link Play falha | Incompatibilidade de versão, mod, firewall ou UDP | Teste ambos os sistemas sem mods de jogabilidade |
| Os dados do Android desaparecem | Substituição do app ou desinstalação removeu o armazenamento local | Restaure o backup de save exportado |
Use um processo de eliminação controlada:
- Desative todos os mods e verifique se o jogo base inicia.
- Reative os pacotes individualmente.
- Teste o mapa, menu, batalha ou save afetado após cada ativação.
- Verifique as dependências antes de remover um pacote de framework.
- Registre o pacote que reproduz o erro.
- Consulte o rastreador de problemas oficial ou as instruções do autor do mod.
Para falhas relacionadas a save, não sobrescreva imediatamente o arquivo com problema. Preserve-o para comparação e, depois, restaure o último backup que sabia-se estar funcionando. O Save Editor integrado pode alterar Pokémon do grupo, caixas do PC, itens, dados da Pokédex e flags de evento, mas edições grandes devem ser feitas com cuidado e testadas em pequenos grupos.
Antes de manter um mod ativado:
- A instalação base do Gen1 Recomp inicia sem mods
- O mod é voltado para o Gen1 Recomp e é compatível com a versão instalada
- A estrutura original do ZIP e as dependências exigidas estão intactas
- Existe um save limpo e um backup de save modificado separados
- A funcionalidade afetada funciona após uma reinicialização
Se o jogo sem mods abre e seu backup carrega, a instalação é recuperável. Reconstrua o perfil gradualmente em vez de reinstalar tudo de uma vez.
Checklist de modding e recomendações práticas
Uma configuração confiável de mods depende mais de organização do que da quantidade de pacotes instalados. Mantenha a aplicação base, os backups de save, os arquivos de mods e o perfil ativo fáceis de identificar. Isso é especialmente útil ao alternar entre ambientes Windows, macOS, Linux, Android ou dispositivos portáteis.
| Tarefa | Quando fazer | Resultado recomendado |
|---|---|---|
| Fazer backup dos saves | Antes de instalar ou atualizar mods | Uma cópia datada fora da pasta do jogo |
| Testar o jogo base | Antes da primeira importação de mod | Tela de título, movimentação, menu e save funcionando |
| Registrar versões | Após cada configuração estável | Versão base, versões dos mods e ordem de carregamento documentadas |
| Testar o Link Play | Antes de trocas ou batalhas online | Versões iguais e conjuntos de mods compatíveis |
| Revisar atualizações | Antes de substituir uma instalação | Notas de versão e problemas conhecidos verificados |
Mantenha mods que alteram a jogabilidade separados de pacotes cosméticos durante a solução de problemas. Se ambos os jogadores usarem Link Play, iguale a versão da aplicação, a versão do jogo, a lista de mods ativos e a ordem de carregamento. Alterações visuais ou de interface podem ter menor probabilidade de afetar a sincronização, mas testar sem modificações de jogabilidade continua sendo a etapa de diagnóstico mais segura.
A Gen1 Recomp Wiki é o melhor lugar para revisar fluxos de trabalho específicos do projeto, enquanto o repositório oficial e as releases fornecem os pontos de entrada reconhecidos do projeto. Para a experiência voxel separada, consulte o repositório do DramaticShape Voxel Mod.
Trate todo perfil de mod que funcione como um ponto de restauração. Registre suas versões e ordem de carregamento antes de experimentar um novo pacote ou configuração visual.
Q: Onde devo baixar mods para o Gen1 Recomp?
Use a página ou o repositório oficial do autor do mod sempre que possível. Verifique se o pacote é voltado para o Gen1 Recomp e, em seguida, revise a versão compatível, a versão do jogo, as dependências e as notas de instalação.
Q: Posso instalar mods de emulador no Gen1 Recomp?
Não automaticamente. Mods criados para um emulador, um hack de ROM convencional ou outro projeto de recompilação podem usar arquivos e sistemas incompatíveis. Instale apenas pacotes feitos explicitamente para o Gen1 Recomp.
Q: O que devo fazer se um mod quebrar o jogo?
Desative primeiro o pacote mais recente e confirme que o jogo base abre. Se necessário, desative todos os mods, restaure um backup de save limpo e reative os pacotes individualmente até identificar o mod conflitante.
Q: O DramaticShape Voxel Mod vem embutido no Gen1 Recomp?
Não. Ele é um mod comunitário separado que adiciona apresentação 3D voxelizada, câmeras configuráveis, batalhas em 3D e recursos experimentais de visualização. Instale-o somente depois de testar a aplicação base.