Garry’s Mod Server’a Workshop Koleksiyonu ile Addon Ekleme

GMod server workshop koleksiyonu ekleme işinin kısa cevabı: Steam Workshop’ta herkese açık ya da liste dışı bir koleksiyon oluşturur, adresindeki ?id= değerini koleksiyon kimliği olarak alır ve sunucunun başlatma satırına +host_workshop_collection KOLEKSIYON_ID eklersiniz. Sunucu her açılışta koleksiyondaki addon’ları indirir ve bağlar. Model, doku ya da ses içeren addon’ların oyunculara da inmesi için garrysmod/lua/autorun/server/ altındaki bir dosyaya her biri için resource.AddWorkshop("ADDON_ID") satırı yazarsınız.

Garry’s Mod sunucusuna addon yüklemenin bugünkü standart yolu Workshop koleksiyonudur; addon’ları elle klasöre kopyalamak artık yalnızca özel durumlar içindir. Aşağıdaki adımlar Garry’s Mod wiki’sine göre hazırlandı. Konsol çıktıları, Ekim 2026’da wiki’nin kendi örneğinde kullandığı koleksiyonla (Zombie Survival oyun modu ve haritaları) yaptığımız testten alındı. Sunucunuz henüz yoksa önce Garry’s Mod server kurulum rehberine bakın.

Başlamadan önce: Workshop addon’ları sunucuya nasıl ulaşır?

Bir addon’un oyunda görünmesi için iki ayrı indirme gerekir: sunucunun addon’u indirip bağlaması ve oyuncunun aynı addon’u kendi bilgisayarına indirmesi. Sunucu tarafını +host_workshop_collection, oyuncu tarafını resource.AddWorkshop yönetir. Garry’s Mod wiki’sine göre .lua dosyaları içerik sayılmaz ve oyunculara ayrı bir yolla kendiliğinden gönderilir; resource.AddWorkshop yalnızca model, doku, ses gibi içerik taşıyan addon’lar için gerekir.

Addon’larla uğraşmadan hazır bir sunucuda başlamak isterseniz Garry’s Mod server kiralama paketlerinde Workshop koleksiyonu ve FastDL ayarlarında ekip yardımcı olur.

Steam Workshop’ta koleksiyon oluşturma

Steam’de Garry’s Mod’un Workshop sayfasında Collections bölümünden yeni bir koleksiyon oluşturun ve sunucuda istediğiniz addon’ları, haritaları ve oyun modunu ekleyin. Wiki’ye göre iki noktaya dikkat edin:

• Koleksiyonun görünürlüğü Public (herkese açık) ya da Unlisted (liste dışı) olmalıdır; gizli (Private) bir koleksiyonu sunucu okuyamaz.
• Koleksiyonlar iç içe olabilir; sunucu alt koleksiyonları da indirir.

Koleksiyon kimliği, koleksiyon sayfasının adresindeki ?id= değeridir; örneğin steamcommunity.com/sharedfiles/filedetails/?id=157384458 adresinde kimlik 157384458‘dir. Bir addon’un kendi sayfasının adresi de aynı biçimdedir, bu yüzden koleksiyon kimliğiyle addon kimliğini karıştırmamaya dikkat edin; hatalar bölümünde bunun sonucunu gösteriyoruz.

GMod server workshop koleksiyonu ekleme: host_workshop_collection

Koleksiyonu sunucuya bağlamak için başlatma satırına +host_workshop_collection parametresini eklersiniz. Testimizde wiki’deki örnek koleksiyonu kullandık; koleksiyonda Zombie Survival oyun modu, altı harita ve artık erişilemeyen bir öğe var. Linux’ta:

cd ~/gmodds
./srcds_run -game garrysmod +maxplayers 16 \
  +host_workshop_collection 157384458 +gamemode zombiesurvival +map zs_hazard_v3

