GMod Eklenti Yükleme ve Yönetici Yetkisi: addons, users.txt ve Workshop Rehberi

Garry's Mod'u bu kadar uzun ömürlü yapan şey eklentileridir: silahlar, araçlar, yönetim panelleri, arayüzler ve haritalar bir sunucuyu tamamen farklı bir oyuna dönüştürebilir. GMod eklenti yükleme işi doğru klasörü ve doğru yapıyı bildiğinizde birkaç dakikadır; asıl önemli olan, eklentinin gerçekten yüklendiğini doğrulamak ve sunucunuzun yönetimini güvenli tutmaktır.

Bu rehberde Garry's Mod sunucusunda eklentilerin nereye ve hangi yapıyla yüklendiğini, yüklendiğini konsoldan nasıl doğrulayacağınızı, kendinizi ve yardımcılarınızı nasıl yönetici yapacağınızı, Workshop koleksiyonunun nasıl bağlanacağını ve eklenti sorunlarını nasıl ayıklayacağınızı anlatıyoruz. Eklenti yükleme ve yönetici ayarı gerçek bir test sunucusunda denendi.

---

Eklentiler Nereye Yüklenir?

Garry's Mod sunucusunda eklentiler garrysmod/addons klasörüne yüklenir. Her eklenti bu klasörün içinde kendi klasöründe durur. Bir eklenti klasörünün içi genellikle oyunun kendi klasör yapısını taklit eder:

• lua: eklentinin kodu. lua/autorun içindeki dosyalar sunucu açılırken kendiliğinden çalışır; lua/autorun/server yalnız sunucuda, lua/autorun/client yalnız oyuncuda çalışır.
• materials, models, sound: dokular, modeller ve sesler.
• maps: eklentiyle gelen haritalar.

Eklentinin klasörleri doğrudan addons/EklentiAdi altında olmalıdır. Zip dosyası açılırken fazladan bir klasör katmanı oluşursa (örneğin addons/EklentiAdi/EklentiAdi/lua) sunucu eklentiyi bulamaz.

---

Eklenti Seçerken Nelere Dikkat Etmeli?

Her eklenti sunucunuza yük ve bakım getirir. Bir eklentiyi yüklemeden önce şu soruları sormak, sonradan yaşanacak sorunların çoğunu önler:

• Güncel mi? Garry's Mod düzenli güncellenir. Uzun süredir güncellenmeyen eklentiler yeni sürümlerde hata verebilir. Eklentinin son güncellenme tarihine ve yorumlarına bakın.
• Hangi oyun modu için? Bazı eklentiler yalnız DarkRP ya da yalnız TTT için yazılmıştır. Eklenti açıklamasında hedef oyun modu belirtilir.
• Kaynağı güvenilir mi? Eklentiler sunucunuzda kod çalıştırır. Yalnız bilinen ve çok kullanılan kaynaklardan eklenti yükleyin; kaynağını bilmediğiniz, şifrelenmiş ya da gizlenmiş kod içeren eklentilerden uzak durun.
• Gerçekten gerekli mi? Aynı işi yapan iki eklenti birbiriyle çakışabilir. Bir eklenti eklemeden önce benzer bir eklentinin kurulu olup olmadığını kontrol edin.

Bu sorulara verilen yanıtlar, sunucunuzun hem kararlı hem de güvenli kalmasını sağlar. Özellikle herkese açık bir sunucuda, bir eklentinin içinde ne olduğunu bilmeden yüklemek ciddi bir risktir.

---

Eklenti Yükleme Adım Adım

1. Sunucuyu durdurun. Panelin Stop (Durdur) düğmesine basın. Sunucu açıkken yüklenen eklentiler bir sonraki açılışa kadar etkin olmaz; durdurup yüklemek karışıklığı önler.
2. Eklentiyi yükleyin. Files (Dosyalar) sekmesinde garrysmod/addons klasörüne girin. Eklentiyi zip olarak yükleyip panelde açabilir ya da büyük eklentiler için SFTP kullanabilirsiniz.
3. Yapıyı kontrol edin. addons/EklentiAdi/lua gibi bir yol oluşmuş olmalı.
4. Sunucuyu başlatın. Panelden Start (Başlat) düğmesine basın.
5. Konsolu kontrol edin. Eklentinin yüklendiğini gösteren satırı ve varsa hata satırlarını arayın.

