Unreal Engine Absolute Project Migrator
O Unreal Engine Absolute Project Migrator (UEAPM), da MNZ Sistemas, é um plugin de editor para o Unreal Engine 5.8 que migra um projeto criado com o Unreal Engine 4.27. Ele faz o máximo possível automaticamente e escreve um relatório completo do que alterou e do que ainda resta para você fazer.
O que ele faz
A migração é executada em oito etapas, sempre na mesma ordem:
| # | Etapa | Em resumo |
|---|---|---|
| 1 | Projeto e configuração | .uproject, plugins, plataformas-alvo, configurações .ini |
| 2 | Regravação de assets | carrega e grava de novo cada pacote de /Game no formato do 5.8 |
| 3 | Enhanced Input (opcional) | mapeamentos e eventos de input legados para Enhanced Input |
| 4 | Cascade para Niagara | converte sistemas de partículas e reaponta as referências |
| 5 | Código C++ | correções no código por regras, configurações de build, arquivos de projeto |
| 6 | Renderização e mobile | configurações do renderizador, verificação de materiais |
| 7 | Física (PhysX para Chaos) | configurações de física, veículos PhysX para veículos Chaos |
| 8 | Blueprints | chamadas obsoletas substituídas, todos os Blueprints compilados |
Cada etapa executa três fases:
- Analisar encontra o que precisa mudar. Nunca modifica nada.
- Aplicar faz as alterações automáticas (ignorada em um dry run).
- Verificar confere de novo e lista o que restou.
Automático versus relatado
O UEAPM só altera o que pode alterar com segurança e com resultado conhecido. Todo o resto vai para o relatório como pendência, com o local e uma correção precisa. Exemplos:
- Automático: a associação de engine, plugins removidos, chaves
.inirenomeadas, headers movidos no C++, conversão de sistemas de partículas, chamadas obsoletas de Blueprint com substituto direto, Blueprints de veículos PhysX re-parentados para Chaos. - Relatado: plugins que o 5.8 não conhece, código C++ que exige decisão humana (PhysX, Matinee), módulos do Cascade que o conversor não suporta, parâmetros de ajuste de veículos sem equivalente no Chaos, erros de compilação de Blueprints.
Não há fallbacks escondidos: quando uma operação não pode ser feita, o relatório diz isso com um item Error ou Manual e a correção a aplicar.
Requisitos
- Unreal Engine 5.8 no Windows.
- Um projeto criado com o Unreal Engine 4.27.
- O projeto precisa ser uma cópia ou estar sob controle de versão. O UEAPM faz backup de cada arquivo que modifica, mas trabalha no próprio projeto: mantenha sempre o projeto 4.27 original intacto.
- Para projetos C++: o toolchain do Visual Studio exigido pelo UE 5.8.
Próximos passos
- Instale o plugin.
- Siga o fluxo de trabalho para um projeto só de Blueprints ou C++.
- Leia o relatório e resolva as pendências.
Para ver uma migração real completa, leia o estudo de caso do Action RPG.