CS2 sunucunuza admin komutları, retake veya deathmatch eklentileri, istatistik ve yasak sistemi eklemek istiyorsanız, vanilla sunucu yetmez. CS:GO döneminde bu iş SourceMod ile yapılıyordu; CS2'de ise topluluğun en yaygın kullandığı yapı Metamod:Source ve onun üzerinde çalışan CounterStrikeSharp (kısaca CSS) ikilisi.
Bu rehberde Metamod:Source ve CounterStrikeSharp kurulumunu, en kritik adım olan gameinfo.gi düzenlemesini, admin tanımlamayı ve CS2 güncellemelerinin eklentileri neden bozabileceğini anlatıyoruz. Ayrıca Valve'ın GSLT yasağına yol açan eklenti türlerini resmî Steam kaynağından aktarıyoruz. Bilgiler AlliedModders wiki'si ve CounterStrikeSharp'ın resmî belgelerinden alındı.
Metamod:Source ve CounterStrikeSharp nedir?
Metamod:Source, Source motorlu oyunların sunucularına eklenti yüklemeyi sağlayan bir ara katmandır. AlliedModders wiki'sine göre Source 2'de bir sunucu eklenti sistemi bulunmadığı için Metamod, sunucu kütüphanesinin yerine kendi yükleyicisini koyarak çalışır; bu, Source 2 için desteklenen tek yöntemdir.
CounterStrikeSharp, Metamod üzerinde çalışan ve CS2 eklentilerinin C# (.NET) ile yazılmasını sağlayan bir çatıdır. Kendi belgeleri, oyun sunucusuyla iletişim için Metamod:Source kullandığını, bu yüzden ikisinin birlikte kurulması gerektiğini belirtiyor.
Gerekenler

- Kurulu ve çalışan bir CS2 sunucusu. Kurulum için CS2 sunucu kurulum rehberimize bakın.
- Metamod:Source 2.x dev build: CounterStrikeSharp belgeleri, KHook desteği olan 1467 veya daha yeni bir build istiyor. Metamod:Source indirmeleri (2.x dev) sayfasından işletim sisteminize uygun paketi indirin.
- CounterStrikeSharp "with runtime" sürümü: GitHub sürümler sayfasından. İlk kurulumda .NET çalışma zamanını içeren with-runtime paketi zorunludur.
- Windows sunucularda: Visual Studio (Visual C++) Redistributable kurulu olmalı; belgeler aksi hâlde CounterStrikeSharp'ın çalışmayacağını belirtiyor.
- Linux sunucularda: dağıtımınıza göre
libicu,icu-libsveyalibicu-devpaketi gerekebilir.
Adım 1: Metamod:Source kurulumu

