Solución de problemas

Empieza por el síntoma que aparece abajo. Conserva los archivos del proyecto antes de cambiar manualmente el almacenamiento.

Locus falta o no carga

1. Confirma que el plugin está en <Project>/Plugins/Locus/ y habilitado en Edit > Plugins.
2. Confirma que el paquete coincide con la versión menor exacta de Unreal Engine del proyecto.
3. Reinicia Unreal Editor después de habilitar o reemplazar el plugin.
4. Prueba Window > Locus o Ctrl+Shift+L.
5. Revisa el Unreal Output Log para la categoría LogLocus y el error de carga del plugin.

Si un paquete binario apunta a otra versión menor de Engine, reemplázalo por el paquete correcto; no copies binarios individuales entre paquetes.

El contenido es de solo lectura

Abre Control de código fuente y comprueba si el archivo está controlado, reservado por otro usuario o cliente, desactualizado o no disponible porque el proveedor está desconectado. Un archivo controlado limpio también permanece en solo lectura hasta que lo reserves explícitamente.

Reservar puede no estar disponible cuando otro cliente posee el archivo, el espacio de trabajo está detrás del depósito o el proveedor no puede informar de un estado seguro. Resuelve la propiedad o revisión mediante el flujo normal del proyecto. Tras reconectar un proveedor, actualiza Unreal Source Control o Locus; el contenido controlado sigue siendo de solo lectura hasta que la reserva tenga éxito. No eludas la protección cambiando permisos del sistema de archivos.

Las Notas y Pines privados no deberían depender de un proveedor. Si no están disponibles, verifica que el almacenamiento Saved/Locus del proyecto existe y permite escritura.

Sin ningún proveedor configurado, la ausencia de estado de control de fuente, información sobre herramientas, guía, interfaz de usuario Reservar o Marcar para añadir es el modo local normal. Un proveedor configurado pero no disponible es diferente y mantiene protegido el contenido controlado conocido.

Reservar o Marcar para añadir ha fallado

Confirme que el proveedor de Unreal esté configurado, conectado y pueda reportar el archivo. Una solicitud fallida de Marcar para añadir posterior a la creación deja un nuevo Nota compartido en el disco. Los nuevos Pin y Documento compartidos seguirán siendo Untracked hasta que se agreguen explícitamente; Las instantáneas Pin compartidas tienen un estado de control de fuente independiente.

Un Documento no cambia de nombre o no se puede mover

Usa el espacio de trabajo Documentos de Locus para cambiar nombre y mover; el elemento de Content Browser es una proyección y no la superficie autoritativa. Un Documento Sin seguimiento apto puede cambiar de nombre con Cambiar nombre o F2, y moverse con Mover o arrastrándolo a una carpeta existente válida. Locus bloquea intencionadamente Cambiar nombre y Mover para Documentos marcados para añadir o controlados porque no puede realizar de forma segura un movimiento de control de código fuente neutral para el proveedor. No lo eludas deshabilitando el control de código fuente ni cambiando permisos; organiza el Documento antes de marcarlo para añadir.

Las Notas, Pines o Documentos no se actualizan

Usa la acción de reconstrucción o actualización del espacio de trabajo activo. Para Documentos editados en un editor externo, guarda un archivo .md UTF-8 válido bajo ProjectDocuments. Para Pines, confirma que el mundo actual está guardado y que el Pin está asociado a su mapa resuelto.

Hay una recuperación disponible

Revisa el archivo de referencia del disco y la copia de recuperación antes de actuar. Restaurar reemplaza el archivo de referencia por el trabajo recuperado, Restaurar como nuevo conserva ambos y Descartar elimina la copia. Si no estás seguro, prefiere restaurar como nuevo.

No limpies Saved como atajo de solución

El árbol Saved del proyecto puede contener Notas privadas, Pines privados e instantáneas de recuperación. Eliminarlo puede destruir permanentemente contenido del usuario.

Conflicto externo

Un conflicto externo significa que el archivo del disco cambió mientras Locus tenía ediciones sin guardar. No fuerces la sobrescritura. Usa las acciones ofrecidas para volver a cargar el disco, guardar el trabajo local como un elemento nuevo, copiar el texto local o comparar versiones cuando esté disponible.

