Primeiros passos

Este passo a passo apresenta os três espaços de trabalho do Locus sem exigir controle de código-fonte ou uma conta online.

1. Abrir o Locus

Abra Window > Locus, use o botão do Locus na barra de ferramentas do Content Browser ou pressione Ctrl+Shift+L. A navegação superior alterna entre Notas, Pins e Documentos. O botão Configurações fica no lado direito da barra de ferramentas principal.

2. Criar uma Nota

Abra Notas, escolha Nova Nota e selecione um escopo:

• Compartilhado armazena um arquivo .uenote em <Project>/ProjectNotes/ para colaboração no projeto.
• Privado armazena o arquivo em <Project>/Saved/Locus/PrivateNotes/ para o espaço de trabalho local do projeto atual.

Dê um título útil à Nota, insira o texto do corpo e, opcionalmente, adicione tags ou referências de assets. As Notas são salvas automaticamente após um pequeno atraso de edição. Pressione Ctrl+S para salvar imediatamente ou tentar novamente um salvamento que falhou.

Saiba mais sobre pastas, pesquisa, recuperação e conflitos em Notas.

3. Colocar um Pin

Abra um nível salvo, mude para Pins e escolha uma ação de colocação Compartilhada ou Privada. Clique em uma superfície no viewport do nível para colocar o Pin; pressione Esc para sair do Modo de Colocação.

Um Pin pode conter título, corpo, tags, comentários e tipo. Ele é armazenado em um arquivo .locuspin fora do mapa. Colocar ou editar um Pin não adiciona um Actor nem deixa o pacote do mapa sujo.

Consulte Pins para controles do viewport, visualizações salvas e configurações de visibilidade.

4. Criar um Documento

Mude para Documentos. Crie sob Documentos do Locus para um arquivo Markdown exclusivo do Locus ou sob Navegador de Conteúdo para um Documento mapeado na pasta /Game correspondente. Ambos são arquivos .md de propriedade do projeto sob <Project>/ProjectDocuments/; as raízes esclarecem a apresentação sem criar repositórios separados. Documentos novos começam Não rastreado, para que você possa organizá-los, renomeá-los, movê-los e editá-los antes de escolher Marcar para Adição quando o caminho estiver final.

Documentos usam salvamento explícito: pressione Ctrl+S. O Modo de Edição mostra a fonte Markdown; o Modo de Leitura apresenta Markdown compatível com a UI nativa do Unreal. Vários Documentos podem ficar abertos ao mesmo tempo.

Consulte Documentos para mapeamento do Content Browser, importação/exportação e limitações do Markdown.

Modo local

O controle de origem é opcional. Sem nenhum provedor configurado, o Locus edita arquivos locais e não rastreados no Modo Local sem operações do provedor ou UI específica de controle de origem. Com um provedor configurado, os novos Notas compartilhados retêm sua solicitação de adição pós-criação; os novos Pins e Documentos compartilhados permanecem Untracked até que você escolha explicitamente Marcar para Adição. O conteúdo controlado permanece protegido quando seu provedor não está disponível e o conteúdo privado nunca entra em contato com o provedor. Consulte Controle de Código-Fonte.

6. Ajustar seu espaço de trabalho

Abra Configurações para alterar aparência, apresentação do Editor, tamanhos de fonte, quebra de linha, densidade da árvore, restauração do espaço de trabalho e apresentação dos Pins. Ações de redefinição afetam o estado da UI, não o conteúdo. Consulte Configurações e Aparência.

7. Conectar um cliente MCP (opcional)

O Locus pode se conectar opcionalmente a um cliente MCP local compatível para Notas, Documentos, Pins e informações de status compatíveis enquanto o Unreal Editor estiver aberto. Ele não inclui um assistente de IA autônomo; o cliente conectado executa o fluxo de IA. Comece pela Integração MCP quando estiver pronto para configurá-la.

Para relatar um problema ou sugestão, escolha Enviar Feedback no Locus ou visite o site de feedback.