Kurulum rehberi

CS2 CounterStrikeSharp Kurulumu: Eklenti Altyapısı Rehberi

Counter-Strike 2 sunucunuzda admin menüsü, retakes, deathmatch veya özel komutlar çalıştırmak istiyorsanız yolunuz CounterStrikeSharp’a çıkar. CS:GO’da bu iş SourceMod ile yapılıyordu; CS2 Source 2 motoruna geçtiği için SourceMod çalışmaz. Yerine CounterStrikeSharp (CSS / CSSharp) gelir. Bu rehberde sıfırdan kurup eklentileri çalışır hale getirene kadar her adımı anlatıyoruz.

Panel ile kur Adım özetine git

Bu rehberde neler var?

CounterStrikeSharp, C# eklentilerini çalıştıran bir framework’tür; tek başına değil Metamod üzerine kurulur.
Kurulum sırası sabittir: önce Metamod:Source, sonra CounterStrikeSharp, en sonda eklentiler.
İlk kurulumda mutlaka GitHub’daki with-runtime sürümünü indirin (.NET runtime dahildir).
Doğrulama: konsolda meta list çıktısında CounterStrikeSharp görünmelidir.
Eklentiler addons/counterstrikesharp/plugins/ klasörüne konur; güncellemede config’ler silinmez.

CounterStrikeSharp tam olarak nedir?

Kısaca: C# ile yazılmış CS2 sunucu eklentilerini çalıştırmanızı sağlayan bir çatı (framework). Geliştiriciler SourceMod’un Pawn dili yerine modern C# ile eklenti yazabilir; siz de GitHub’dan indirdiğiniz hazır eklentileri sunucuya takıp kullanabilirsiniz.

Tek başına çalışmaz; oyun motoruyla doğrudan konuşamaz. Bu yüzden önce Metamod:Source kurulu olmalıdır. CounterStrikeSharp onun üzerine oturur.

1. Metamod:Source
2. CounterStrikeSharp
3. İstediğiniz eklentiler (admin, RTV, retakes vb.)

Neye ihtiyacınız var?

Kuruluma başlamadan önce şunlar hazır olmalı:

Çalışan bir CS2 sunucusu (VDS, Dedicated, hosting veya yerel)
Sunucu dosyalarına erişim (FTP, dosya yöneticisi veya terminal)
Metamod:Source güncel dev build (metamodsource.net)
CounterStrikeSharp with-runtime sürümü (GitHub Releases)

GitHub’dan doğru dosyayı nasıl indirirsiniz?

CounterStrikeSharp GitHub deposundaki Releases sayfasında en üstte güncel sürüm çıkar. Listede birden fazla dosya görürsünüz:

Özet kural: ilk kurulumda işletim sisteminiz ne olursa olsun with-runtime sürümünü indirin. Bu tek kural, “eklenti hiç yüklenmiyor” sorunlarının çoğunu önler.

İsimde with-runtime geçenler: ilk kurulum için zorunlu (Windows veya Linux fark etmez)
with-runtime yazmayanlar: daha küçük dosya; .NET’in sistemde kurulu olduğunu varsayar (genelde güncelleme için)
Dosya adında windows veya linux ibaresine göre işletim sisteminizi seçin

Adım 1: Metamod:Source’u kurun

CounterStrikeSharp’tan önce Metamod ayakta olmalıdır. Kısa özet:

metamodsource.net üzerinden Linux veya Windows için güncel dev build indirin
Arşivi açıp çıkan addons klasörünü sunucudaki game/csgo/ içine kopyalayın
game/csgo/gameinfo.gi dosyasını metin editörüyle açın
Game_LowViolence csgo_lv satırının hemen altına Metamod satırını ekleyin
Sunucuyu yeniden başlatıp konsola meta list yazın

gameinfo.gi içine eklenecek satır

Game csgo/addons/metamod

Adım 2: CounterStrikeSharp’ı kurun

Metamod ayaktaysa geri kalanı kolaydır:

Bu satırı gördüyseniz CounterStrikeSharp sunucunuzda çalışıyor demektir.

GitHub Releases’tan with-runtime dosyasını indirin
Arşivi açıp içindeki addons klasörünü yine game/csgo/ içine kopyalayın (Metamod klasörüyle birleşir)
Sunucuyu yeniden başlatın
Konsola meta list yazın

Beklenen meta list çıktısı

Listing 1 plugin:
  [01] CounterStrikeSharp (x.x.x) by Roflmuffin

Klasör yapısı nasıl görünmeli?

Kurulum sonrası addons klasörünüz kabaca şöyle olmalı. Bir klasör eksikse kopyalama sırasında bir şey atlanmıştır; arşivi tekrar kontrol edin.

Beklenen addons yapısı

addons/
├── counterstrikesharp/
│   ├── api/
│   ├── bin/
│   ├── dotnet/
│   ├── plugins/
│   └── gamedata/
├── metamod/
│   ├── bin/
│   ├── counterstrikesharp.vdf
│   └── metaplugins.ini
├── metamod.vdf
└── metamod_x64.vdf

Windows ve Linux’ta dikkat edilecekler

İşletim sistemine göre ek bağımlılıklar gerekebilir. Bunlar atlanırsa eklenti sessizce yüklenmeyebilir.

Windows sunucular

CounterStrikeSharp için Visual C++ Redistributable (x64) kurulu olmalıdır. Yoksa Microsoft’un resmi vc_redist.x64.exe dosyasını indirip kurun. Bu adım atlanırsa hata mesajı bile görmeden yükleme başarısız olabilir.

Linux sunucular

