Sorun Giderme

Aşağıdaki belirtilerden başlayın. Depolamada elle değişiklik yapmadan önce proje dosyalarını koruyun.

Locus eksik veya yüklenmiyor

Eklentinin <Project>/Plugins/Locus/ konumunda olduğunu ve Düzenle > Eklentiler bölümünde etkinleştirildiğini doğrulayın.
Paketin projenin tam Unreal Engine alt sürümüyle eşleştiğini doğrulayın.
Eklentiyi etkinleştirdikten veya değiştirdikten sonra Unreal Editor’ı yeniden başlatın.
Pencere > Locus yolunu veya Ctrl+Shift+L kısayolunu deneyin.
LogLocus kategorisi ve eklenti yükleme hatası için Unreal Çıktı Günlüğünü inceleyin.

İkili paket başka bir Engine alt sürümünü hedefliyorsa doğru paketle değiştirin; paketler arasında tek tek ikili dosya kopyalamayın.

İçerik salt okunur

Kaynak Denetimi sayfasını açın ve dosyanın denetlenip denetlenmediğini, başka bir kullanıcı veya istemci tarafından kullanıma alınıp alınmadığını, güncel olup olmadığını ya da sağlayıcının bağlantısı kesildiği için kullanılamayıp kullanılamadığını kontrol edin. Denetlenen temiz dosya da açıkça kullanıma alınana kadar salt okunur kalır.

Dosya başka bir istemciye aitse, çalışma alanınız depodaki revizyonun gerisindeyse veya sağlayıcı güvenli bir durum bildiremiyorsa Kullanıma Al kullanılamayabilir. Projenin normal kaynak denetimi iş akışıyla sahiplik veya revizyon durumunu çözün. Sağlayıcıya yeniden bağlandıktan sonra Unreal Kaynak Denetimini veya Locus’u yenileyin; denetlenen içerik kullanıma alma başarılı olana kadar salt okunur kalır. Dosya sistemi izinlerini değiştirerek korumayı atlamayın.

Özel Notlar ve Pinler sağlayıcıya bağlı olmamalıdır. Kullanılamıyorlarsa projenin Saved/Locus depolamasının var ve yazılabilir olduğunu doğrulayın.

Unreal’da yapılandırılmış sağlayıcı yoksa kaynak denetimine özgü durum, ipucu, yönlendirme, Kullanıma Al veya Ekleme İçin İşaretle arayüzünün görünmemesi normal Yerel Mod davranışıdır. Yapılandırılmış ancak kullanılamayan sağlayıcı farklıdır ve bilinen denetimli içeriği korur.

Kullanıma Al veya Ekleme İçin İşaretle başarısız oldu

Unreal Kaynak Denetimi sağlayıcısının yapılandırılmış, bağlı ve dosyayı raporlayabilir olduğunu doğrulayın. Yeni Paylaşılan Notun oluşturma sonrası Ekleme İçin İşaretle isteği başarısız olursa yerel dosya kalır. Yeni Paylaşılan Pinler ve Belgeler siz açıkça ekleyene kadar İzlenmeyen kalır; Paylaşılan Pin Anlık Görüntüleri ayrı kaynak denetimi durumuna sahiptir.

Belge yeniden adlandırılmıyor veya taşınmıyor

Yeniden adlandırma ve taşıma işlemlerini Locus Belgeler çalışma alanından yapın; Content Browser öğesi yalnızca bir yansıtmadır ve doğrudan yeniden adlandırmayı desteklemez. İzlenmiyor durumundaki uygun bir Belge Yeniden Adlandır veya F2 ile yeniden adlandırılabilir; Taşı ya da geçerli, mevcut bir klasöre sürükleyip bırakmayla taşınabilir. Locus, sağlayıcıdan bağımsız kaynak denetimi taşımasını güvenle gerçekleştiremediği için Ekleme İçin İşaretlenmiş ve denetlenen Belgelerde Yeniden Adlandır ile Taşı’yı bilerek engeller. Kaynak denetimini devre dışı bırakarak veya dosya sistemi izinlerini değiştirerek bunu aşmayın; bunun yerine Belgeyi Ekleme İçin İşaretlemeden önce düzenleyin.

Notlar, Pinler veya Belgeler yenilenmiyor

Etkin çalışma alanının yeniden oluşturma veya yenileme eylemini kullanın. Harici düzenleyicide değiştirilen Belgelerde ProjectDocuments altında geçerli bir UTF-8 .md dosyası kaydedin. Pinlerde geçerli dünyanın kaydedilmiş olduğunu ve Pinin çözümlenmiş haritasıyla ilişkilendirildiğini doğrulayın.

Kurtarma verisi var

İşlem yapmadan önce diskteki asıl öğeyi ve kurtarma kopyasını inceleyin. Geri Yükle, diskteki öğeyi kurtarılan çalışmayla değiştirir; Yeni Olarak Geri Yükle ikisini de korur; At ise kurtarma kopyasını kaldırır. Emin değilseniz yeni olarak geri yüklemeyi tercih edin.

Harici çakışma

Harici çakışma, Locus kaydedilmemiş düzenlemeler tutarken disk dosyasının değiştiği anlamına gelir. Zorla üzerine yazmayın. Diski yeniden yüklemek, yerel çalışmayı yeni öğe olarak kaydetmek, yerel metni kopyalamak veya uygun olduğunda sürümleri karşılaştırmak için sunulan eylemleri kullanın.

