Instalacja

Locus to wtyczka Unreal Engine działająca wyłącznie w edytorze. Wybierz instalację przez Fab albo zgodny wstępnie skompilowany pakiet binarny.

Przed instalacją

Użyj wersji Locus zbudowanej dokładnie dla wersji Unreal Engine używanej przez projekt. Pakiet zbudowany dla innej wersji silnika może się nie załadować.
Locus 1.1 obsługuje kompilacje Win64 Unreal Engine 5.4–5.8. macOS i Linux nie są obsługiwanymi platformami wydania.

Dostęp do Python Developer API jest opcjonalny i wymaga Unreal Engine 5.6 lub nowszego. Nie jest obsługiwany w UE 5.4 i 5.5 z powodu zweryfikowanego ograniczenia refleksji Unreal Engine w ścieżce wywołań Pythona, ale zwykły Locus oraz C++, Blueprint i MCP pozostają obsługiwane w tych wersjach.

Instalacja przez Fab

Podczas instalacji przez Fab lub Epic Games Launcher wybierz wersję Locus dla wersji Unreal Engine, której zamierzasz używać. Ręczne kopiowanie plików wtyczki nie jest wymagane.

Otwórz projekt docelowy w Unreal Editor.
Otwórz Edit > Plugins i włącz Locus, jeśli nie jest jeszcze włączony.
Uruchom ponownie Unreal Editor, gdy pojawi się monit.

Po ponownym uruchomieniu otwórz Locus przez Window > Locus, przycisk Locus na pasku narzędzi Przeglądarki zawartości albo Ctrl+Shift+L.

Ręczna instalacja wstępnie skompilowanego pakietu binarnego

Pakiety Locus dystrybuowane ręcznie zawierają wymagane wstępnie skompilowane pliki binarne dla obsługiwanej wersji Unreal Engine. Wybierz pakiet zbudowany dokładnie dla wersji silnika, której zamierzasz używać.

Przed skopiowaniem lub zastąpieniem plików wtyczki zamknij Unreal Editor. Skopiuj cały katalog wtyczki Locus; nie kopiuj tylko Binaries i nie łącz plików z pakietów zbudowanych dla różnych wersji Unreal Engine.

Instalacja dla konkretnego projektu

Skopiuj cały folder wtyczki Locus do:

<ProjectRoot>/Plugins/Locus/

Utwórz katalog Plugins projektu, jeśli nie istnieje. Dzięki temu Locus będzie dostępny dla tego projektu, a wersja wtyczki pozostanie powiązana z projektem. Jest to przydatne, gdy różne projekty wymagają różnych wersji Locus lub silnika.

Instalacja dla całego silnika

Skopiuj cały folder wtyczki Locus do:

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

Dzięki temu Locus będzie dostępny dla projektów otwieranych przy użyciu tej konkretnej instalacji Unreal Engine, bez konieczności kopiowania tego samego pakietu do każdego projektu. Nie instaluje to Locus w innych wersjach silnika. Włącz Locus osobno w każdym projekcie, w którym ma być używany.

Zakończenie instalacji ręcznej

Otwórz ponownie projekt w dokładnie pasującej wersji Unreal Engine.
W Edit > Plugins znajdź Locus i włącz go, jeśli nie jest jeszcze włączony.
Uruchom ponownie Unreal Editor, gdy pojawi się monit.

Otwórz Locus przez Window > Locus, przycisk Locus na pasku narzędzi Przeglądarki zawartości albo Ctrl+Shift+L.

Oficjalnie dostarczony, zgodny wstępnie skompilowany pakiet binarny nie wymaga generowania plików projektu, kompilowania Locus, przebudowywania wtyczki, otwierania Visual Studio ani modyfikowania plików .Build.cs.

Lokalizacje danych tworzone podczas używania

Locus tworzy dane w miarę używania poszczególnych typów zawartości:

Zawartość	Lokalizacja widoczna w projekcie
Współdzielone Notatki	`<Project>/ProjectNotes/`
Współdzielone Pinezki	`<Project>/ProjectPins/`
Dokumenty	`<Project>/ProjectDocuments/`
Prywatne Notatki i Pinezki, odzyskiwanie oraz osobisty stan interfejsu projektu	`<Project>/Saved/Locus/` i powiązane foldery odzyskiwania w `<Project>/Saved/`

Informacje o własności i zależnościach znajdziesz na stronach Notatki, Pinezki, Dokumenty i Wpływ na projekt i zależności.

Wyłączanie lub usuwanie Locus

Wyłączenie lub usunięcie wtyczki zatrzymuje jej interfejs edytora; nie usuwa celowo wymienionych wyżej plików zewnętrznych. Przed odinstalowaniem wtyczki wykonaj kopię zapasową projektu i osobno zdecyduj, czy zachowane dane Locus powinny pozostać w projekcie lub repozytorium kontroli wersji.

Locus zawiera wyłącznie moduły edytora i nie dodaje systemu uruchomieniowego do spakowanych gier. Jego zewnętrzne Notatki, Pinezki i Dokumenty nie są UAssetami i nie są automatycznie przygotowywane jako zawartość gry. Zachowanie danych obszaru roboczego po usunięciu wtyczki nie powoduje powstania zależności gry od Locus.

Przejrzyj Znane ograniczenia, a następnie przejdź do strony Pierwsze kroki.