Rozwiązywanie problemów

Zacznij od poniższego objawu. Zachowaj pliki projektu przed ręczną zmianą przechowywania.

Locus nie jest dostępny lub się nie ładuje

Potwierdź, że wtyczka znajduje się w <Project>/Plugins/Locus/ i jest włączona w Edit > Plugins.
Potwierdź, że pakiet pasuje do dokładnej wersji podrzędnej Unreal Engine projektu.
Uruchom ponownie Unreal Editor po włączeniu lub wymianie wtyczki.
Spróbuj Window > Locus albo Ctrl+Shift+L.
Sprawdź Unreal Output Log pod kątem kategorii LogLocus i błędu ładowania wtyczki.

Jeśli pakiet binarny jest przeznaczony dla innej wersji podrzędnej silnika, zastąp go właściwym pakietem; nie kopiuj pojedynczych plików binarnych między pakietami.

Zawartość jest tylko do odczytu

Otwórz stronę Kontrola wersji i sprawdź, czy plik jest kontrolowany, pobrany do edycji przez innego użytkownika lub klienta, nieaktualny albo niedostępny z powodu odłączenia dostawcy. Czysty kontrolowany plik również pozostaje tylko do odczytu, dopóki jawnie go nie pobierzesz do edycji.

Akcja Pobierz do edycji może być niedostępna, gdy inny klient posiada plik, obszar roboczy jest opóźniony względem depot lub dostawca nie może zgłosić bezpiecznego stanu. Rozwiąż własność lub stan rewizji za pomocą zwykłego procesu kontroli wersji projektu. Po ponownym połączeniu dostawcy odśwież Kontrolę wersji Unreal lub Locus; kontrolowana zawartość pozostaje tylko do odczytu, dopóki pobranie do edycji się nie powiedzie. Nie omijaj ochrony przez zmianę uprawnień systemu plików.

Prywatne Notatki i Pinezki nie powinny zależeć od dostawcy. Jeśli są niedostępne, sprawdź, czy przechowywanie projektu Saved/Locus istnieje i jest zapisywalne.

Jeśli nie skonfigurowano żadnego dostawcy, brak statusu kontroli źródła, podpowiedzi, wskazówek, interfejsu użytkownika Pobierz do edycji lub Oznacz do dodania jest normalnym trybem lokalnym. Skonfigurowany, ale niedostępny dostawca jest inny i zapewnia ochronę znanych kontrolowanych treści.

Pobieranie do edycji lub Oznacz do dodania nie powiodło się

Upewnij się, że dostawca Unreal jest skonfigurowany, podłączony i może zgłosić plik. Nieudane żądanie Oznacz do dodania po utworzeniu pozostawia nowy współdzielony notatka na dysku. Nowe współdzielone modele pinezka i dokument pozostają Untracked do czasu wyraźnego dodania; Współdzielone migawki pinezka mają oddzielny stan kontroli źródła.

Dokument nie zmienia nazwy ani nie daje się przenieść

Do zmiany nazwy i przenoszenia używaj obszaru roboczego Dokumentów Locus; element Przeglądarki zawartości jest projekcją, a nie autorytatywną powierzchnią zmiany nazwy. Kwalifikujący się Nieśledzony Dokument można zmienić nazwę przez Zmień nazwę lub F2, a przenieść przez Przenieś albo przeciągnięcie i upuszczenie do prawidłowego istniejącego folderu. Locus celowo blokuje Zmień nazwę i Przenieś dla Dokumentów oznaczonych do dodania i kontrolowanych, ponieważ nie może bezpiecznie wykonać neutralnego względem dostawcy przeniesienia przez kontrolę wersji. Nie obchodź tego przez wyłączenie kontroli wersji ani zmianę uprawnień systemu plików; uporządkuj Dokument przed Oznacz do dodania.

Notatki, Pinezki lub Dokumenty nie odświeżają się

Użyj akcji przebudowy lub odświeżania aktywnego obszaru roboczego. W przypadku Dokumentów zmienionych w zewnętrznym edytorze zapisz prawidłowy plik .md w UTF-8 pod ProjectDocuments. W przypadku Pinezek potwierdź, że bieżący świat jest zapisany i że Pinezka jest powiązana z rozpoznaną mapą.

Odzyskiwanie jest dostępne

Przed działaniem przejrzyj podstawowy element na dysku i kopię odzyskiwania. Odzyskaj zastępuje podstawowy element odzyskaną pracą, Odzyskaj jako nowy zachowuje oba elementy, a Odrzuć usuwa kopię. Jeśli nie masz pewności, wybierz odzyskanie jako nowego elementu.

Konflikt zewnętrzny

Konflikt zewnętrzny oznacza, że plik na dysku zmienił się, gdy Locus miał niezapisane edycje. Nie wymuszaj zastąpienia. Użyj oferowanych działań, aby ponownie wczytać dysk, zapisać lokalną pracę jako nowy element, skopiować lokalny tekst lub porównać wersje, gdy jest to możliwe.

Nieprawidłowe lub nieobsługiwane dane

