Compile log nasıl okunur: Hammer'da VBSP, VVIS ve VRAD

Bir compile log'u yukarıdan aşağıya okur ve hata bildiren ilk mesajı ararsın. Log'un VBSP, VVIS ve VRAD için birer tane olmak üzere üç bölümü vardır ve sonraki mesajların çoğu yalnızca ilk sorunun sonucudur. Üç bölümü birbirinden ayırt edebildiğinde ve bir avuç tipik mesajı tanıdığında, nedeni çoğunlukla birkaç dakika içinde bulursun.

Log nerede durur ve nasıl yapılandırılmıştır

Hammer, log'u derleme sürerken derleme penceresinde gösterir; derleme araçları da onu ayrıca VMF dosyanla aynı klasöre <mapname>.log adıyla yazar. GMod'un araçları bu dosyayı yenisiyle değiştirmez, sonuna ekler; yani en yeni derleme dosyanın sonundadır. Dosyada okumaya son derlemenin başladığı yerden başla.

Oyunla gelen Hammer'ın derleme penceresinde üç aracın her biri aşağıdaki blokla başlar; Hammer++ bunun yerine Running command: ile başlayan bir satır yazar. .log dosyasında bu başlık yoktur; orada bölümleri tablodaki tipik satırlardan ayırt edersin:

** Executing...
** Command: "...\bin\vbsp.exe"
** Parameters: -game "...\garrysmod" "...\rp_example"

Üç aracın ayrıntılı olarak ne yaptığı VBSP, VVIS ve VRAD nedir? yazısında anlatılıyor. Log'u okumak için tek bir kural yeter: her araç bir öncekinin çıktısıyla çalışır. VBSP başarısız olursa VVIS ve VRAD'ın elinde üzerinde çalışabileceği işe yarar bir şey kalmaz.

Hata mı, uyarı mı, zararsız mı

Göze çarpan her satır bir sorun değildir. Üç seviye vardır.

• Hata: Araç durur ya da işe yarar bir çıktı yazmaz. VBSP durursa yeni bir BSP oluşmaz. O zaman Hammer çoğu kez son kopyalama adımında The command failed der ya da oyun eski dosyayla açılır ve yaptığın değişiklikler ortada yoktur.
• Uyarı: Araç çalışmaya devam eder ama sonuç bir noktada kusurludur. VRAD'ın verdiği WARNING: Too many light styles on a face buna bir örnektir. Harita çalışır ama bildirilen konumda ışıklandırma yanlıştır.
• Zararsız: Source derleme araçlarının log'larından bilinen Memory leak: mempool blocks left in memory gibi bir satırın haritandaki bir leak ile hiçbir ilgisi yoktur. Aracın kendisiyle ilgilidir ve görmezden gelinebilir.

En önemli mesajlar ve anlamları

En sık görülen durumların kendi rehberleri var: harita leak hatasını düzeltme ve Source Engine harita limitleri.

VRAD'ın sonundaki tablo

VRAD en sonda, BSP'nin brush'lar, plane'ler ya da entity'ler gibi tek tek veri alanlarının ne kadar dolu olduğunu gösteren bir özet yazdırır. Bir satır VERY FULL! ile işaretlenmişse bir limite yaklaşmışsın demektir. Büyük haritalarda darboğazları erkenden görmek için bu tabloya her tam derlemeden sonra bak.

Nasıl ilerlemeli: önce ilk hata

1. Üç aracın da çalıştığını kontrol et. Derleme penceresinde vbsp.exe, vvis.exe ve vrad.exe ifadelerini, .log dosyasında ise yukarıdaki tablodaki tipik satırları ara.
2. Yukarıdan başlayarak leaked, Error, WARNING, failed ve not found ifadelerini ara.
3. Yalnızca ilk gerçek hatayı düzelt. Ondan sonraki her şey onun sonucu olabilir.
4. Yeniden derle ve log'u bir kez daha baştan oku. Kalan mesajlar ancak ilk hata ortadan kalktığında bir anlam taşır.
5. Ardından uyarıları sırayla ele al. Birçok mesaj koordinat ya da bir brush numarası verir. Hammer'da View menüsü, doğrudan koordinatlara ya da bir brush numarasına atlamanı sağlar.
6. Son olarak limitleri gözden kaçırmamak için VRAD tablosuna bir göz at.

Log'u değerlendirmeyi bir araca bırak

Mesajları henüz tanımıyorsan uzun log'lar yorucudur. Map Scanner bunun için bir compile log moduna sahiptir: bir Hammer, VBSP, VVIS ya da VRAD log'unu yapıştırırsın veya .txt ya da .log olarak yüklersin. Sonuç; olası temel nedenler, diğer hatalar, zincirleme hatalar ve uyarılar olarak sıralanır, her birinin yanında nedeni ve düzeltme adımları yer alır. Scanner'ın henüz tanımadığı mesajlar bildirilebilir. Scanner beta olarak işaretlenmiştir ve ücretsizdir.

Tek bir mesaja bakmak istersen hata veritabanını kullan. İçinde Hammer'dan ve derleme araçlarından gelen, incelenmiş hata mesajları nedenleri ve çözümleriyle birlikte yer alır.

Sık sorulan sorular

Pencere kapandıktan sonra compile log'u nerede bulurum?

Derleme araçları log'u VMF dosyanın yanına <mapname>.log olarak yazar. Dosyayı herhangi bir metin düzenleyiciyle açabilirsin. GMod'un araçları her yeni derlemeyi dosyanın sonuna ekler.

Her uyarıyı düzeltmem gerekir mi?

Hayır. Uyarılar derlemeyi durdurmaz ve bazılarının görünür bir etkisi yoktur. Oynanabilir alanlardaki koordinatları veren uyarıları ise düzeltmelisin, çünkü oralarda ışıklandırma ya da görünürlük çoğunlukla gözle görülür biçimde yanlıştır.

Derleme bittiği halde değişikliklerim oyunda neden yok?

Büyük ihtimalle VBSP durdu ve yeni bir BSP yazılmadı. Oyun da bu durumda eski dosyayı yükler. VBSP bölümündeki ilk hata mesajını ara.

"Memory leak: mempool blocks left in memory" ne anlama geliyor?

Bu satır Source derleme araçlarından gelir ve aracın kapanırken serbest bırakmadığı belleği anlatır. Haritadaki bir leak ile hiçbir ilgisi yoktur ve bir şey yapmana gerek yok. GMod'un güncel araçlarıyla yaptığımız test derlemelerinde bu satır hiç çıkmadı.