Installation

Locus est un plugin Unreal Engine réservé à l’Editor. Choisissez l’installation Fab ou un package binaire précompilé correspondant.

Avant l’installation

• Utilisez la version de Locus créée pour la version exacte d’Unreal Engine utilisée par le projet. Un package créé pour une autre version d’Engine peut ne pas se charger.
• Locus 1.1 prend en charge les builds Win64 d’Unreal Engine 5.4 à 5.8. macOS et Linux ne sont pas des plateformes de publication prises en charge.

L’accès à la Python Developer API est facultatif et nécessite Unreal Engine 5.6 ou une version ultérieure. Il n’est pas pris en charge sous UE 5.4 et 5.5 en raison d’une limitation vérifiée de la réflexion Unreal dans le chemin d’invocation Python ; Locus normal, C++, Blueprint et MCP restent pris en charge sur ces versions.

Installer via Fab

Lors de l’installation via Fab ou Epic Games Launcher, sélectionnez la version de Locus correspondant à la version d’Unreal Engine que vous comptez utiliser. La copie manuelle des fichiers du plugin n’est pas nécessaire.

1. Ouvrez le projet cible dans Unreal Editor.
2. Ouvrez Edit > Plugins et activez Locus s’il ne l’est pas déjà.
3. Redémarrez Unreal Editor si vous y êtes invité.

Après le redémarrage, ouvrez Locus depuis Window > Locus, le bouton Locus de la barre d’outils du Content Browser ou Ctrl+Shift+L.

Installer manuellement un package binaire précompilé

Les packages Locus distribués manuellement incluent les binaires précompilés nécessaires pour leur version d’Unreal Engine prise en charge. Sélectionnez le package créé pour la version exacte d’Engine que vous souhaitez utiliser.

Fermez Unreal Editor avant de copier ou remplacer les fichiers du plugin. Copiez le répertoire complet du plugin Locus ; ne copiez pas seulement Binaries et ne mélangez pas des fichiers provenant de packages créés pour des versions différentes d’Engine.

Installation propre au projet

Copiez le dossier complet du plugin Locus dans :

<ProjectRoot>/Plugins/Locus/

Créez le répertoire Plugins du projet s’il n’existe pas. Locus devient ainsi disponible pour ce projet et sa version reste associée à celui-ci, ce qui est utile lorsque différents projets nécessitent différentes versions de Locus ou d’Engine.

Installation à l’échelle de l’Engine

Copiez le dossier complet du plugin Locus dans :

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

Locus devient ainsi disponible pour les projets ouverts avec cette installation précise d’Unreal Engine, sans avoir à copier le même package dans chaque projet. Cela n’installe pas Locus dans les autres versions d’Engine. Activez Locus séparément dans chaque projet où il sera utilisé.

Terminer l’installation manuelle

1. Rouvrez le projet avec la version exacte d’Unreal Engine correspondante.
2. Dans Edit > Plugins, recherchez Locus et activez-le s’il ne l’est pas déjà.
3. Redémarrez Unreal Editor lorsque vous y êtes invité.

Ouvrez Locus depuis Window > Locus, le bouton Locus de la barre d’outils du Content Browser ou Ctrl+Shift+L.

Un package binaire précompilé correspondant et fourni officiellement ne vous oblige pas à générer les fichiers du projet, compiler Locus, reconstruire le plugin, ouvrir Visual Studio ou modifier des fichiers .Build.cs.

Emplacements de données créés par l’utilisation

Locus crée le stockage au fur et à mesure que chaque type de contenu est utilisé :

Contenu	Emplacement visible dans le projet
Notes partagées	<Project>/ProjectNotes/
Repères partagés	<Project>/ProjectPins/
Documents	<Project>/ProjectDocuments/
Notes et Repères privés, récupération et état UI personnel du projet	<Project>/Saved/Locus/ et dossiers de récupération associés sous <Project>/Saved/

Voir Notes, Repères, Documents et Impact du projet et dépendances pour les règles de propriété et de dépendance.

Désactiver ou supprimer Locus

Désactiver ou supprimer le plugin arrête son interface dans l’Editor ; cela ne supprime pas volontairement les fichiers externes indiqués ci-dessus. Sauvegardez le projet avant de désinstaller un plugin et décidez séparément si les données Locus conservées doivent rester dans le projet ou le dépôt de contrôle de source.

Données privées et de récupération

Si vous utilisez des Notes privées, des Repères privés ou des copies de récupération, ne considérez pas le dossier Saved du projet comme un dossier temporaire que vous pouvez supprimer. Nettoyer ou supprimer Saved peut entraîner la perte définitive de ces données.

Locus ne contient que des modules réservés à l’Editor et n’ajoute pas de système d’exécution aux jeux packagés. Ses Notes, Repères et Documents externes ne sont pas des UAssets et ne sont pas cuits automatiquement comme contenu de jeu. Conserver les données d’espace de travail après la suppression ne crée pas de dépendance du jeu à Locus.

Consultez Limitations connues, puis suivez Bien démarrer.