Garry's Mod, açılışta her eklentiyi Adding Filesystem Addon satırıyla konsola yazar. Test sunucusuna, açılışta konsola bir satır yazan küçük bir eklenti yüklendi; konsolda hem eklentinin eklendiğini gösteren satır hem de eklentinin kendi mesajı göründü:

Eklentinin klasör adı satırda görünmüyorsa sunucu klasörü eklenti olarak tanımamıştır; büyük olasılıkla yapı yanlıştır. Satır görünüyor ama eklenti çalışmıyorsa sorun eklentinin kendisinde ya da başka bir eklentiyle çakışmasındadır; bu durumda konsolda eklentinin adını taşıyan hata satırlarını arayın. Hata satırı yoksa eklentinin ayar dosyası olup olmadığına bakın; bazı eklentiler ilk açılışta garrysmod/data altında bir ayar dosyası oluşturur ve siz bu dosyayı düzenleyene kadar varsayılan değerlerle çalışır.

---

Kendi Küçük Eklentinizi Yazarak Test Etmek

Eklenti sistemini anlamanın en kolay yolu, yalnız konsola bir satır yazan küçük bir eklenti oluşturmaktır. Test sunucusunda şu tek satırlık dosya kullanıldı:

garrysmod/addons/anksoft_rehber/lua/autorun/server/rehber.lua

print("[REHBER] AnkSOFT test eklentisi yuklendi")

Bu dosyayı oluşturup sunucuyu yeniden başlattığınızda konsolda [REHBER] ile başlayan satırı görürsünüz. Böyle bir test, eklentilerin sunucunuzda doğru klasörden yüklendiğini ve autorun mantığını anladığınızı doğrular. İşiniz bittiğinde test klasörünü silebilirsiniz. Aynı yöntemi, karmaşık bir eklentiyi kurmadan önce klasör yapısının ve dosya yollarının doğru olduğundan emin olmak için de kullanabilirsiniz: küçük bir test eklentisi çalışıyorsa sorun yükleme yönteminde değil, eklentinin kendisindedir.

---

Kendinizi ve Yardımcılarınızı Yönetici Yapmak

Garry's Mod'un yerleşik yetki sistemi garrysmod/settings/users.txt dosyasını kullanır. Bu dosyada superadmin ve admin olmak üzere iki temel grup vardır; oyuncular Steam kimlikleriyle bu gruplara eklenir.

Panelde bu iş kolaydır: Steam profilinizdeki 17 haneli SteamID64 numaranızı Başlangıç sekmesindeki Yönetici Steam64 ID alanına yazıp sunucuyu yeniden başlatın. Sunucu açılırken numara, Garry's Mod'un kullandığı STEAM_0:X:Y biçimine çevrilip superadmin grubuna yazılır. Test sunucusunda bu dönüşümün doğru yapıldığı ve satırın dosyaya eklendiği görüldü:

Panelden eklenen satırlar AnkSOFT_panel adıyla işaretlenir. Bir numarayı alandan silip yeniden başlattığınızda o satır kaldırılır; dosyaya elle eklediğiniz diğer kişiler korunur. Yardımcılarınızı daha düşük yetkiyle eklemek isterseniz dosyanın admin bölümüne kendiniz ekleyebilirsiniz.

Büyük topluluklar genellikle rütbe sistemi olan bir yönetim eklentisi kullanır. Böyle bir eklenti kurarsanız rütbeleri eklentinin kendi komutları ya da ayar dosyalarıyla yönetirsiniz; panel alanı yalnız users.txt dosyasını yönetir.

---

Yönetim Eklentisi Kurarken

Garry's Mod'un yerleşik yetki sistemi superadmin ve admin olmak üzere iki temel grupla sınırlıdır. Kalabalık sunucular çoğu zaman moderatör, yardımcı ve VIP gibi ek rütbeler ister; bunun için rütbe sistemi olan bir yönetim eklentisi kurulur.

Yönetim eklentisi kurarken şu sırayı izlemek işinizi kolaylaştırır:

