Pular para o conteúdo principal

Etapa 4: Cascade para Niagara (cascade)

Converte sistemas de partículas Cascade para Niagara e reaponta o projeto para os sistemas convertidos.

:::info Exige a interface do editor O conversor da engine usa as views de editor do Niagara, então esta etapa precisa do editor completo. Ela não roda dentro do commandlet; para execuções sem supervisão use UnrealEditor.exe com -ExecCmds (veja Headless). :::

Feito automaticamente​

  • Cada ParticleSystem é convertido com o Cascade To Niagara Converter da engine em um sistema Niagara chamado <Nome>_Converted, ao lado do original.
  • As referências passam a apontar para o sistema convertido:
    • componentes de partícula nas árvores de componentes dos Blueprints;
    • nós SpawnEmitterAtLocation / SpawnEmitterAttached viram SpawnSystemAtLocation / SpawnSystemAttached;
    • anim notifies Play Particle Effect e Timed Particle Effect viram os equivalentes do Niagara;
    • atores Emitter colocados nos mapas viram atores Niagara.

Os assets Cascade originais são mantidos.

Relatado para você​

  • Módulos do Cascade que o conversor não suporta (Manual).
  • Sistemas cuja conversão não tem renderer (normalmente trails e beams): as referências mantêm o sistema Cascade e um Warning é gravado.
  • Referências que a etapa não consegue substituir, como anim notifies personalizados ou Level Sequences que apontam para um sistema de partículas (Warning). O Cascade ainda funciona no 5.8, então elas continuam funcionando até você substituí-las.

Tabelas de regras​

cascade.json: o sufixo _Converted e as duas substituições de chamada com seus mapas de pinos:

Chamada 4.27Chamada 5.8Pinos renomeados
GameplayStatics.SpawnEmitterAtLocationNiagaraFunctionLibrary.SpawnSystemAtLocationEmitterTemplate para SystemTemplate, bAutoActivateSystem para bAutoActivate
GameplayStatics.SpawnEmitterAttachedNiagaraFunctionLibrary.SpawnSystemAttachedEmitterTemplate para SystemTemplate

Exemplos​

Do estudo de caso do Action RPG:

  • P_FireBall_Strong convertido em P_FireBall_Strong_Converted.
  • Um notify personalizado Trail em uma animação de golpe de espada é relatado: "Replace it with a Niagara-based notify (ribbon renderer for trails) using the converted system."