Instalação

O Locus é um plugin do Unreal Engine exclusivo do Editor. Escolha a instalação pelo Fab ou um pacote binário pré-compilado compatível.

Antes de instalar

Use a versão do Locus criada para a versão exata do Unreal Engine usada pelo projeto. Um pacote criado para outra versão da Engine pode não carregar.
O Locus 1.1 oferece suporte a builds Win64 do Unreal Engine 5.4–5.8. macOS e Linux não são plataformas de lançamento compatíveis.

O acesso à Python Developer API é opcional e requer Unreal Engine 5.6 ou posterior. Ele não é compatível com UE 5.4 e 5.5 devido a uma limitação verificada de reflection do Unreal no caminho de invocação do Python; o Locus normal, C++, Blueprint e MCP continuam compatíveis nessas versões.

Instalar pelo Fab

Ao instalar pelo Fab ou pelo Epic Games Launcher, selecione a versão do Locus correspondente à versão do Unreal Engine que pretende usar. Não é necessário copiar manualmente os arquivos do plugin.

Abra o projeto de destino no Unreal Editor.
Abra Edit > Plugins e habilite o Locus se ele ainda não estiver habilitado.
Reinicie o Unreal Editor se solicitado.

Após reiniciar, abra o Locus em Window > Locus, no botão do Locus na barra de ferramentas do Content Browser ou com Ctrl+Shift+L.

Instalar manualmente um pacote binário pré-compilado

Os pacotes do Locus distribuídos manualmente incluem os binários pré-compilados necessários para a versão compatível do Unreal Engine. Selecione o pacote criado para a versão exata da Engine que pretende usar.

Feche o Unreal Editor antes de copiar ou substituir arquivos do plugin. Copie o diretório completo do plugin Locus; não copie apenas Binaries e não misture arquivos de pacotes criados para versões diferentes da Engine.

Instalação específica do projeto

Copie a pasta completa do plugin Locus para:

<ProjectRoot>/Plugins/Locus/

Crie o diretório Plugins do projeto se ele não existir. Isso disponibiliza o Locus para esse projeto e mantém a versão do plugin associada a ele, o que é útil quando projetos diferentes precisam de versões diferentes do Locus ou da Engine.

Instalação em toda a Engine

Copie a pasta completa do plugin Locus para:

<UnrealEngineRoot>/Engine/Plugins/Marketplace/Locus/

Isso disponibiliza o Locus para projetos abertos com essa instalação específica do Unreal Engine, sem copiar o pacote para cada projeto. Isso não instala o Locus em outras versões da Engine. Habilite o Locus separadamente em cada projeto em que ele será usado.

Concluir a instalação manual

Reabra o projeto na versão exata e compatível do Unreal Engine.
Em Edit > Plugins, encontre o Locus e habilite-o se ainda não estiver habilitado.
Reinicie o Unreal Editor quando solicitado.

Abra o Locus em Window > Locus, no botão do Locus na barra de ferramentas do Content Browser ou com Ctrl+Shift+L.

Um pacote binário pré-compilado compatível fornecido oficialmente não exige gerar arquivos do projeto, compilar o Locus, reconstruir o plugin, abrir o Visual Studio ou modificar arquivos .Build.cs.

Locais de dados criados pelo uso

O Locus cria armazenamento à medida que cada tipo de conteúdo é usado:

Conteúdo	Local visível no projeto
Notas Compartilhadas	`<Project>/ProjectNotes/`
Pins Compartilhados	`<Project>/ProjectPins/`
Documentos	`<Project>/ProjectDocuments/`
Notas e Pins Privados, recuperação e estado pessoal da UI do projeto	`<Project>/Saved/Locus/` e pastas de recuperação relacionadas em `<Project>/Saved/`

Consulte Notas, Pins, Documentos e Impacto no projeto e dependências sobre propriedade e dependências.

Desabilitar ou remover o Locus

Desabilitar ou remover o plugin interrompe sua UI no Editor; isso não exclui intencionalmente os arquivos externos listados acima. Faça backup do projeto antes de desinstalar um plugin e decida separadamente se os dados mantidos do Locus devem continuar no projeto ou no repositório de controle de código-fonte.

O Locus possui apenas módulos do Editor e não adiciona um sistema de runtime aos jogos empacotados. Suas Notas, Pins e Documentos externos não são UAssets e não são cozidos automaticamente como conteúdo do jogo. Manter dados do espaço de trabalho após a remoção não cria uma dependência do jogo em relação ao Locus.

Revise Limitações conhecidas e depois siga Primeiros passos.