Résolution des problèmes

Commencez par le symptôme ci-dessous. Préservez les fichiers du projet avant toute modification manuelle du stockage.

Locus est absent ou ne se charge pas

1. Vérifiez que le plugin se trouve dans <Project>/Plugins/Locus/ et qu’il est activé dans Edit > Plugins.
2. Vérifiez que le package correspond exactement à la version mineure d’Unreal Engine du projet.
3. Redémarrez Unreal Editor après avoir activé ou remplacé le plugin.
4. Essayez Window > Locus ou Ctrl+Shift+L.
5. Consultez l’Unreal Output Log pour la catégorie LogLocus et l’erreur de chargement du plugin.

Si un package binaire cible une autre version mineure d’Engine, remplacez-le par le bon package ; ne copiez pas de binaires individuels entre packages.

Le contenu est en lecture seule

Ouvrez Contrôle de source et vérifiez si le fichier est contrôlé, extrait par un autre utilisateur ou client, pas à jour ou indisponible parce que le fournisseur est déconnecté. Un fichier contrôlé propre reste également en lecture seule jusqu’à son extraction explicite.

Extraire peut être indisponible lorsqu’un autre client possède le fichier, que votre espace de travail est en retard sur le dépôt ou que le fournisseur ne peut pas signaler un état sûr. Résolvez la propriété ou l’état de révision avec le workflow normal du projet. Après la reconnexion d’un fournisseur, actualisez Unreal Source Control ou Locus ; le contenu contrôlé reste en lecture seule jusqu’à la réussite de l’extraction. Ne contournez pas la protection en modifiant les permissions du système de fichiers.

Les Notes et Repères privés ne devraient pas dépendre d’un fournisseur. S’ils sont indisponibles, vérifiez que le stockage Saved/Locus du projet existe et est accessible en écriture.

Sans fournisseur configuré, l’absence d’état de contrôle de source, d’info-bulle, de conseils, d’interface utilisateur Extraire ou Marquer pour ajout est un mode local normal. Un fournisseur configuré mais indisponible est différent et protège le contenu contrôlé connu.

L’extraction ou le marquage pour ajout a échoué

Confirmez que le fournisseur de Unreal est configuré, connecté et peut signaler le fichier. Un échec de demande de post-création Marquer pour ajout laisse un nouveau Note partagé sur le disque. Les nouveaux repère et Document partagés restent Untracked jusqu’à ce qu’ils soient explicitement ajoutés ; Les instantanés repère partagés ont un état de contrôle de source distinct.

Un Document ne peut pas être renommé ou déplacé

Utilisez l’espace de travail Documents Locus pour renommer et déplacer ; l’élément Content Browser est une projection et non la surface de renommage faisant autorité. Un Document Non suivi éligible peut être renommé avec Renommer ou F2, et déplacé avec Déplacer ou par glisser-déposer vers un dossier existant valide. Locus bloque intentionnellement Renommer et Déplacer pour les Documents marqués pour ajout ou contrôlés, car il ne peut pas effectuer en sécurité un déplacement de contrôle de source neutre vis-à-vis du fournisseur. Ne contournez pas cela en désactivant le contrôle de source ou en modifiant les permissions du système de fichiers ; organisez le Document avant de le marquer pour ajout.

Les Notes, Repères ou Documents ne s’actualisent pas

Utilisez l’action de reconstruction ou d’actualisation de l’espace de travail actif. Pour les Documents modifiés dans un éditeur externe, enregistrez un fichier .md UTF-8 valide sous ProjectDocuments. Pour les Repères, confirmez que le monde actuel est enregistré et que le Repère est associé à sa carte résolue.

Une récupération est disponible

Examinez l’élément faisant autorité sur le disque et l’instantané de récupération avant d’agir. Restaurer remplace l’élément faisant autorité par le travail récupéré, Restaurer comme nouveau préserve les deux et Abandonner supprime l’instantané. Préférez la restauration comme nouveau lorsque vous avez un doute.

Ne pas nettoyer Saved comme raccourci de dépannage

L’arborescence Saved du projet peut contenir des Notes privées, des Repères privés et des instantanés de récupération. La supprimer peut détruire définitivement du contenu utilisateur.

Conflit externe

Un conflit externe signifie que le fichier du disque a changé alors que Locus détenait des modifications non enregistrées. Ne forcez pas l’écrasement. Utilisez les actions proposées pour recharger le disque, enregistrer le travail local comme nouvel élément, copier le texte local ou comparer les versions lorsque cela est possible.