Bazı dağıtımlarda .NET’in düzgün çalışması için libicu (bazen icu-libs veya libicu-dev) gerekir. meta list’te CounterStrikeSharp görünmüyorsa veya loglarda .NET hatası varsa ilk bakılacak yer burasıdır.

Ubuntu örneği

sudo apt update
sudo apt install -y libicu74 || sudo apt install -y libicu-dev

meta list boşsa ne yapmalıyım?

En sık karşılaşılan sorundur ve genelde üç sebepten biri yüzündendir:

Bu üçünü sırayla kontrol ettiğinizde sorun genelde çözülür.

Klasörler yanlış yerde: addons klasörü game/csgo/ içine gitmeli
gameinfo.gi düzenlenmemiş: Game csgo/addons/metamod satırı eksikse Metamod motora tanıtılmaz
.NET runtime eksik: with-runtime indirilmemiş veya Windows/Linux bağımlılıkları eksik

gameinfo.gi satırı (tekrar)

Game csgo/addons/metamod

Eklenti nasıl kurulur?

CounterStrikeSharp ayaktaysa eklenti kurmak basittir: indirdiğiniz eklentinin dosyalarını addons/counterstrikesharp/plugins/ klasörüne atın, sunucuyu yeniden başlatın veya konsoldan css_plugins load kullanın.

Eklentiye özel kurulum notu varsa (config düzenleme gibi) o eklentinin kendi açıklamasını okuyun. Hazır eklenti listesi için CS2 eklentileri ve kurulum mantığı için eklenti kurulumu sayfalarına bakın.

CounterStrikeSharp nasıl güncellenir?

CS2 sık güncellenir; bazen CounterStrikeSharp da bozulabilir. Güncellemek için en güncel sürümü indirip yine addons klasörünü kopyalamanız yeterlidir. Ayar (config) dosyalarınız üzerine yazılmaz.

İlk kurulumdan sonra .NET zaten yerinde olduğu için sade (with-runtime’sız) sürümle güncelleyebilirsiniz. Güncelleme sonrası sunucu ayağa kalkmıyorsa önce gameinfo.gi içindeki Metamod satırının hâlâ durduğunu kontrol edin; Valve büyük güncellemeleri bazen bu dosyayı sıfırlar.

Sonraki adımlar

CounterStrikeSharp aktif geliştirilen bir projedir; sürümler zamanla değişebilir. Takılırsanız resmi dokümantasyona (docs.cssharp.dev) bakın. Kurulum bir kez doğru yapıldıktan sonra asıl iş eklenti seçimine kalır.

Metamod kurulumu: temel katman
Eklenti kurulumu: plugin yerleştirme
CS2 eklentileri: hazır eklenti kataloğu
CS2 sunucu kurma: sunucu henüz yoksa pillar rehber

Adım adım

CS2 CounterStrikeSharp kurulum adımları

Metamod üzerine CounterStrikeSharp kurup C# eklentilerini çalıştırmak için özet adımlar.

Tahmini okuma: ~5 dakika · Uygulama süresi rehber adımlarına göre değişir

01
Metamod’u kurun ve doğrulayın
Metamod:Source’u game/csgo/addons altına koyun, gameinfo.gi satırını ekleyin, meta list ile kontrol edin.
02
with-runtime paketini indirin
GitHub Releases’tan işletim sisteminize uygun CounterStrikeSharp with-runtime arşivini alın.
03
addons klasörünü birleştirin
Arşivdeki addons içeriğini game/csgo/ altına kopyalayıp sunucuyu yeniden başlatın.
04
meta list ile doğrulayın
Çıktıda CounterStrikeSharp satırını görün. Yoksa klasör yolu, gameinfo.gi ve runtime bağımlılıklarını kontrol edin.
05
Eklenti ekleyin
Plugin dosyalarını addons/counterstrikesharp/plugins/ altına koyup yeniden yükleyin.

Sık sorulan sorular

CounterStrikeSharp için Metamod şart mı?

Evet. CounterStrikeSharp Metamod:Source üzerine kurulur ve onsuz çalışmaz. Önce Metamod’u kurup meta list ile doğrulayın.

with-runtime ne demek?

İlk kurulum paketinin içinde .NET runtime’ın da gelmesi demektir. with-runtime indirmezseniz ve sistemde .NET yoksa CounterStrikeSharp sessizce yüklenmez.

meta list’te CounterStrikeSharp görünmüyor, neden?

Çoğunlukla addons yanlış dizine konmuştur, gameinfo.gi’de Metamod satırı yoktur veya with-runtime / Visual C++ / libicu eksiktir. Bu üçünü sırayla kontrol edin.

SourceMod CS2’de çalışır mı?

Hayır. CS2 Source 2 motorundadır; CS:GO dönemi SourceMod eklentileri çalışmaz. Yerine CounterStrikeSharp kullanılır.

Eklentiler nereye konur?

addons/counterstrikesharp/plugins/ klasörüne. Sonra sunucuyu yeniden başlatın veya css_plugins load kullanın. Eklentiye özel config notlarını okuyun.

CS2 güncellemesi CounterStrikeSharp’ı bozar mı?

Bazen bozar. Güncel CSS sürümünü kopyalayın; gerekirse Metamod’u da güncelleyin. Valve büyük güncellemelerinde gameinfo.gi satırını yeniden eklemeniz gerekebilir.

Windows’ta ek ne kurmalıyım?

Visual C++ Redistributable x64. Yoksa CounterStrikeSharp hata göstermeden yüklenmeyebilir.

Kuruluma hazır mısınız?

Kendi VDS’inizi CS2SERVER.ORG.TR Panel’e bağlayın; SteamCMD, servis ve temel yönetimi yönlendirilmiş akışla tamamlayın.

Hizmet Paneline Git