Datos mal formados o no compatibles

Conserva el archivo original y revisa el mensaje de LogLocus. No edites manualmente identificadores o campos de propiedad salvo que tengas una copia de seguridad verificada y entiendas el formato. Un archivo Markdown UTF-8 no válido se rechaza al importar. El Markdown no compatible debe permanecer intacto como origen aunque el Modo de lectura no pueda presentarlo completamente.

Falta una referencia o está obsoleta

Actualice el espacio de trabajo relevante y verifique que el Activo, Pin, Nota, Documento o Actor aún exista. Un objetivo movido o eliminado puede permanecer legible pero sin resolver, por lo que puedes repararlo deliberadamente.

Cree una referencia de Actor solo arrastrando exactamente un Actor cargado elegible desde el World Outliner a un Nota o Documento editable. Está ausente en Insertar Referencia y @; No se admiten instancias de nivel ni mundos transitorios o de vista previa no compatibles.

Los Pines no están disponibles

Los Pines persistentes requieren un mundo del Editor de nivel superior guardado. Guarda el mapa, vuelve a Mapa actual y reintenta la colocación. Los archivos de Pines no cargan ni modifican mapas solo por explorar Todos los mapas.

La captura y actualización de instantáneas también requieren una ventana gráfica de perspectiva Level Editor disponible y no están disponibles durante PIE.

Faltan Documentos

Confirma que el archivo .md está bajo <Project>/ProjectDocuments/ y usa UTF-8 válido. Una ruta fuera del subárbol reservado Content/ aparece bajo Documentos de Locus y no se proyecta en el Content Browser de Unreal. Una ruta bajo ProjectDocuments/Content/ aparece bajo la raíz dispersa Explorador de contenido y se proyecta en el contexto /Game correspondiente. Actualiza Documentos después de cambios externos. Las carpetas /Game no relacionadas faltan intencionadamente porque el árbol deriva de Documentos indexados, no de carpetas del Asset Registry. Recuerda que los Documentos son elementos externos proyectados, no UAssets.

Markdown no se muestra como esperaba

Consulta Documentos para conocer las construcciones compatibles. El HTML sin procesar y las URL no seguras permanecen inertes, no se recupera contenido remoto y no se promete una representación Markdown equivalente a la del navegador. Cambia al Modo de edición para confirmar que el origen autoritativo está intacto.

El cliente MCP no conecta o es rechazado

Mantén Unreal Editor abierto y usa Editor Preferences > Plugins > Locus > MCP Integration para confirmar que Activar MCP está activado y el estado está en ejecución. Si el endpoint local o la configuración del cliente no están disponibles, copia una configuración nueva después de cambiar el puerto local o regenerar la credencial.

Elige el Formato de cliente correcto antes de copiar. Ejecuta los comandos de registro de Claude Code y Gemini CLI en una terminal normal, no dentro de sus indicaciones interactivas. Gemini usa el ámbito de usuario, por lo que una entrada global locus antigua podría seguir apuntando al endpoint de otro proyecto; reemplázala con una configuración nueva del proyecto abierto. Nunca pegues el comando o la credencial copiada en una solicitud de soporte.

Solo un cliente puede poseer la sesión activa de Locus. Cierra o desconecta el cliente anterior, espera un momento y vuelve a intentarlo; usa Restablecer cliente activo solo cuando ese cliente ya no esté en uso. Una mutación requiere Permitir cambios, y las Notas o Pines privados requieren Permitir notas y pines privados por separado. El trabajo de Pines mediante MCP se limita a la base compatible de un mundo /Game/... guardado y propiedad del proyecto.

Consulta Integración de MCP para conocer la conexión completa, permisos, herramientas compatibles y contexto de Pines.

No se abre la documentación o los comentarios

Los enlaces externos usan el navegador predeterminado del sistema operativo. Comprueba que hay un navegador HTTP/HTTPS predeterminado y que el sistema permite abrir URL. El fallo no cambia los datos del proyecto. Integración de MCP incluye un botón Documentación, y Locus también ofrece Enviar comentarios.