Données malformées ou non prises en charge

Conservez le fichier original et examinez le message LogLocus. Ne modifiez pas manuellement les identifiants ou les champs de propriété sauf si vous disposez d’une sauvegarde vérifiée et comprenez le format. Un fichier Markdown UTF-8 invalide est refusé à l’import. Le Markdown non pris en charge doit rester intact comme source, même si le Mode lecture ne peut pas le présenter complètement.

Une référence est manquante ou obsolète

Actualisez l’espace de travail concerné et vérifiez que l’actif, repère, Note, Document ou Actor existe toujours. Une cible déplacée ou supprimée peut rester lisible mais non résolue afin que vous puissiez la réparer délibérément.

Créez une référence Actor uniquement en faisant glisser exactement un Actor chargé éligible du World Outliner vers un Note ou un Document modifiable. Il est absent des Insérer la référence et @ ; Les instances de niveau et les mondes transitoires ou d’aperçu non pris en charge ne sont pas pris en charge.

Les Repères sont indisponibles

Les Repères persistants nécessitent un monde Editor de niveau supérieur enregistré. Enregistrez la carte, revenez à Carte actuelle et réessayez le placement. Les fichiers de Repère ne chargent ni ne modifient les cartes lors de la consultation Toutes les cartes.

La capture et la mise à jour d’instantanés nécessitent également une fenêtre d’affichage en perspective Level Editor disponible et ne sont pas disponibles pendant PIE.

Les Documents sont absents

Vérifiez que le fichier .md se trouve sous <Project>/ProjectDocuments/ et utilise UTF-8 valide. Un chemin en dehors du sous-arbre Content/ réservé apparaît sous Documents Locus et n’est pas projeté dans le Content Browser d’Unreal. Un chemin sous ProjectDocuments/Content/ apparaît sous la racine clairsemée Navigateur de contenu et est projeté dans le contexte /Game correspondant. Actualisez Documents après des changements externes. Les dossiers /Game non liés sont volontairement absents, car l’arborescence provient des Documents indexés et non des dossiers de l’Asset Registry. N’oubliez pas que les Documents sont des éléments externes projetés et non des UAssets.

Le Markdown ne s’affiche pas comme prévu

Consultez Documents pour les constructions prises en charge. Le HTML brut et les URL dangereuses restent inertes, le contenu distant n’est pas récupéré et le rendu Markdown équivalent à un navigateur n’est pas promis. Passez en Mode édition pour confirmer que la source faisant autorité est intacte.

Le client MCP ne se connecte pas ou est refusé

Gardez Unreal Editor ouvert et utilisez Editor Preferences > Plugins > Locus > MCP Integration pour confirmer que Activer MCP est activé et que le statut est en cours d’exécution. Si le point de terminaison local ou la configuration client n’est pas disponible, copiez une configuration récente après avoir changé le port local ou régénéré l’identifiant.

Choisissez le Format client approprié avant de copier. Exécutez les commandes d’enregistrement de Claude Code et Gemini CLI dans un terminal normal et non dans leurs invites interactives. Gemini utilise le scope utilisateur ; une ancienne entrée globale locus peut encore pointer vers le point de terminaison d’un autre projet. Remplacez-la par une configuration récente du projet actuellement ouvert. Ne collez jamais la commande ou l’identifiant copié dans une demande d’assistance.

Un seul client peut posséder la session Locus active. Fermez ou déconnectez le client précédent, attendez brièvement et réessayez ; utilisez Réinitialiser le client actif uniquement lorsque ce client n’est plus utilisé. Une mutation nécessite Autoriser les modifications, et les Notes ou Repères privés nécessitent séparément Autoriser les Notes et Repères Privés. Le travail MCP sur les Repères se limite à la base prise en charge d’un monde /Game/... enregistré et appartenant au projet.

Voir Intégration MCP pour les conseils complets de connexion, d’autorisation, d’outils pris en charge et de contexte de Repère.

La documentation ou les retours ne s’ouvrent pas

Les liens externes utilisent le navigateur par défaut du système d’exploitation. Vérifiez qu’un navigateur HTTP/HTTPS par défaut est configuré et que le système autorise le lancement d’URL. Un échec ne modifie pas les données du projet. MCP Integration comprend un bouton Documentation, et Locus fournit également Donner un retour.