Son kontrol: 27 Eylül 2026. Dedicated Server, Garry's Mod Workshop addon'larını bir Workshop koleksiyonu üzerinden yükler. Garry's Mod 2026.09.22 sürümünden itibaren alternatif olarak cfg/srcds_workshop_ids.txt dosyasındaki tekil ID'leri de kullanabilir. resource.AddWorkshop() gerekli dosyaları istemcilere dağıtır, ancak sunucuya kendisi herhangi bir addon kurmaz. Güncel Facepunch kılavuzu her iki sunucu yolunu da açıklar.
Gereksinimler
Garry's Mod sunucunun Workshop koleksiyonu ayarına erişimin ve herkese açık ya da listelenmemiş bir koleksiyonun olmalı. game-serverhosting panelinde bunun için WORKSHOP_ID değişkeni bulunur. Addon bağımlılıklarını kontrol et ve değişiklikleri küçük gruplar halinde test et. Güncel Facepunch kılavuzu bu akış için genel olarak bir Steam Web API Key istemez.
Workshop koleksiyonu oluşturma
- Steam Workshop sayfasına git
- Yeni bir koleksiyon oluştur
- İstediğin tüm addon'ları ekle
- Koleksiyon ID'sini kopyala
Koleksiyon ID'si, Steam koleksiyonunun URL'sinde yer alır. Yalnızca sayısal ID'yi kopyala, URL'nin tamamını değil. Koleksiyonun herkese açık veya listelenmemiş olduğundan emin ol; Facepunch'a göre sunucu özel koleksiyonları alamaz. Bir addon kaldırılırsa, özel yapılırsa ya da yazarı tarafından güncellenirse bu, sunucunun başlamasını veya istemci indirmelerini etkileyebilir. Bu yüzden büyük değişikliklerden sonra sunucu konsolunu mutlaka kontrol et.
Koleksiyonu sunucuya yükleme
game-serverhosting panelinde başlangıç değişkenleri altında Workshop-Collection (WORKSHOP_ID) alanına sayısal koleksiyon ID'sini gir ve sunucuyu yeniden başlat. Kendi yönettiğin sunucularda ilgili başlangıç parametresi şöyledir:
+host_workshop_collection <collection_id>
Sunucu konsolunda Workshop mesajlarını kontrol et. Hata olması durumunda önce ID'yi, görünürlüğü ve addon'lara erişilebilirliği kontrol et. Genel bir -authkey adımı güncel Facepunch akışının parçası değildir.
Koleksiyon yerine tekil Workshop ID'leri
Garry's Mod 2026.09.22 veya daha yeni sürümde, bir koleksiyona ek olarak ya da onun yerine cfg/srcds_workshop_ids.txt dosyasını oluşturabilirsin. Biçim Dedicated Server dokümantasyonunda yer alır. Bu yolu kullanmadan önce kurulu sunucu sürümünü kontrol et. Dosya tekil addon ID'lerini içerir, koleksiyon ID'sini değil. Belgelenen KeyValues biçimini kullan; JSON veya düz satır listesi kullanma:
"my_workshop_addons"
{
"1" { "wsid" "DEINE_ADDON_ID" }
}
DEINE_ADDON_ID yerine gerçek bir sayısal addon ID'si yaz; diğer girişler "2" gibi kendi anahtarlarını alır.
Oyuncuların gerekli içerikleri indirmesi
resource.AddWorkshop() indirmeyi istemciler için başlatır. Sunucuya addon kurmaz. Bunu hedefli olarak ek modeller, materyaller veya sesler için kullan:
-- garrysmod/lua/autorun/server/workshop.lua
resource.AddWorkshop("DEINE_ADDON_ID")
DEINE_ADDON_ID yerine istemci içeriği olan, erişilebilir bir addon'un sayısal Workshop ID'sini yaz. Saf Lua addon'ları bu girişe ihtiyaç duymaz. Geçerli harita ve Workshop destekli bir oyun modu, sunucu koleksiyonundan otomatik olarak istemciler için işaretlenir. resource.AddWorkshop için Facepunch dokümantasyonunu incele ve yerel addon aboneliği olmadan sunucuya katılmayı test et.
Popüler addon kategorileri
| Kategori | Örnekler |
|---|---|
| Haritalar | ttt_minecraft, ph_office |
| Silahlar | M9K Weapons, TFA Base |
| Oyuncu modelleri | PM + Playermodel Selector |
| Araçlar | Wiremod, Precision Tool |
| HUD'lar | DarkRP HUD, TTT HUD |
Bu kategoriler tipik örneklerdir, her kurulum için bir öneri değildir. DarkRP, TTT, Prop Hunt ve Sandbox sunucularının gereksinimleri farklıdır. Önemli olan, addon'ların oyun moduna uyması, aktif olarak bakımının yapılması ve yinelenen işlevler getirmemesidir. İki silah altyapısı, birden fazla HUD veya birden fazla yönetici aracı birbirini bozabilir.
Mod iş akışları olan başka oyunlar da işletiyorsan, Project Zomboid Workshop Kılavuzu ve ARK Mod Kurulum Kılavuzu içindeki ilkeler işine yarar: önce bağımlılıkları netleştir, sonra ID'leri düzgünce gir, ardından loglar ve istemci testiyle kontrol et.
Sonucu kontrol etme
Her büyük değişiklikten sonra sunucuyu yeniden başlat ve üç noktayı kontrol et. Birincisi: Konsol, koleksiyon veya tekil ID'ler için Workshop hatası göstermemeli. İkincisi: İstediğin addon'lar sunucu tarafında kullanılabilir olmalı; örneğin haritalar harita listesinde, araçlar uygun oyun modunda görünmeli. Üçüncüsü: Aboneliği olmayan bir test istemcisi gerekli içerikleri indirebilmeli. Ardından addon'un asıl işlevini ve bir sonraki harita değişimini de test et; dosyaların var olması Lua'nın hatasız çalıştığını kanıtlamaz.
Mümkünse addon'lara yerel olarak abone olmamış bir istemciyle test et. Aksi halde yeni oyuncular için otomatik indirmenin çalışmadığını kolayca gözden kaçırırsın. Herkese açık sunucularda, çok büyük içeriklerin indirilmesi gerekiyorsa sunucu açıklamasına kısa bir not eklemek de faydalıdır.
Sorun giderme
- Addon sunucu tarafında yüklenmiyor: Koleksiyon ID'sini, görünürlüğü, Workshop sayfasını ve başlangıç konsolunu kontrol et. Tekil ID dosyası için 2026.09.22 veya daha yeni bir sürüm gerekir.
- Oyuncular eksik dokular görüyor: Addon bağımlılıklarını ve istemci dağıtımını kontrol et. Temmuz 2025 güncellemesinden beri CS:S içeriklerinin çoğu dahildir; haritalar ve bazı diğer dosyalar hariçtir. Başkalarına ait retail içerik paketlerini Workshop'a yükleme: Facepunch Workshop kuralları bunu yasaklar.
- İndirme uzun sürüyor: Önce gerçekte hangi paketlerin istendiğini ölç. Kullanılmayan haritaları, yinelenen modelleri ve eski paketleri hem koleksiyondan hem de ek
resource.AddWorkshop()listesinden kaldır; geride kalan bir autorun girişi istemci indirmesini yine de tetikleyebilir.
FAQ
Her zaman bir Workshop koleksiyonuna ihtiyacım var mı?
Hayır. Birden fazla addon için koleksiyon kullanışlıdır. 2026.09.22 sürümünden itibaren sunucu, cfg/srcds_workshop_ids.txt dosyasındaki tekil ID'leri de yükleyebilir. resource.AddWorkshop() yalnızca istemci indirmesini yönetir.
Koleksiyon ID'si ile Workshop ID'si arasındaki fark nedir?
Koleksiyon ID'si bir koleksiyonu belirtir ve panel değişkeni WORKSHOP_ID ya da +host_workshop_collection için kullanılır. Tekil addon ID'leri 2026.09.22 sürümünden itibaren cfg/srcds_workshop_ids.txt içinde yer alabilir. resource.AddWorkshop() da tek bir addon ID'si kullanır, ancak yalnızca istemci dosyaları için.
Oyuncular neden eksik doku görüyor?
İlgili addon'u, bağımlılıkları ve istemci indirmesini kontrol et. Garry's Mod, CS:S varlıklarının çoğunu Temmuz 2025'ten beri kendisiyle birlikte getirir; haritalar ve bazı dosyalar hariçtir. Genel bir „CSS Content Pack“ güvenilir bir çözüm adımı değildir.
Her addon değişikliğinden sonra sunucuyu yeniden başlatmam gerekir mi?
Başlangıç parametreleri, Workshop koleksiyonu veya sunucu tarafı Lua dosyalarındaki değişiklikler için yeniden başlatmalısın. Sunucunun koleksiyonu doğru yükleyip yüklemediğini ve istemci kaynaklarını kaydedip kaydetmediğini ancak böyle güvenilir şekilde kontrol edebilirsin.
Bir koleksiyon ne kadar büyük olmalı?
Mümkün olduğunca küçük, gerektiği kadar büyük. Oyun modunun aktif olarak kullanmadığı addon'ları kaldır. Bu, hata aramayı kolaylaştırır, indirmeleri makul tutar ve canlı işletmede değişiklikleri daha iyi kontrol edilebilir kılar.