İndirdiğiniz Metamod arşivini açın ve içindeki addons klasörünü sunucunuzun game/csgo/ klasörüne kopyalayın. Sonuçta game/csgo/addons/metamod/ yolu oluşmalı.
gameinfo.gi düzenlemesi
Metamod'un yüklenmesi için game/csgo/gameinfo.gi dosyasında küçük bir değişiklik gerekir. AlliedModders wiki'sinin uyarısı: dosyanın başlığı başka bir yeri işaret etse bile core klasöründeki gameinfo.gi'yi değil, csgo klasöründeki dosyayı düzenleyin. Dosyada SearchPaths bölümünü bulun. Güncel CS2 dosyalarında bu bölüm şöyle başlar:
SearchPaths
{
Game_LowViolence csgo_lv // Perfect World content override
Game csgo
Game core
...CounterStrikeSharp belgelerine göre Game_LowViolence csgo_lv satırının hemen altına yeni bir satır ekleyin:
SearchPaths
{
Game_LowViolence csgo_lv // Perfect World content override
Game csgo/addons/metamod
Game csgo
Game core
...AlliedModders wiki'si Metamod satırının Game girdilerinin en başında olması gerektiğini, başka bir yere konursa Metamod'un yüklenmeyeceğini vurguluyor. Yukarıdaki yerleşim bu şartı sağlar: Metamod satırı, Game csgo ve Game core satırlarından öncedir. Wiki ayrıca GameBin anahtar kelimesinin bu iş için çalışmadığını belirtiyor.
Kurulumu doğrulayın
Sunucuyu yeniden başlatın ve konsola meta version yazın. AlliedModders wiki'sine göre çalışan bir kurulumda Metamod:Source sürüm bilgisi görünür. Komut tanınmıyorsa (Unknown Command) klasörlerin doğru yere kopyalandığını ve gameinfo.gi değişikliğini kontrol edin; wiki ayrıca oyunu son sürüme güncellemenizi ve en yeni Source 2 build'ini kullanmanızı öneriyor.
Adım 2: CounterStrikeSharp kurulumu
CounterStrikeSharp kurulumu daha basittir:
- İndirdiğiniz with-runtime arşivini açın ve içindeki
addonsklasörünü yinegame/csgo/içine kopyalayın; mevcut addons klasörüyle birleşir. - Sunucuyu yeniden başlatın.
- Konsola
meta listyazın. CounterStrikeSharp yüklü bir eklenti olarak listelenmelidir.
Belgelere göre doğru kurulumdan sonra game/csgo/addons klasör yapısı kabaca şöyle olmalı:
addons/
counterstrikesharp/
api/
bin/
dotnet/
gamedata/
plugins/
metamod/
bin/
counterstrikesharp.vdf
metaplugins.ini
metamod.vdf
metamod_x64.vdfCounterStrikeSharp eklentileri addons/counterstrikesharp/plugins/ klasörüne kurulur. Her eklentinin kendi kurulum talimatı olabilir; eklentinin sayfasındaki yönergeleri izleyin.
Adım 3: Admin tanımlama
CounterStrikeSharp, eklentilerin komutlara izin bağlayabildiği basit bir admin çerçevesi içerir. Belgelere göre CounterStrikeSharp başlarken admin listesini kendi klasöründeki configs/admins.json dosyasından (yani addons/counterstrikesharp/configs/) yükler. Her admin için SteamID ve yetki bayrakları (flags) yazılır:
{
"Yonetici1": {
"identity": "76561198000000000",
"flags": ["@css/generic", "@css/kick", "@css/ban", "@css/changemap"]
}
}Belgelere göre tüm kullanıcı izinleri @ ile başlamalıdır, aksi hâlde tanınmaz. SourceMod'daki harf tabanlı bayrakların yerine dize (string) bayraklar kullanılır. Yaygın standart bayraklardan bazıları:
| Bayrak | Anlamı |
|---|---|
| @css/reservation | Ayrılmış slot erişimi |
| @css/generic | Genel admin |
| @css/kick | Oyuncu atma |
| @css/ban | Oyuncu yasaklama |
| @css/unban | Yasak kaldırma |
| @css/slay | Oyuncu öldürme / hasar verme |
| @css/changemap | Harita veya büyük oynanış özelliklerini değiştirme |
| @css/cvar | Çoğu cvar'ı değiştirme |
| @css/config | Config dosyası çalıştırma |
| @css/rcon | RCON komutları kullanma |
| @css/cheats | sv_cheats veya hile komutları |
| @css/root | Tüm bayrakları açar, dokunulmazlık değerlerini yok sayar |
Bayrakları gruplamak için configs/admin_groups.json dosyasını kullanabilirsiniz; grup adları # ile başlamalıdır. Admini gruba eklemek için admins.json'daki girdiye bir groups dizisi eklenir:
{
"#css/simple-admin": {
"flags": ["@css/generic", "@css/reservation", "@css/ban", "@css/slay"]
}
}Güncellemeler eklentileri bozabilir

CS2 sunucularında eklenti kullanmanın en önemli dezavantajı güncelleme hassasiyetidir:
- gameinfo.gi sıfırlanabilir: AlliedModders wiki'sine göre geliştiricinin gameinfo.gi'yi değiştiren bir güncellemesinden sonra Metamod satırını yeniden eklemeniz gerekir. Güncellemeden sonra
meta version"Unknown Command" diyorsa ilk kontrol edeceğiniz yer burasıdır. - Metamod ve CounterStrikeSharp sürümleri: Büyük bir CS2 güncellemesinden sonra bu araçların yeni sürümleri gerekebilir. CounterStrikeSharp'ı güncellemek için belgelere göre yeni sürümü indirip ilk kurulumdaki gibi kopyalamanız yeterlidir; config dosyalarınızın üzerine yazılmaz. Daha önce with-runtime kurduysanız runtime'sız paketi kullanabilirsiniz, ancak o zaman .NET runtime'ın güncel olmasından siz sorumlusunuz.
- Eklentiler: Tek tek eklentiler de oyunun değişen iç yapısı nedeniyle çalışmayı bırakabilir. Eklenti geliştiricisinin güncellemesini bekleyin; kritik eklentileri güncellemeden sonra test etmeden sunucuyu açmayın.
- Yedek alın: Güncellemeden önce
addonsklasörünüzü ve config dosyalarınızı yedekleyin. Linux'ta bunun için rsync rehberimize bakabilirsiniz.
Valve kuralları: GSLT yasağına yol açan eklentiler
Eklenti seçerken Valve'ın kurallarını mutlaka bilin. Steam Destek'in "CS2 - GSLT Bans" sayfasına göre GSLT yasakları, oyunculara sahte envanter veya profil sunan sunucu operatörlerine verilir. Valve'ın topluluk sunucularında kapatılmasını istediği hizmetler:
- Oyuncuların envanterinde olmayan CS2 eşyalarını (silah kaplamaları, bıçaklar vb.) geçici olarak sahiplenmesini sağlayan hizmetler.
- Sahte rekabetçi rütbe, profil seviyesi veya skor tablosu madalyası (Operation Challenge Coin) gösteren hizmetler.
- Oyuncunun kendi CS2 envanterine, eşyalarına veya profiline doğru şekilde erişmesini engelleyen hizmetler.
Aynı sayfa, "vanilla" Karambit veya Bayonet gibi özel bıçak vermenin de, kaplamayı yalnızca silahı kullanan oyuncuya göstermenin de yasak olduğunu açıkça belirtiyor. Silah seçim menüsüyle standart birincil, ikincil silah ve bomba vermek ise serbest. GSLT yasağı, sunucu sahibinin hesabına kalıcı sunucu işletme yasağı ile birlikte maç arama ve takas kısıtlaması getirir ve Steam Destek tarafından kaldırılmaz.
Pterodactyl panelde eklenti kurulumu
Pterodactyl gibi bir panelde Metamod ve CounterStrikeSharp dosyalarını dosya yöneticisinden veya SFTP ile game/csgo/addons klasörüne yüklersiniz; gameinfo.gi düzenlemesini de dosya yöneticisinin metin düzenleyicisiyle yapabilirsiniz. Bazı CS2 egg'leri sunucu her güncellendiğinde gameinfo.gi'ye Metamod satırını otomatik eklemek gibi kolaylıklar sunabilir; bu tamamen kullandığınız egg'e bağlıdır, Startup sekmesinden kontrol edin. Panelin genel kullanımı için Pterodactyl rehberimize bakın.
Sık Sorulan Sorular
CS2'de SourceMod kullanabilir miyim?
Bu rehberdeki resmî kaynaklar CS2 için Metamod:Source 2.x ve CounterStrikeSharp kurulumunu anlatıyor. SourceMod'un CS2 desteğinin güncel durumu için AlliedModders'ın kendi duyurularını kontrol edin.
meta list yazınca Unknown Command alıyorum, neden?
Metamod yüklenmemiş demektir. addons klasörünün game/csgo/ altında olduğunu, gameinfo.gi'yi csgo klasöründe düzenlediğinizi ve Metamod satırının Game girdilerinin başında olduğunu kontrol edin. Bir CS2 güncellemesi gameinfo.gi'yi sıfırlamış olabilir.
CounterStrikeSharp kurulu ama eklentiler çalışmıyor?
İlk kurulumda with-runtime paketini kullandığınızdan emin olun. Windows'ta Visual C++ Redistributable, Linux'ta libicu paketinin kurulu olduğunu kontrol edin. Ardından sunucu konsolundaki hata mesajlarını okuyun.
Skin veya bıçak eklentisi kurmak güvenli mi?
Hayır. Steam Destek'e göre oyunculara sahip olmadıkları kaplamaları veya bıçakları veren eklentiler GSLT yasağına yol açabilir ve bu yasak kaldırılmaz.
Oyun ve yazılım adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen geliştiricilerle ortaklık ilişkisi bulunduğu anlamına gelmez.
İlgili içerikler: CS2 sunucu kurulumu · CS2 sunucu ayarları ve oyun modları · Pterodactyl ile oyun sunucusu yönetimi · rsync ile yedekleme