Installazione

Locus è un plugin Unreal Engine solo Editor. Scegli l’installazione tramite Fab oppure un pacchetto binario precompilato corrispondente.

Prima di installare

• Usa la versione di Locus compilata per la versione esatta di Unreal Engine usata dal progetto. Un pacchetto compilato per un’altra versione Engine potrebbe non caricarsi.
• Locus 1.1 supporta build Win64 di Unreal Engine 5.4–5.8. macOS e Linux non sono piattaforme di rilascio supportate.

L’accesso alla Python Developer API è facoltativo e richiede Unreal Engine 5.6 o versioni successive. Non è supportato su UE 5.4 e 5.5 a causa di una limitazione verificata del sistema di reflection di Unreal nel percorso di invocazione Python; Locus normale, C++, Blueprint e MCP restano supportati su queste versioni.

Installa tramite Fab

Quando installi tramite Fab o Epic Games Launcher, seleziona la versione di Locus per la versione Unreal Engine che intendi usare. Non è necessario copiare manualmente i file del plugin.

1. Apri il progetto di destinazione in Unreal Editor.
2. Apri Edit > Plugins e abilita Locus se non è già abilitato.
3. Riavvia Unreal Editor se richiesto.

Dopo il riavvio, apri Locus da Window > Locus, dal pulsante Locus nella barra degli strumenti del Content Browser oppure con Ctrl+Shift+L.

Installa manualmente un pacchetto binario precompilato

I pacchetti Locus distribuiti manualmente includono i binari precompilati necessari per la versione Unreal Engine supportata. Seleziona il pacchetto compilato per la versione Engine esatta che intendi usare.

Chiudi Unreal Editor prima di copiare o sostituire i file del plugin. Copia l’intera directory del plugin Locus; non copiare soltanto Binaries e non unire file di pacchetti compilati per versioni Engine diverse.

Installazione specifica del progetto

Copia l’intera cartella del plugin Locus in:

<ProjectRoot>/Plugins/Locus/

Crea la directory Plugins del progetto se non esiste. Locus sarà disponibile per quel progetto e la sua versione resterà associata a esso, utile quando progetti diversi richiedono versioni diverse di Locus o Engine.

Installazione a livello Engine

Copia l’intera cartella del plugin Locus in:

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

Locus sarà disponibile ai progetti aperti con quella specifica installazione Unreal Engine, senza copiare il pacchetto in ogni progetto. Non installa Locus nelle altre versioni Engine. Abilita Locus separatamente in ogni progetto in cui lo userai.

Completa l’installazione manuale

1. Riapri il progetto con la versione Unreal Engine esatta e corrispondente.
2. In Edit > Plugins, trova Locus e abilitalo se non è già abilitato.
3. Riavvia Unreal Editor quando richiesto.

Apri Locus da Window > Locus, dal pulsante Locus nella barra degli strumenti del Content Browser oppure con Ctrl+Shift+L.

Un pacchetto binario precompilato corrispondente e fornito ufficialmente non richiede la generazione dei file di progetto, la compilazione di Locus, la ricostruzione del plugin, l’apertura di Visual Studio o la modifica di file .Build.cs.

Percorsi dati creati dall’uso

Locus crea lo spazio di archiviazione man mano che viene usato ogni tipo di contenuto:

Contenuto	Percorso visibile nel progetto
Note condivise	<Project>/ProjectNotes/
Pin condivisi	<Project>/ProjectPins/
Documenti	<Project>/ProjectDocuments/
Note e Pin privati, recupero e stato UI personale del progetto	<Project>/Saved/Locus/ e cartelle di recupero correlate sotto <Project>/Saved/

Vedi Note, Pin, Documenti e Impatto sul progetto e dipendenze per dettagli su proprietà e dipendenze.

Disabilitare o rimuovere Locus

La disabilitazione o rimozione del plugin interrompe la UI dell’Editor; non elimina intenzionalmente i file esterni elencati sopra. Esegui un backup del progetto prima di disinstallare un plugin e decidi separatamente se conservare i dati Locus nel progetto o nel repository del controllo del codice sorgente.

Dati privati e di recupero

Se usi Note private, Pin privati o copie di recupero, non considerare la cartella Saved del progetto come una cartella temporanea che può essere eliminata. Pulire o eliminare Saved può causare la perdita definitiva di quei dati.

Locus contiene solo moduli Editor e non aggiunge un sistema runtime ai giochi pacchettizzati. Note, Pin e Documenti esterni non sono UAsset e non vengono cotti automaticamente come contenuto del gioco. Conservare i dati dell’area di lavoro dopo la rimozione non crea una dipendenza del gioco da Locus.

Esamina Limitazioni note, quindi segui Per iniziare.