GMod'da eksik texture'ları ve ERROR modellerini düzeltme

Pembe-siyah dama deseni, motorun bir materyali ya da ona ait texture'ı bulamadığı anlamına gelir. Büyük kırmızı ERROR yazısı ise eksik bir modeli gösterir. Çoğunlukla içerik yalnızca mapper'ın bilgisayarında vardır: BSP'ye paketlenmemiştir, Team Fortress 2 gibi mount edilmemiş bir oyundan geliyordur ya da yanlış bir yolda aranıyordur. Mapper'lar bunu içeriği paketleyip yolları kontrol ederek, oyuncular ve sunucular ise içeriği mount ederek ya da indirerek çözer.

Belirtiler ne anlama geliyor

Son durumun kendi yazısı var: cubemap yansımalarını düzeltme.

En sık görülen nedenler

1. İçerik paketlenmemiş: Özel materyaller, modeller ve sesler yerel oyun klasöründe durur. Hammer ve senin oyunun onları orada bulur, başka hiç kimse bulamaz.
2. Başka bir oyundan gelen içerik: Pek çok harita başka Source oyunlarından asset kullanır. GMod, Temmuz 2025 güncellemesinden beri Counter-Strike: Source ve Half-Life 2 episode'larının texture, model ve seslerinin çoğunu kendisi sunar, ancak bu oyunların haritalarını, müziklerini ve seslendirmelerini sunmaz. Team Fortress 2 ya da Portal gibi başka oyunlarda ise oyunu kurup GMod'da mount etmemiş herkes dama deseni ve ERROR görür.
3. Yanlış yol: Bir VMT'de $basetexture, materials klasörüne göre ve dosya uzantısı olmadan yazılır. Bir model, materyallerini model derlenirken belirlenmiş klasörlerde arar. Dosyaları sonradan başka bir klasöre taşırsan bu referanslar boşa çıkar.
4. Eksik dosyalar: Karşılığı olan VTF'si bulunmayan bir VMT de dama desenine yol açar. Bir model birden fazla dosyadan oluşur; .mdl dosyasının yanında .vvd, .vtx ve çoğu zaman .phy de bunlar arasındadır. Biri eksikse model çalışmaz.
5. Büyük ve küçük harf: Linux sunucuları büyük ve küçük harfleri ayırt eder. Dosya ve klasör adlarını baştan sona küçük harfle yaz.

Mapper'lar için çözüm

Her şeyin Hammer'da doğru görünmesi hiçbir şeyi kanıtlamaz. Editör, içeriği yerel klasörlerinden ve mount ettiğin tüm oyunlardan yükler.

1. Haritanın kullandığı özel materyallerin, modellerin ve seslerin bir dökümünü çıkar.
2. Bu dosyaları BSP'ye paketle. Paketleme araçları bağımlılıkların çoğunu kendiliğinden bulur. Yine de modellerin materyallerinin ve normal map gibi ek texture'ların dahil olup olmadığını kontrol et. Ayrıntılar özel içeriği BSP içine paketleme yazısında.
3. Pakfile'daki yolları kontrol et. Her dosya orada, oyun klasöründekiyle aynı biçimde, materials/, models/ ya da sound/ ile başlayarak kayıtlı olmalıdır. Aralık 2023'ten beri GMod gömülü dosyaları ayrıca bir whitelist'e göre kontrol eder ve kontrolden geçemeyen dosyayı yüklemez. Konsolda o zaman BSP embedded file failed whitelist check görünür. Map Scanner, pakfile'a gömülü Lua ve asset dosyalarını listeler.
4. Bir yabancı gibi test et. BSP'yi, ne addon'larını ne de paketlenmemiş dosyalarını içeren bir GMod kurulumunda aç ya da projen bilgisayarında bulunmayan birine test ettir.
5. Gerekli oyunları açıklamada açıkça belirt. Üçüncü taraf içeriği haritana paketleyip paketleyemeyeceğin teknik değil, lisansla ilgili bir sorudur.