1. Önce kendinizi panelin Yönetici alanıyla superadmin yapın ve sunucuyu yeniden başlatın.
2. Yönetim eklentisini garrysmod/addons klasörüne yükleyip sunucuyu yeniden başlatın.
3. Oyuna girip eklentinin kendi menüsünden ya da komutlarından rütbeleri oluşturun.
4. Yardımcılarınızı bu rütbelere ekleyin ve her rütbeye yalnız ihtiyaç duyduğu yetkileri verin.

Yönetim eklentileri genellikle kendi verilerini garrysmod/data klasöründe tutar. Bu klasörü düzenli olarak bilgisayarınıza indirmek, rütbelerin ve yasakların kaybolmasına karşı en basit önlemdir.

---

Workshop Koleksiyonu Bağlamak

Özel haritalar, modeller ve dokular kullanan bir sunucuda oyuncuların bu içerikleri indirmesi gerekir. Bunun en pratik yolu Steam Workshop koleksiyonudur: sunucu açılırken koleksiyondaki içerikleri indirir ve oyunculara bağlanırken aynı içerikleri indirmelerini söyler.

Koleksiyon bağlamak için Başlangıç sekmesinde iki alan doldurulur:

1. Workshop Koleksiyonu: Steam'de oluşturduğunuz koleksiyonun sayfa adresindeki numara.
2. Steam Web API Anahtarı: kendi Steam hesabınızdan aldığınız 32 karakterlik anahtar. Garry's Mod sunucusu koleksiyonu indirmek için bu anahtarı ister.

İki alan da doluysa sunucu açılırken koleksiyon yüklenir. Anahtar eksik ya da hatalıysa konsolda koleksiyonun atlandığını bildiren bir [AnkSOFT] satırı görürsünüz. Koleksiyon kullanılmadığında konsolda koleksiyonun ayarlanmadığını söyleyen bir satır görmeniz normaldir; test sunucusunda da bu satır göründü. Steam Web API anahtarınızı kimseyle paylaşmayın; yalnız bu alana yazın.

---

Oyuncular İçerikleri Nasıl İndirir?

Bir eklenti özel model, doku ya da ses kullanıyorsa bu dosyaların oyuncuların bilgisayarında da bulunması gerekir; aksi halde oyuncular eksik doku ya da hata modeli görür. Garry's Mod'da bunun iki yolu vardır:

1. Workshop: içerik Workshop'ta yayımlanmışsa koleksiyonunuza ekleyin. Oyuncular bağlanırken içeriği Steam üzerinden indirir. Bu, en hızlı ve en sorunsuz yoldur.
2. Sunucudan indirme: sunucu ayar dosyasında oyuncuların sunucudan dosya indirmesine izin verilir. Bu yöntem küçük dosyalar için çalışır, ama büyük içeriklerde bağlanma süresini uzatır.

Mümkünse içerikleri Workshop koleksiyonu üzerinden sunmak, oyuncuların bağlanırken uzun süre beklemesini önler. Koleksiyonu güncel tutmak da önemlidir: sunucudan kaldırdığınız bir eklentinin içeriğini koleksiyondan da çıkarın.

---

Eklenti Sorunlarını Ayıklamak

Bir eklenti sunucuyu bozduğunda ya da beklendiği gibi çalışmadığında şu sırayla ilerleyin:

1. Konsoldaki hata satırına bakın. Lua hataları genellikle dosya adını ve satır numarasını gösterir. Hata hangi eklentinin klasöründeyse sorun odur.
2. Son eklenen eklentiyi kaldırın. Sorun yeni bir eklentiden sonra başladıysa o eklentiyi klasöründen çıkarıp sunucuyu yeniden başlatın.
3. Bağımlılıkları kontrol edin. Bazı eklentiler başka bir eklentinin ya da belirli bir oyun modunun kurulu olmasını ister. Eklentinin açıklamasındaki gereksinimlere bakın.
4. Oyun modu uyumunu kontrol edin. DarkRP için yazılmış bir eklenti TTT'de hata verebilir. Test sunucusunda DarkRP'ye özgü bir eklenti TTT'de çalıştırıldığında konsolda var olmayan temel sınıflardan türetme hataları görüldü.
5. 64 bit uyumu: Sürüm Dalı alanına x86-64 yazdıysanız, eski ve derlenmiş modül içeren eklentilerin bu sürümü desteklediğinden emin olun.