gmod@oyun-sunucu:~/gmodds$ ./srcds_run -game garrysmod +maxplayers 16 \
> +host_workshop_collection 157384458 +gamemode zombiesurvival +map zs_hazard_v3
...
WS: Fetching collection info...
Processing collection 157384458...
   Collection 'Zombie Survival Gamemode + Maps' (8 items)
...
Processing addon 7: Zombie Survival (105462463)...
   Addon needs downloading...
...
   Mounted!
...
Mounted 7 of 7 workshop addons!

Ne görmelisiniz: Collection '...' (8 items) satırı koleksiyonun okunduğunu, her addon için Mounted! satırı indirmenin bittiğini gösterir. Son satır 8 değil 7 addon diyor; çünkü koleksiyondaki bir öğe artık erişilemez durumda, bunu hatalar bölümünde anlatıyoruz. İndirilen dosyalar sunucunun garrysmod/cache/workshop klasörüne yazılır. Testimizde koleksiyon yaklaşık 180 MB tuttu ve ilk açılış bu indirme yüzünden uzadı; sonraki açılışlarda sunucu yalnızca güncellemeleri kontrol eder.

Aynı açılışta konsol Making workshop map available for client download satırını da yazdı. Wiki’ye göre sunucunun çalıştırdığı harita koleksiyondaysa oyunculara kendiliğinden indirilir; oyun modu da Workshop kimliği taşıyorsa aynı şekilde işaretlenir.

Windows’ta aynı parametreyi başlatma dosyanıza eklersiniz. Uzun satırları .bat dosyasında ^ işaretiyle bölebilirsiniz; aşağıdaki komut dosyanın içeriğini gösterir:

Set-Location C:\gmodds
Get-Content .\baslat.bat

PS C:\gmodds> Get-Content .\baslat.bat
@echo off
cd /d C:\gmodds
srcds_win64.exe -console -game garrysmod +maxplayers 16 ^
 +host_workshop_collection 157384458 ^
 +gamemode zombiesurvival +map zs_hazard_v3 ^
 +sv_setsteamaccount BURAYA_GSLT
PS C:\gmodds> 

Wiki ayrıca koleksiyon yerine ya da onunla birlikte, sunucunun indireceği addon kimliklerini cfg/srcds_workshop_ids.txt dosyasında listelemenin yolunu anlatıyor; wiki’ye göre bu yöntem 2026.09.22 ve sonraki sürümlerde çalışır. Dosya şu biçimdedir:

"my_workshop_addons"
{
	"1"	{ "wsid" "105462463" }
	"2"	{ "wsid" "110983920" }
}

Oyuncular addon’ları otomatik indirir mi? resource.AddWorkshop

Kendiliğinden değil. Sunucunun bir addon’u indirip bağlaması, oyuncunun onu indireceği anlamına gelmez. Oyuncular bir addon’un modellerini, dokularını ya da seslerini indirmezse haritada pembe siyah dokular ve ERROR modelleri görür. Çözüm, sunucu tarafında çalışan bir Lua dosyasına içerik addon’larının kimliklerini resource.AddWorkshop ile yazmaktır. Wiki’nin önerdiği yer garrysmod/lua/autorun/server/ klasörüdür:

cd ~/gmodds
nano garrysmod/lua/autorun/server/workshop.lua
cat garrysmod/lua/autorun/server/workshop.lua

gmod@oyun-sunucu:~/gmodds$ nano garrysmod/lua/autorun/server/workshop.lua
gmod@oyun-sunucu:~/gmodds$ cat garrysmod/lua/autorun/server/workshop.lua
-- Oyunculara Workshop'tan indirilecek addon'lar
resource.AddWorkshop("105462463") -- Zombie Survival oyun modu
resource.AddWorkshop("110983920") -- Zs Vault 106 haritasi
gmod@oyun-sunucu:~/gmodds$ 

Testimizde bu dosya hatasız yüklendi. resource.AddWorkshop sayfasındaki dört kural önemlidir:

• Fonksiyon addon’u sunucuya kurmaz; yalnızca oyuncuların indirmesini sağlar. Sunucu tarafı için koleksiyon gerekir.
• Kimlik tek bir addon’un kimliği olmalıdır; koleksiyon kimliği kabul edilmez.
• Yalnızca Lua içeren addon’ları eklemek boşunadır; Lua dosyaları zaten ayrı bir sistemle gönderilir.
• Workshop’tan gelen oyun modu ve o anki harita, koleksiyondaysa kendiliğinden eklenir. Bütün resource.Add* fonksiyonları için toplam 8192 indirilebilir dosya sınırı vardır.

Haritayı değiştirdiğinizde yeni harita da koleksiyondaysa o an kendiliğinden işaretlenir; bu yüzden harita addon’larını genellikle elle eklemeniz gerekmez. Oyunculara gösterdiğiniz her ek içerik, ilk bağlanma süresini uzatır; koleksiyonu gerçekten kullandığınız addon’larla sınırlı tutun.

Eski yöntem: addon’u klasöre elle kopyalamak

Addon’ları garrysmod/addons/ altına klasör olarak kopyalamak hâlâ çalışır ve şu durumlarda mantıklıdır: Workshop’ta olmayan, size özel yazılmış addon’lar; yalnızca sunucu tarafında çalışan Lua eklentileri; DarkRP’nin darkrpmodification eklentisi gibi düzenlemeniz gereken dosyalar. Testimizde sunucu açılışta bu tür bir klasörü Adding Filesystem Addon 'addons/darkrpmodification' satırıyla yükledi; DarkRP kurulumunu DarkRP sunucusu açma rehberinde anlatıyoruz.

Elle kopyalanan addon’un içerik dosyaları oyunculara kendiliğinden gitmez. Bunun için iki yol vardır: içeriği Workshop’a yükleyip resource.AddWorkshop kullanmak ya da FastDL kurmak. Wiki’ye göre FastDL’de oyuncular dosyaları sizin belirlediğiniz bir web sunucusundan indirir; server.cfg içinde sv_downloadurl ile web adresini verir, indirilecek dosyaları resource.AddFile ile işaretlersiniz. Oyuncular önce dosyanın .bz2 ile sıkıştırılmış hâlini ister, bulamazsa normal dosyayı indirir. Sunucunun kendi indirme yolu (sv_allowdownload) ise wiki’ye göre saniyede 64 KB ile sınırlıdır ve büyük içerik için uygun değildir.

Workshop güncellemelerini kontrol etmek

Sunucu her açılışta koleksiyondaki addon’ların güncel olup olmadığını kontrol eder ve yeni sürümleri indirir. Wiki, bir addon’un güncellemeyle zararlı ya da istenmeyen değişiklikler getirebileceği durumlar için otomatik güncellemeyi host_workshop_autoupdate 0 ile kapatmayı anlatır. Bedeli de belirtir: güncellenmeyen bir harita yüzünden oyuncular sunucuya giremeyebilir. Bu ayarı kapatırsanız güncellemeleri kendiniz takip etmeniz gerekir.

Sık karşılaşılan hatalar ve çözümleri

Failed to get addon info! Access denied (Item hidden/banned?)!

Koleksiyondaki bir öğe gizlendiyse, kaldırıldıysa ya da yasaklandıysa sunucu onu indiremez. Testimizdeki koleksiyonda tam olarak bu oldu; konsol şunları yazdı ve kalan yedi addon’u normal şekilde bağladı:

Processing addon 1: 117020215...
   Failed to get addon info! Access denied (Item hidden/banned?)!
WS: Finished!
Failed to cache addon location of 117020215

Öğeyi koleksiyondan çıkarın ya da aynı içeriğin erişilebilir bir sürümünü bulun. Bu hata diğer addon’ların yüklenmesini engellemez, ama o addon’a bağlı harita ya da oyun modu çalışmaz.

Item is not a collection!