Hatalı biçimlendirilmiş veya desteklenmeyen veriler

Özgün dosyayı koruyun ve LogLocus mesajını inceleyin. Doğrulanmış bir yedeğiniz ve biçim hakkında bilginiz yoksa tanımlayıcıları veya sahiplik alanlarını elle düzenlemeyin. Geçersiz UTF-8 Markdown dosyası içe aktarma sırasında reddedilir. Okuma Modu tam olarak sunamasa bile desteklenmeyen Markdown kaynakta bozulmadan kalmalıdır.

Bir referans eksik veya güncel değil

İlgili çalışma alanını yenileyin ve Varlık, Pin, Not, Belge veya Actor hedefinin hâlâ var olduğunu doğrulayın. Taşınan ya da silinen hedef okunabilir fakat çözümlenmemiş kalabilir; Locus bilinçli onarım için bunu görünür tutar.

Actor referansı yalnızca World Outliner’dan tam olarak bir uygun yüklü Actor’ın düzenlenebilir Not veya Belgeye sürüklenmesiyle yazılabilir. Referans ekle ya da @ seçicisinde görünmez; Level Instance ve desteklenmeyen geçici/önizleme world’leri desteklenmez.

Pinler kullanılamıyor

Kalıcı Pinler kayıtlı, üst düzey bir Editor dünyası gerektirir. Haritayı kaydedin, Geçerli Haritaya dönün ve yerleştirmeyi yeniden deneyin. Pin dosyaları yalnızca Tüm Haritalar görünümünde gezinmek için haritaları yüklemez veya değiştirmez.

Anlık Görüntü yakalama ve güncelleme ayrıca kullanılabilir perspektif Level Editor viewport’u gerektirir ve PIE sırasında kullanılamaz.

Belgeler eksik

.md dosyasının <Project>/ProjectDocuments/ altında ve geçerli UTF-8 biçiminde olduğunu doğrulayın. Ayrılmış Content/ alt ağacının dışındaki yol Locus Belgeleri altında görünür ve Unreal’ın Content Browser’ına yansıtılmaz. ProjectDocuments/Content/ altındaki yol seyrek Content Browser kökünde görünür ve eşleşen /Game bağlamına yansıtılır. Harici değişikliklerden sonra Belgeleri yenileyin. Ağaç Asset Registry klasörlerinden değil, dizinlenmiş Belgelerden türetildiği için ilgisiz /Game klasörleri bilerek gösterilmez. Belgelerin UAsset değil, harici yansıtılmış öğeler olduğunu unutmayın.

Markdown beklendiği gibi işlenmiyor

Desteklenen yapılar için Belgeler sayfasını kontrol edin. Ham HTML ve güvenli olmayan URL’ler etkisiz kalır, uzak içerik getirilmez ve tarayıcıyla eşdeğer Markdown işleme taahhüt edilmez. Asıl kaynak metnin bozulmadığını doğrulamak için Düzenleme Moduna geçin.

MCP istemcisi bağlanmıyor veya reddediliyor

Unreal Editor’ı açık tutun ve Editor Tercihleri > Eklentiler > Locus > MCP Entegrasyonu yolunda MCP’yi Etkinleştir seçeneğinin açık, durumun çalışıyor olduğunu doğrulayın. Yerel uç nokta veya istemci yapılandırması kullanılamıyorsa yerel portu değiştirdikten ya da kimlik bilgisini yeniden oluşturduktan sonra yeni bir yapılandırma kopyalayın.

Kopyalamadan önce eşleşen İstemci Biçimini seçin. Claude Code ve Gemini CLI kayıt komutlarını etkileşimli istemlerinin içinde değil, normal bir terminalde çalıştırın. Gemini kullanıcı kapsamını kullanır; bu nedenle eski bir genel locus girdisi hâlâ başka bir projenin uç noktasını gösterebilir. Geçerli açık projeden yeni bir yapılandırma kullanarak değiştirin. Kopyalanan komutu veya kimlik bilgisini hiçbir zaman destek isteğine yapıştırmayın.

Etkin Locus oturumuna aynı anda yalnızca bir istemci sahip olabilir. Önceki istemciyi kapatın veya bağlantısını kesin, kısa süre bekleyip yeniden deneyin; Etkin İstemciyi Sıfırla seçeneğini yalnızca o istemci artık kullanımda değilse kullanın. Değişiklik için Değişikliklere İzin Ver, Özel Notlar veya Pinler için ayrıca Özel Notlara ve Pinlere İzin Ver gerekir. MCP Pin çalışmaları, projeye ait kayıtlı ve desteklenen /Game/... dünya temeliyle sınırlıdır.

Bağlantı, izin, desteklenen araçlar ve Pin bağlamı rehberinin tamamı için MCP Entegrasyonu sayfasına bakın.

Dokümantasyon veya geri bildirim açılmıyor

Harici bağlantılar işletim sisteminin varsayılan tarayıcısını kullanır. Varsayılan bir HTTP/HTTPS tarayıcısının yapılandırıldığını ve işletim sisteminin URL başlatmaya izin verdiğini kontrol edin. Hata proje verilerini değiştirmez. MCP Entegrasyonu bir Dokümantasyon düğmesi içerir; Locus ayrıca Geri Bildirim Ver eylemini sunar.