Garry's Mod Workshop Addons kurulumunu düzgün şekilde bir Steam Workshop Collection, bir Steam Web API Key ve isteğe bağlı olarak istemci indirmesi için resource.AddWorkshop() üzerinden yaparsın. Böylece sunucu yapılandırması anlaşılır kalır, Addons merkezi olarak değiştirilebilir ve sorunlarda Collection, API Key ya da tek tek Workshop ID'lerinde hata olup olmadığını hedefli şekilde kontrol edebilirsin.
Gereksinimler
Garry's Mod sunucunun başlangıç parametrelerine erişime, bir Steam Workshop Collection'a ve bir Steam Web API Key'e ihtiyacın var. Garry's Mod Workshop içerikleri için resmi kaynak Garry's Mod için Steam Workshop. API Key'i resmi Steam sayfası steamcommunity.com/dev/apikey üzerinden oluşturursun.
Addon seçimini bilinçli planla. Büyük bir Collection sunucu başlangıcını uzatabilir, istemcileri daha uzun indirmelere zorlayabilir ve hataları bulmayı zorlaştırabilir. Canlı sunucular için Addons'ları kalıcı olarak ana Collection'a almadan önce tek tek veya küçük gruplar halinde test etmek mantıklıdır. game-serverhosting'de bu süreç kontrollü bir işletim modeline iyi uyar: değişiklikler belgelenir, kontrol edilir ve ancak sonra oyunculara açılır.
Workshop Collection oluşturma
- Steam Workshop sayfasına git
- Yeni bir Collection oluştur
- İstediğin tüm Addons'ları ekle
- Collection ID'yi kopyala
Collection ID, Steam Collection URL'sinde yer alır. Tüm URL'yi değil, sadece sayısal ID'yi kopyala. Ayrıca Collection'ın herkese açık olduğundan veya sunucu tarafından erişilebilir olduğundan emin ol. Bir Addon kaldırılırsa, gizliye alınırsa veya yazar tarafından güncellenirse bu durum sunucu başlangıcını ya da istemci indirmelerini etkileyebilir. Bu yüzden büyük değişikliklerden sonra her zaman sunucu konsolunu kontrol et.
Collection'ı sunucuda yükleme
Sunucu başlangıç satırında:
+host_workshop_collection <collection_id>
-authkey <steam_web_api_key>
<collection_id> değerini Workshop Collection ID'nle, <steam_web_api_key> değerini Steam Web API Key'inle değiştir. +host_workshop_collection parametresi sunucuya belirtilen Collection'ı yüklemesini söyler. -authkey parametresi Workshop indirmeleri için gereken Steam web hizmetlerine erişim sağlar.
Başlangıç parametrelerini girdikten sonra sunucuyu yeniden başlat. İlk başlatmada konsolu veya log'u izle. Workshop içerikleri yüklenmiyorsa neden çoğu zaman yanlış Collection ID, eksik veya geçersiz API Key ya da artık erişilemeyen bir Addon olur.
Steam Web API Key
Workshop indirmeleri için gereklidir:
- steamcommunity.com/dev/apikey adresine git
- Key oluştur
- Başlangıç satırına
-authkeyolarak gir
API Key'i bir erişim token'ı gibi ele al. Onu herkese açık paylaşma ve forumlara, ekran görüntülerine veya herkesin erişebildiği depolara yazma. Key'in açığa çıktığından şüpheleniyorsan Steam'de yeniden oluşturmalı ve eski Key'i kullanmaya devam etmemelisin.
Oyuncular Addons'ları otomatik indirir
Oyuncuların Addons'ları otomatik indirmesi için lua/autorun/server/workshop.lua içine şunu ekle:
resource.AddWorkshop("workshop_id_1")
resource.AddWorkshop("workshop_id_2")
resource.AddWorkshop("workshop_id_3")
resource.AddWorkshop() tek tek Workshop ID'lerini kullanır. İstemcilerin bağlanırken otomatik olarak alması gereken Addons'ları buraya gir. Bu özellikle oyuncuların yerel olarak ihtiyaç duyduğu map'ler, models, materials, sounds veya diğer içerikler için önemlidir. Sadece sunucu tarafında çalışan Addons'ların istemcilere dağıtılması şart değildir.
Bu dosyayı net şekilde yapılandırılmış tut. Addons'ları amaçlarına göre gruplayabilirsin, örneğin Maps, Weapons, Playermodels veya HUDs. Bir Addon sorun çıkarırsa ilgili girdiyi test için yorum satırına alıp sunucuyu yeniden başlatırsın. Böylece tüm Collection'ı parçalamadan çakışmaları daha hızlı bulursun.
Popüler Addon kategorileri
| Kategori | Örnekler |
|---|---|
| Maps | ttt_minecraft, ph_office |
| Weapons | M9K Weapons, TFA Base |
| Playermodels | PM + Playermodel Selector |
| Tools | Wiremod, Precision Tool |
| HUDs | DarkRP HUD, TTT HUD |
Bu kategoriler tipik örneklerdir, her kurulum için öneri değildir. DarkRP, TTT, Prop Hunt ve Sandbox sunucularının farklı gereksinimleri vardır. Önemli olan Addons'ların oyun moduna uyması, aktif olarak bakımlarının yapılması ve çakışan işlevler getirmemesidir. İki silah tabanı, birden fazla HUD veya birden fazla admin aracı birbirini bozabilir.
Mod iş akışları olan başka oyunlar da çalıştırıyorsan Project Zomboid Workshop Guide ve ARK Mods installieren Guide içindeki prensipler yardımcı olur: önce bağımlılıkları netleştir, sonra ID'leri düzgün gir, ardından log'lar 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, Collection veya API Key ile ilgili Workshop hatası göstermemeli. İkincisi: İstenen Addons sunucu tarafında kullanılabilir olmalı, örneğin map listesinde Maps veya uygun oyun modunda Tools. Üçüncüsü: Bir test istemcisi bağlanırken gerekli içerikleri otomatik yüklemeli veya Missing Texture sorunları göstermemeli.
Mümkünse Addons'ları yerel olarak zaten 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 yüklenmesi gerekiyorsa sunucu açıklamasında kısa bir not da faydalıdır.
Sorun giderme
- Addon yüklenmiyor: Steam Web API Key'i kontrol et
- Missing Textures: CSS Content Pack kur
- Yavaş indirme: Collection'ı gerekli minimuma indir
Tüm Collection yüklenmiyorsa önce +host_workshop_collection ve -authkey içindeki yazım hatalarını kontrol et. Sadece tek bir Addon eksikse onun Workshop sayfasını aç ve hâlâ erişilebilir olup olmadığını kontrol et. Eksik dokularda Workshop içerikleri ile dışarıdan gereken Content arasında ayrım yaparsın. Garry's Mod sunucuları çoğu zaman tek bir Addon tarafından otomatik olarak değiştirilmeyen içerikleri kullanır.
Uzun yükleme sürelerinde kullanılmayan Maps, çift modeller, eski silah paketleri ve büyük ses veya materyal koleksiyonlarını kaldır. Daha küçük bir Collection bakım açısından daha kolaydır ve oyuncuların ilk katılımda çıkma ihtimalini azaltır.
Kontrol, sınırlar ve güvenli geri dönüş
"Garry's Mod Workshop Addons kurma" rehberi makalede açıklanan sunucu türü ve kontrol zamanında görünen sürüm durumu için geçerlidir. Menü adları, kullanılabilir sürümler, mod veya plugin uyumluluğu ve gereken kaynaklar güncellemelerden sonra değişebilir. Bu yüzden değerleri kontrol etmeden başka bir oyun, loader veya sunucu sürümüne aktarma.
World, kayıt, yapılandırma veya eklentilerde değişiklik yapmadan önce etkilenen dosyaların yedeğini oluştur. Ardından yalnızca birbiriyle bağlantılı tek bir adımı değiştir ve daha sonra oynamak istediğin aynı istemci ve sunucu sürümüyle kontrol et.
| Kontrol noktası | Beklenen sonuç | İptal ve geri dönüş |
|---|---|---|
| Sunucu başlangıcı | Sunucu yeni hata mesajı olmadan çalışmaya hazır duruma ulaşır. | Başlangıç hatalarında değişikliği geri al ve son yedeği geri yükle. |
| Bağlantı testi | Bir test hesabı panelde gösterilen adres üzerinden bağlanabilir. | Sürüm veya bağlantı hatalarında sürümü, portu ve izinleri yeniden karşılaştır. |
| İşlev testi | Değiştirilen somut işlev, mevcut world veya oyun verilerine zarar vermeden çalışır. | Yan etkilerde sunucuyu durdur ve yedeklenen dosyaları geri yükle. |
Başarılı bir tekil test performans veya erişilebilirlik garantisi değildir. World boyutu, Mods, Plugins, oyuncu sayısı, ağ yolu ve eşzamanlı yük sonucu değiştirebilir. Sürümü, değişikliği ve test sonucunu belgele ki sonraki sapmaları takip edebilesin.
FAQ
Her zaman bir Workshop Collection'a ihtiyacım var mı?
Birden fazla Addon içeren bir sunucu için Collection en temiz yoldur, çünkü seçimi merkezi olarak Steam'de yönetirsin. Yine de resource.AddWorkshop() içindeki tek tek Workshop ID'leri önemlidir, böylece istemciler gerekli içerikleri otomatik indirebilir.
Collection ID ile Workshop ID arasındaki fark nedir?
Collection ID, birden fazla Addon içeren bir koleksiyona işaret eder. Workshop ID ise tek bir Addon'a işaret eder. Başlangıç satırında Collection ID'yi kullanırsın, resource.AddWorkshop() içinde tek tek Workshop ID'lerini girersin.
Oyuncular neden eksik dokular görüyor?
Eksik dokular çoğunlukla istemci içerikleri yüklenmediğinde veya ek Content gerektiğinde oluşur. resource.AddWorkshop() değerini, Addon ID'lerini ve etkilenen Addon'ın başka Content'e işaret edip etmediğini kontrol et.
Her Addon değişikliğinden sonra sunucuyu yeniden başlatmam gerekiyor mu?
Başlangıç parametreleri, Workshop Collection veya sunucu taraflı Lua dosyalarındaki değişiklikler için yeniden başlatmalısın. Sunucunun Collection'ı doğru yükleyip istemci kaynaklarını kaydettiğini güvenilir şekilde ancak böyle kontrol edersin.
Bir Collection ne kadar büyük olmalı?
Mümkün olduğunca küçük, gerektiği kadar büyük. Oyun modunun aktif olarak kullanmadığı Addons'ları kaldır. Bu hata aramayı kolaylaştırır, indirmeleri yönetilebilir tutar ve canlı işletimde değişiklikleri daha iyi kontrol edilebilir yapar.