Başlatma satırına koleksiyon yerine tek bir addon’un kimliğini yazarsanız sunucu hiçbir şey indirmez. Testimizde Windows’ta bir haritanın kimliğini koleksiyon diye verdik:

.\srcds_console_win64.exe -game garrysmod +maxplayers 16 `
  +host_workshop_collection 107254185 +gamemode sandbox +map gm_construct

PS C:\gmodds> .\srcds_console_win64.exe -game garrysmod +maxplayers 16 `
>>   +host_workshop_collection 107254185 +gamemode sandbox +map gm_construct
...
WS: Fetching collection info...
Processing collection 107254185...
   Item is not a collection!
   Collection 'zs_hazard_v3' (0 items)
   Reported 0 items, skipping
...
Mounted 0 of 0 workshop addons!

Koleksiyonun sayfasını açıp adresteki kimliği yeniden kopyalayın. Tek bir addon eklemek istiyorsanız onu koleksiyona ekleyin.

WS: No +host_workshop_collection or it is invalid!

Bu satır, sunucunun başlatma satırında geçerli bir koleksiyon bulamadığını söyler. Parametreyi hiç eklemediyseniz bu yalnızca bilgidir. Eklediğiniz halde görüyorsanız parametrenin yazımını, .bat dosyasında satırların ^ ile doğru bağlandığını ve koleksiyonun gizli olmadığını kontrol edin.

Koleksiyondan çıkardığım addon kayboldu

Sunucu her açılışta WS: Cleaning up unused files in /cache/workshop/.. satırıyla, artık koleksiyonda olmayan addon’ların dosyalarını temizler. Testimizde koleksiyonu değiştirdiğimizde önceki koleksiyonun indirilmiş dosyaları bir sonraki açılışta silindi. Bir addon’u geçici olarak çıkarıp geri eklerseniz yeniden indirilir.

GMod addon çalışmıyor: pembe siyah dokular ve ERROR modelleri

Sunucuda addon bağlı görünüyor ama oyuncular pembe siyah dokular ya da ERROR modelleri görüyorsa, en sık neden addon’un oyunculara gönderilmemesidir: içerik addon’unu resource.AddWorkshop ile ekleyin. Garry’s Mod’un Temmuz 2025 güncellemesinden beri Counter-Strike: Source içeriğinin çoğu oyunla birlikte geldiği için CS:S kaynaklı vakalar azaldı; CS:S haritaları ise hâlâ ayrıca bağlanmalıdır. Addon’lar birbiriyle çakışıyorsa (aynı silahı ya da aynı dosyayı tanımlayan iki addon), birini koleksiyondan çıkarıp sorunun gidip gitmediğini deneyin.

Oyuncuların bağlanması çok uzun sürüyor

Oyuncular sunucuya ilk kez bağlanırken işaretlenen bütün içeriği indirir. Koleksiyonda ve resource.AddWorkshop listesinde gerçekten kullanmadığınız addon’lar varsa çıkarın; büyük harita paketlerini ve kıyafet koleksiyonlarını oyuncu sayınıza göre değerlendirin.

Kurulumla uğraşmak istemiyorsanız

Workshop koleksiyonu kurmak kolaydır; asıl iş koleksiyonu güncel, çakışmasız ve oyuncuların hızlı indirebileceği boyutta tutmaktır. Önem Bilişim’in Garry’s Mod paketleri AMD Ryzen 9 işlemcili sunucularda, NVMe diskle, İstanbul Datacasa’da ve DDoS korumasıyla çalışır; paket sayfasına göre Workshop içerikleri ve FastDL indirmelerinde trafik sınırı yoktur. Paket önericisindeki tahmine göre Sandbox ve TTT gibi modlarda 24, yoğun addon’lu sunucularda 16 oyuncuya kadar 4 GB yeterlidir; daha kalabalık sunucular için 6, 8 ve 10 GB’lık paketler vardır. Güncel fiyatlar paket sayfasındadır.