Bu test, yayın öncesi BSP kontrolünün değişmez bir parçasıdır. Eksik içerik, oyuncuların ve alıcıların ilk fark ettiği hatalar arasındadır.

Oyuncular için çözüm

• Oyunu mount et: Gerekli oyuna sahipsen Steam üzerinden kur. Ardından GMod ana menüsünün sağ altındaki oyun kumandası simgesini aç, oyunu işaretle; içerik hâlâ görünmüyorsa GMod'u yeniden başlat.
• Workshop bağımlılıklarına abone ol: Birçok Workshop haritası, gerekli içerikleri kendi sayfasında listeler. Onlara da abone ol.
• Sunucu içeriğini edin: Sorun yalnızca belirli bir sunucuda ortaya çıkıyorsa, o sunucunun içeriği sende eksiktir. Birçok sunucu bir Workshop koleksiyonuna bağlantı verir.

Resmî olmayan kaynaklardan gelen içerik paketleri hem hukuki açıdan hem de güvenlik açısından sakıncalıdır. Temiz yol, mount edilmiş orijinal oyundur.

Sunucu sahipleri için çözüm

Bir sunucuda birbirinden ayrı iki iş vardır.

İçeriğe sunucunun kendisi de ihtiyaç duyar. Bir model sunucuda yoksa o modelin çarpışma (collision) verisi de yoktur. Dedicated sunucuda başka oyunların içeriğini garrysmod/cfg/mount.cfg dosyası üzerinden mount edersin.

İçeriğe oyuncular da ihtiyaç duyar. İçeriği onlara ulaştırmanın üç yolu vardır:

• BSP'ye paketlenmiş içerik, GMod'un gömülü dosyalar için kullandığı whitelist'ten geçtiği sürece haritayla birlikte otomatik olarak gelir.
• Workshop içeriği sunucuya bir koleksiyon üzerinden yüklenir ve oyunculara resource.AddWorkshop ile dağıtılır.
• Paketlenmemiş dosyalar sv_downloadurl kullanılarak FastDL üzerinden dağıtılır.

Bunun nasıl kurulacağı FastDL ve Workshop ile GMod sunucusuna harita kurma yazısında anlatılıyor. Haritan mount edilmiş bir oyun gerektiriyorsa bunu sunucu bilgisinde açıkça belirt.

Sık sorulan sorular

Neden yalnızca bazı sunucularda pembe texture görüyorum?

Çünkü her sunucu kendi içeriğini kullanır. Ya o sunucunun dosyaları sende eksiktir ya da haritası senin mount etmediğin bir oyunu kullanıyordur. Yalnızca standart içerik kullanan sunucularda bu sorun ortaya çıkmaz.

GMod için Counter-Strike: Source gerekli mi?

Çoğu durumda artık değil. GMod, Temmuz 2025 güncellemesinden beri Counter-Strike: Source'un texture, model ve seslerinin çoğunu kendisi sunar. Oyunun orijinal haritaları ve onun müziğini ya da seslendirmelerini kullanan haritalar için ise oyunun hâlâ kurulu ve mount edilmiş olması gerekir.

Neden her şey Hammer'da doğru görünüyor da oyunda görünmüyor?

Hammer ve kendi oyunun dosyaları yerel klasörlerinde bulur. Diğer oyuncularda bu klasörler yoktur. BSP'nin içinde gerçekte ne olduğunu ancak yerel içeriğin olmadan yapılan bir test gösterir.

Dama deseni ile ERROR modeli arasındaki fark nedir?

Dama deseni eksik bir materyalin ya da texture'ın yerini tutar. Kırmızı ERROR ise eksik bir modelin yerini tutar. Bir model görünüyor ama pembe-siyahsa, model dosyası bulunmuş, yalnızca materyalleri eksiktir.