Eklentileri tek tek eklemek ve her eklemeden sonra kısa bir test yapmak, sorunların çoğunu daha ortaya çıkmadan önler.

Sorunu bulamadığınızda eklentileri yarı yarıya ayırarak ilerlemek de işe yarar: eklentilerin yarısını geçici olarak addons dışındaki bir klasöre taşıyıp sunucuyu başlatın. Sorun geçtiyse sorunlu eklenti taşıdığınız yarıdadır; geçmediyse kalan yarıdadır. Bu adımı birkaç kez tekrarlayarak çok sayıda eklenti arasından sorunlu olanı hızlıca bulabilirsiniz. İşiniz bitince taşıdığınız eklentileri yerine koymayı unutmayın.

Bir sorunu çözemediğinizde destek talebi açarken konsoldaki hata satırlarını, son eklediğiniz eklentinin adını ve sorunun hangi oyun modunda başladığını yazmanız, yanıtın hızlı ve doğru olmasını sağlar.

---

Eklentileri Düzenli Tutmak

Sunucunuz büyüdükçe addons klasörü kalabalıklaşır. Birkaç alışkanlık işinizi kolaylaştırır:

• Anlaşılır klasör adları: eklenti klasörlerinin adında yalnız küçük harf, rakam ve alt çizgi kullanın.
• Yedek: büyük bir değişiklikten önce garrysmod/addons ve garrysmod/data klasörlerini SFTP ile bilgisayarınıza indirin.
• Not tutma: hangi eklentiyi ne zaman, neden eklediğinizi kısa bir notla yazın. Bir sorun çıktığında geriye doğru izlemek kolaylaşır.
• Kullanılmayanları kaldırma: artık kullanmadığınız eklentileri silmek açılış süresini ve oyuncuların indireceği içerik miktarını azaltır.

Yeniden kurulum ve otomatik güncelleme addons, gamemodes, cfg ve data klasörlerine dokunmaz; eklentileriniz bu işlemlerde korunur. Test sunucusunda yeniden kurulumdan sonra eklentilerin, oyun modlarının ve ayar dosyasının yerinde kaldığı görüldü. Bu yüzden Garry's Mod güncellemesinden sonra eklentilerinizi yeniden yüklemeniz gerekmez; yalnız eklentilerin yeni sürümle uyumlu olduğunu kontrol etmeniz yeterlidir.

---

En Sık Yapılan Hatalar

1. Fazladan klasör katmanı. addons/EklentiAdi/EklentiAdi/lua yapısında eklenti yüklenmez.
2. Eklentiyi gamemodes klasörüne koymak. Oyun modları gamemodes, eklentiler addons klasörüne gider.
3. Sunucu açıkken yükleyip etkinleşmesini beklemek. Eklentiler sunucu açılırken okunur; yeniden başlatın.
4. Steam Web API anahtarı olmadan koleksiyon beklemek. Koleksiyon için anahtar zorunludur.
5. users.txt içindeki panel satırlarını elle değiştirmek. Bu satırlar her açılışta panelden yeniden yazılır; değişikliği Başlangıç sekmesinden yapın.
6. Bir oyun moduna özel eklentiyi başka modda çalıştırmak. Eklentinin hangi oyun modu için yazıldığını kontrol edin.

---

Özet

1. Eklentiler garrysmod/addons/EklentiAdi yapısıyla yüklenir; fazladan klasör katmanı olmamalıdır.
2. Konsolda Adding Filesystem Addon satırı eklentinin tanındığını gösterir.
3. Yönetici olmak için SteamID64 numaranızı panelin Yönetici alanına yazın; numara users.txt dosyasına superadmin olarak eklenir.
4. Workshop koleksiyonu için koleksiyon numarası ve kendi Steam Web API anahtarınız gerekir.
5. Eklenti sorunlarında konsoldaki hata satırına ve son eklenen eklentiye bakın.

İlk kurulum için GMod sunucu kurma rehberine, roleplay için DarkRP sunucu kurma rehberine göz atabilir, GMod sunucu paketlerini inceleyebilirsiniz.