시작하기

이 안내서는 소스 컨트롤이나 온라인 계정 없이 Locus의 세 작업 공간을 소개합니다.

1. Locus 열기

Window > Locus를 열거나 콘텐츠 브라우저 툴바의 Locus 버튼을 사용하거나 Ctrl+Shift+L을 누릅니다. 상단 탐색에서 노트, 핀, 문서 사이를 전환합니다. 설정 버튼은 기본 툴바 오른쪽에 있습니다.

2. 노트 만들기

노트를 열고 새 노트를 선택한 다음 범위를 지정합니다.

• 공유는 프로젝트 협업을 위한 .uenote 파일을 <Project>/ProjectNotes/ 아래에 저장합니다.
• 개인은 현재 로컬 프로젝트 작업 공간을 위한 파일을 <Project>/Saved/Locus/PrivateNotes/ 아래에 저장합니다.

노트에 알아보기 쉬운 제목을 지정하고 본문을 입력한 뒤 필요하면 태그나 애셋 참조를 추가합니다. 노트는 짧은 편집 지연 후 자동으로 저장됩니다. 즉시 저장하거나 실패한 저장을 다시 시도하려면 Ctrl+S를 누릅니다.

폴더, 검색, 복구, 충돌에 관한 내용은 노트에서 확인하세요.

3. 핀 배치

저장된 레벨을 열고 핀으로 전환한 다음 공유 또는 개인 배치 작업을 선택합니다. 레벨 뷰포트의 표면을 클릭해 핀을 배치하고 Esc를 눌러 배치 모드를 종료합니다.

핀에는 제목, 본문, 태그, 댓글, 유형을 포함할 수 있습니다. 핀은 맵 외부의 .locuspin 파일에 저장됩니다. 핀을 배치하거나 편집해도 Actor가 추가되거나 맵 패키지가 변경된 것으로 표시되지 않습니다.

뷰포트 조작, 저장된 뷰, 표시 설정은 핀을 참조하세요.

4. 문서 만들기

문서로 전환합니다. Locus 전용 Markdown 파일을 만들려면 Locus 문서 아래에 만들고, 해당 /Game 폴더에 매핑되는 문서를 만들려면 콘텐츠 브라우저 아래에 만듭니다. 두 위치 모두 <Project>/ProjectDocuments/ 아래의 프로젝트 소유 .md 파일입니다. 루트는 표시 방법을 구분할 뿐 별도 리포지토리를 만들지 않습니다. 새 문서는 추적되지 않음으로 시작하므로 경로를 확정하기 전에 정리, 이름 변경, 이동, 편집을 수행한 다음 추가 대상으로 표시를 선택할 수 있습니다.

문서는 명시적으로 저장합니다. Ctrl+S를 누르세요. 편집 모드는 Markdown 소스를 표시하고, 읽기 모드는 지원되는 Markdown을 네이티브 Unreal UI로 표시합니다. 여러 문서를 동시에 열 수 있습니다.

콘텐츠 브라우저 매핑, 가져오기/내보내기, Markdown 제한은 문서에서 확인하세요.

로컬 모드

소스 제어는 선택 사항입니다. 구성된 공급자가 없으면 Locus는 공급자 작업이나 소스 제어 관련 UI 없이 로컬 모드에서 로컬 및 추적되지 않은 파일을 편집합니다. 구성된 공급자를 사용하면 새로운 공유 노트가 생성 후 추가 요청을 유지합니다. 새로운 공유 핀 및 문서는 명시적으로 추가 대상으로 표시를 선택할 때까지 Untracked로 유지됩니다. 제어된 콘텐츠는 해당 공급자를 사용할 수 없는 경우에도 보호된 상태로 유지되며 비공개 콘텐츠는 공급자에 연결되지 않습니다. 소스 컨트롤를 참조하세요.

6. 작업 공간 조정

설정을 열어 모양, 에디터 표시, 글꼴 크기, 줄 바꿈, 트리 밀도, 작업 공간 복원, 핀 표시를 변경합니다. 재설정 작업은 콘텐츠가 아니라 UI 상태에 영향을 줍니다. 설정 및 모양을 참조하세요.

7. MCP 클라이언트 연결(선택 사항)

Unreal Editor가 열려 있는 동안 Locus는 호환되는 로컬 MCP 클라이언트를 선택적으로 연결해 지원되는 노트, 문서, 핀, 상태 정보를 사용할 수 있습니다. 자율 AI 어시스턴트는 포함되지 않으며 AI 워크플로는 연결된 클라이언트가 수행합니다. 설정할 준비가 되면 MCP 통합부터 시작하세요.

문제나 제안을 보고하려면 Locus에서 의견 보내기를 선택하거나 피드백 사이트를 방문하세요.