Zachowaj oryginalny plik i sprawdź komunikat LogLocus. Nie edytuj ręcznie identyfikatorów ani pól własności, chyba że masz zweryfikowaną kopię zapasową i rozumiesz format. Nieprawidłowy plik Markdown w UTF-8 jest odrzucany przy imporcie. Nieobsługiwany Markdown powinien pozostać niezmieniony jako źródło, nawet jeśli Tryb odczytu nie może go w pełni zaprezentować.

Brak odniesienia lub jest ono nieaktualne

Odśwież odpowiedni obszar roboczy i sprawdź, czy zasób, pinezka, notatka, dokument lub Actor nadal istnieje. Przesunięty lub usunięty cel może pozostać czytelny, ale nierozwiązany, więc można go celowo naprawić.

Utwórz referencję Actor tylko poprzez przeciągnięcie dokładnie jednego kwalifikującego się załadowanego Actor z World Outliner do edytowalnego notatka lub dokument. Nie ma go w Wstaw odniesienie i @; Instancje poziomów i nieobsługiwane światy przejściowe lub podglądowe nie są obsługiwane.

Pinezki są niedostępne

Trwałe Pinezki wymagają zapisanej przestrzeni świata najwyższego poziomu edytora. Zapisz mapę, wróć do Bieżąca mapa i ponów umieszczanie. Pliki Pinezek nie ładują ani nie modyfikują map tylko na potrzeby przeglądania Wszystkie mapy.

Przechwytywanie i aktualizacja migawek również wymagają dostępnej rzutni perspektywicznej Level Editor i są niedostępne podczas PIE.

Brak Dokumentów

Potwierdź, że plik .md znajduje się pod <Project>/ProjectDocuments/ i używa prawidłowego UTF-8. Ścieżka poza zarezerwowanym poddrzewem Content/ pojawia się pod Dokumenty Locus i nie jest odwzorowywana w Przeglądarce zawartości Unreal. Ścieżka pod ProjectDocuments/Content/ pojawia się pod rzadkim korzeniem Przeglądarka zawartości i odwzorowuje się na pasujący kontekst /Game. Odśwież Dokumenty po zmianach zewnętrznych. Niezwiązane foldery /Game są celowo nieobecne, ponieważ drzewo pochodzi z indeksowanych Dokumentów, a nie folderów Asset Registry. Pamiętaj, że Dokumenty są zewnętrznymi elementami projekcji, a nie UAssetami.

Markdown nie renderuje się zgodnie z oczekiwaniami

Sprawdź stronę Dokumenty pod kątem obsługiwanych konstrukcji. Surowy HTML i niebezpieczne adresy URL pozostają nieaktywne, zewnętrzna zawartość nie jest pobierana, a renderowanie równoważne przeglądarce nie jest obiecane. Przełącz się na Tryb edycji, aby potwierdzić, że autorytatywne źródło jest nienaruszone.

Klient MCP nie łączy się lub dostęp jest odrzucany

Pozostaw Unreal Editor otwarty i użyj Editor Preferences > Plugins > Locus > MCP Integration, aby potwierdzić, że Włącz MCP jest włączone, a stan pokazuje działanie. Jeśli lokalny punkt końcowy lub konfiguracja klienta są niedostępne, skopiuj świeżą konfigurację po zmianie lokalnego portu lub ponownym wygenerowaniu poświadczenia.

Wybierz pasujący Format klienta przed kopiowaniem. Polecenia rejestracji Claude Code i Gemini CLI uruchamiaj w zwykłym terminalu, a nie wewnątrz ich interaktywnych monitów. Gemini używa zakresu użytkownika, więc starszy globalny wpis locus może nadal wskazywać punkt końcowy innego projektu; zastąp go świeżą konfiguracją z aktualnie otwartego projektu. Nigdy nie wklejaj skopiowanego polecenia ani poświadczenia do zgłoszenia pomocy.

Tylko jeden klient może posiadać aktywną sesję Locus. Zamknij lub odłącz poprzedniego klienta, krótko odczekaj i spróbuj ponownie; użyj Zresetuj aktywnego klienta tylko wtedy, gdy ten klient nie jest już używany. Mutacja wymaga Zezwalaj na zmiany, a Prywatne Notatki lub Pinezki wymagają osobno Zezwalaj na Prywatne notatki i Pinezki. Praca MCP z Pinezkami jest ograniczona do obsługiwanej zapisanej należącej do projektu podstawy świata /Game/....

Zobacz Integracja MCP — pełne wskazówki dotyczące połączenia, uprawnień, obsługiwanych narzędzi i kontekstu Pinezek.

Dokumentacja lub opinia nie otwiera się

Linki zewnętrzne używają domyślnej przeglądarki systemu operacyjnego. Sprawdź, czy skonfigurowano domyślną przeglądarkę HTTP/HTTPS i czy system operacyjny zezwala na uruchamianie adresów URL. Błąd nie zmienia danych projektu. Integracja MCP zawiera przycisk Dokumentacja, a Locus udostępnia również Przekaż opinię.