Não consigo sincronizar/abrir projeto UEFN chamado “VoiceChat” por conflito com plugin nativo

Olá! Não estou conseguindo sincronizar e abrir um dos meus projetos UEFN em um computador novo.

O projeto se chama VoiceChat. Quando o seleciono no Navegador de Projetos e clico em Sincronizar, o UEFN baixa os arquivos, mas falha ao abrir com este erro:

Falha ao abrir o projeto
C:/Users/Eduardo/Documents/UEFN_Sync/VoiceChat/VoiceChat.uefnproject

Falha ao carregar plugin
C:/Users/Eduardo/Documents/UEFN_Sync/VoiceChat/VoiceChat.uplugin

Já existe um plugin registrado chamado VoiceChat neste local:
C:/Program Files/Epic Games/Fortnite/Engine/Plugins/Online/VoiceChat/VoiceChat/VoiceChat.uplugin

Já tentei sincronizar para uma pasta local totalmente nova, então não parece ser causado por arquivos antigos no computador.

O nome do projeto fica bloqueado na tela de sincronização e não existe opção para renomear ou duplicar por ali. Parece que o nome técnico do meu projeto agora está em conflito com o plugin nativo VoiceChat do Fortnite.

Existe alguma forma oficial de renomear ou migrar esse projeto sincronizado sem perder o conteúdo? Ou algum outro procedimento para conseguir abri-lo?

Olá @Dudufps1

(Esta resposta foi traduzida de forma automática utilizando uma ferramenta de tradução para responder no seu idioma)

O problema que você encontra é resultado da forma como o UEFN (Unreal Editor for Fortnite) trata os plugins. Ao criar um novo projeto chamado “VoiceChat”, o editor produz um descritor de plugin root no processo de inicialização para todos os seus projetos (portanto, ele acabará criando VoiceChat.uplugin). Na inicialização, o UEFN tenta registrar esse descritor diretamente e entra em conflito com o plugin por padrão do Fortnite, localizado no seguinte diretório:

C:\Program Files\EpicGames\Fortnite\Engine\Plugins\Online\VoiceChat\VoiceChat.uplugin

Como esses são serviços críticos do sistema (plugins do motor), eles sempre superam qualquer outro plugin em termos de prioridade de carregamento, e o UEFN simplesmente reportará uma duplicação e encerrará a inicialização.

Ferramentas e Sinais Óbvios

Agora, vamos dar uma oliva nos detalhes técnicos sobre o procedimento para contornar essa situação e recuperar sua cópia do projeto.

Solução 1: Renomear os Descritores do Projeto Localmente

Se os arquivos já foram baixados para a sua pasta local de sincronização (C:\Users\Eduardo\Documents\UEFN_Sync\VoiceChat), você pode alterar manualmente os arquivos de descritor para usar um nome único (como VoiceChat_Project ou MyVoiceChat).

  1. Feche totalmente o UEFN e o Epic Games Launcher.

  2. Abra o Explorador de Arquivos do Windows e navegue até a pasta do projeto: C:\Users\Eduardo\Documents\UEFN_Sync\VoiceChat\

  3. Renomeie os Arquivos Principais:

    • Renomeie VoiceChat.uefnproject para VoiceChat_Project.uefnproject

    • Renomeie VoiceChat.uplugin para VoiceChat_Project.uplugin

  4. Edite o Arquivo de Descritor de Plugin:

    • Abra o arquivo VoiceChat_Project.uplugin com um editor de texto (Notepad++, VS Code ou Bloco de Notas).

    • Localize os campos JSON "FriendlyName" e "Name" (caso existam) e altere seus valores para "VoiceChat_Project".

    • Salve e feche o arquivo.

  5. Edite o Arquivo de Descritor do Projeto:

    • Abra o arquivo VoiceChat_Project.uefnproject no editor de texto.

    • Procure por referências internas apontando para "VoiceChat.uplugin" ou módulos com o nome VoiceChat e atualize-as para VoiceChat_Project.

    • Salve e feche o arquivo.

  6. Abra no UEFN:

    • No UEFN, vá em File > Open Project > Browse e selecione diretamente o arquivo C:\Users\Eduardo\Documents\UEFN_Sync\VoiceChat\VoiceChat_Project.uefnproject.

    • Abra o projeto manualmente a partir do disco, em vez de tentar sincronizar diretamente pela lista da nuvem.

Solução 2: Criar um Novo Projeto e Migrar os Assets

Se a atualização dos descritores locais causar incompatibilidades com a verificação da revisão (Revision Control), a solução mais segura é migrar os arquivos para um novo projeto.

  1. Inicie o UEFN e crie um novo projeto com um nome exclusivo (ex: VoiceChatSystem_V1).
  2. Feche o UEFN após a criação do template básico.
  3. Abra duas janelas do Explorador de Arquivos:
    • Pasta de Origem: C:\Users\Eduardo\Documents\UEFN_Sync\VoiceChat\Plugins\VoiceChat\Content (ou o diretório Content do projeto original).

    • Pasta de Destino: C:\Users\Eduardo\Documents\UEFN_Sync\VoiceChatSystem_V1\Plugins\VoiceChatSystem_V1\Content

  4. Copie os Arquivos:
    • Transfira os arquivos .uasset, .umap (níveis), códigos Verse (.digest.verse / .verse) e texturas da pasta Content de origem para a pasta de destino.
  5. Abra o novo projeto VoiceChatSystem_V1 no UEFN.
  6. Confirme se todos os assets e scripts do Verse foram carregados corretamente e faça o envio (check-in) inicial através do Unreal Revision Control (URC).

Boas Práticas para Nomes de Projetos no UEFN

Para evitar conflitos com módulos nativos do Unreal Engine e do Fortnite, siga estas recomendações ao criar novos projetos:

  • Evite Nomes de Módulos Reservados: Não utilize nomes de plugins nativos como VoiceChat, AudioLink, Chaos, Niagara, OnlineSubsystem, Water ou Landmass.

  • Utilize Prefixos ou Sufixos Exclusivos: Adicione identificadores próprios ao nome do projeto (ex: Project_VoiceChat, My_VoiceChat).

  • Namespaces do Verse: Certifique-se de que as declarações de módulos em Verse não entrem em conflito com os módulos padrão das bibliotecas Fortnite.com ou UnrealEngine.com