Başka bir oyun için sunucu arıyorsanız tüm oyun sunucusu paketlerini tek sayfada karşılaştırabilirsiniz. Aynı konunun Unturned karşılığını Unturned Workshop modu ve özel harita ekleme rehberinde anlattık.

Sık Sorulan Sorular

Oyuncular addon’ları otomatik indirir mi?

Kısmen. Lua dosyaları oyunculara kendiliğinden gönderilir; Workshop’tan gelen oyun modu ve sunucunun çalıştırdığı harita koleksiyondaysa onlar da kendiliğinden indirilir. Model, doku ve ses içeren diğer addon’lar için sunucu tarafında resource.AddWorkshop("ADDON_ID") satırı gerekir. Bu satırlar yoksa addon sunucuda çalışır ama oyuncular pembe siyah dokular ya da ERROR modelleri görür.

Koleksiyon ekledim ama sunucu indirmiyor, neden?

En sık iki neden vardır: koleksiyonun gizli olması ya da koleksiyon yerine tek bir addon’un kimliğinin yazılması. Koleksiyonun görünürlüğünü herkese açık ya da liste dışı yapın, kimliği koleksiyon sayfasının adresindeki ?id= değerinden alın. Konsolda Item is not a collection! görüyorsanız yanlış kimlik kullanıyorsunuz demektir. WS: No +host_workshop_collection or it is invalid! ise parametrenin hiç okunmadığını gösterir.

ERROR modelleri neden çıkıyor?

ERROR modeli, oyuncunun bilgisayarında o modelin dosyası olmadığında görünür. Sunucuda addon bağlı olsa bile oyuncu onu indirmemiş olabilir; içerik addon’unu resource.AddWorkshop ile ekleyin. Temmuz 2025’ten beri Counter-Strike: Source içeriğinin çoğu Garry’s Mod’la geldiği için CS:S kaynaklı vakalar azaldı. Sorun yalnızca belirli bir addon’daysa addon’un kendisi hatalı paketlenmiş olabilir.

Addon klasörüne elle atılır mı?

Atılabilir ve garrysmod/addons/ altındaki klasörler sunucu açılışında yüklenir. Bu yöntem Workshop’ta olmayan özel addon’lar, yalnızca sunucuda çalışan Lua eklentileri ya da darkrpmodification gibi düzenlemeniz gereken dosyalar için uygundur. Ancak elle kopyalanan içerik oyunculara kendiliğinden gitmez; içerik için Workshop ve resource.AddWorkshop ya da FastDL kullanmanız gerekir.

Koleksiyonda kaç addon olmalı?

Kesin bir sınır yoktur, ama her içerik addon’u oyuncuların ilk bağlanma süresini uzatır ve sunucunun bellek kullanımını artırır. resource.AddWorkshop sayfasına göre bütün resource.Add* fonksiyonları için toplam 8192 indirilebilir dosya sınırı vardır. Koleksiyonu gerçekten kullandığınız addon’larla sınırlı tutun, aynı işi yapan addon’lardan yalnızca birini seçin ve büyük harita paketlerini oyuncu sayınıza göre değerlendirin.

Workshop addon’ları güncellenince ne olur?

Sunucu her açılışta koleksiyondaki addon’ları kontrol eder ve yeni sürümleri indirir; oyuncular da bağlanırken güncel sürümü alır. Bir güncellemenin sorun çıkarmasından endişe ediyorsanız host_workshop_autoupdate 0 ile otomatik güncellemeyi kapatabilirsiniz. Wiki bunun bedelini de belirtir: güncellenmeyen bir harita yüzünden oyuncular sunucuya giremeyebilir.

Kaynaklar

• Garry’s Mod Wiki: Workshop for Dedicated Servers
• Garry’s Mod Wiki: resource.AddWorkshop
• Garry’s Mod Wiki: Serving Content
• Garry’s Mod: Temmuz 2025 güncellemesi (CS:S içeriği)

Önem Bilişim Teknik Ekibi · Son güncelleme: Ekim 2026