Kurulum rehberi

CS2 Eklenti Kurulumu ve Yönetimi Rehberi

Sunucunuzda Metamod ve CounterStrikeSharp kuruluysa artık asıl eğlenceli kısma geldiniz: eklentileri kurmak, yönetmek ve sunucuyu istediğiniz gibi şekillendirmek. Bu yazıda bir eklentiyi nasıl kuracağınızı, admin yetkilerini nasıl tanımlayacağınızı, eklentileri sunucuyu kapatmadan nasıl açıp kapatacağınızı ve işler ters gittiğinde nereye bakacağınızı anlatıyoruz.

Panel ile kur Adım özetine git

Bu rehberde neler var?

Ön koşul: Metamod:Source ve CounterStrikeSharp kurulu ve aktif olmalıdır.
CSS eklentileri addons/counterstrikesharp/plugins/ altında, her biri kendi alt klasöründe durur.
Doğrulama komutu: css_plugins list. İlk yüklemede config genelde configs/plugins/ altında oluşur.
Sunucu kapatmadan yönetim: css_plugins load, unload ve reload.
Admin yetkileri tek yerde tutulur: configs/admins.json (ve isteğe bağlı admin_groups.json).
Birden fazla eklentiyi tek tek kurup doğrulamak, sorun ayıklamayı kolaylaştırır.

Önce birkaç kavramı netleştirelim

CS2 tarafında iki tür eklenti vardır. Bu rehber ağırlıklı olarak CounterStrikeSharp eklentileri üzerinedir; piyasadaki eklentilerin büyük çoğunluğu bu şekilde dağıtılır.

Metamod eklentileri

Doğrudan game/csgo/addons/metamod/ altına kurulur
C++ ile yazılmış, daha düşük seviyeli
Örnek: CS2Fixes

CounterStrikeSharp (CSS) eklentileri

addons/counterstrikesharp/plugins/ altına kurulur
C# ile yazılmış; admin, oyun modu, istatistik vb.
Karşınıza en çok çıkan tür budur

Bir eklenti nasıl kurulur?

İndirdiğiniz eklentinin dosyalarını (genelde bir .dll ve varsa yanındaki bağımlılıklar) şu klasöre kopyalayın:

Her eklenti kendi klasöründe durmalıdır. Dosyaları düz şekilde plugins/ içine atmak yerine önce eklenti adıyla bir alt klasör oluşturup dosyaları oraya koyun. Çoğu eklenti zaten bu yapıyla gelir; siz yalnızca plugins içine olduğu gibi bırakırsınız.

Sunucuyu yeniden başlatın
Konsolda css_plugins list ile eklentinin listede göründüğünü kontrol edin
İlk yüklemede config genelde configs/plugins/EklentiAdi/ altında otomatik oluşur; ihtiyaca göre düzenleyin

Hedef klasör

game/csgo/addons/counterstrikesharp/plugins/

Örnek klasör yapısı

plugins/
└── MatchZy/
    ├── MatchZy.dll
    ├── MatchZy.deps.json
    └── (varsa diğer bağımlılık dosyaları)

Doğrulama komutu

css_plugins list

Sunucuyu kapatmadan eklenti yönetimi

CounterStrikeSharp’ın pratik taraflarından biri, sunucuyu her seferinde yeniden başlatmadan eklenti yönetebilmenizdir. Konsolda işinize yarayacak komutlar:

Geçici olarak devre dışı bırakmak isterseniz dosyayı silmek yerine plugins altında bir disabled klasörü oluşturup oraya taşıyabilirsiniz. İhtiyaç olunca css_plugins load ile tekrar çağırırsınız.

css_plugins komutları
Komut	Ne işe yarar
`css_plugins list`	Şu an yüklü tüm eklentileri listeler
`css_plugins load <dosya_adı>`	Belirtilen eklentiyi yükler (dosya adını kullanır)
`css_plugins unload <eklenti_adı>`	Eklentiyi kapatır (kod içindeki asıl isim; dosya adı değil)
`css_plugins reload <eklenti_adı>`	Kapatıp tekrar yükler; config değişikliklerinden sonra işe yarar

Admin yetkilerini tanımlama

Eklentilerin çoğu (özellikle admin komutları içerenler) kimin admin olduğunu bilmek zorundadır. Bu ayar CounterStrikeSharp’ın kendi admin sisteminde tutulur; tek tek her eklentide ayrı ayrı değil.

Sonra admins.json içinde ilgili admine "groups": ["#moderator"] ekleyin. Değişiklik sonrası sunucuyu yeniden başlatmak zorunda değilsiniz: css_plugins reload veya changelevel ile uygulayabilirsiniz; bazı eklentiler admin listesini haritaya girişte yeniden okur.

addons/counterstrikesharp/configs/admins.json dosyasını açın
İlk kurulumda admins.example.json varsa kopyalayıp adını admins.json yapın
SteamID64 (veya STEAM_0: formatı) ile bir kayıt ekleyin

admins.json örneğiadmins.json

{
  "OyuncuAdiniz": {
    "identity": "76561198XXXXXXXXX",
    "flags": ["@css/generic", "@css/kick", "@css/ban"],
    "immunity": 100
  }
}

Alanlar ne anlama gelir?

identity: SteamID64 ya da STEAM_0: formatındaki kimlik
flags: yetkiler; hepsi @ ile başlamalı, yoksa sistem tanımaz
immunity: sayı; düşük immünite, daha yüksek değere komut çalıştıramaz (örneğin kickleyemez)

Sık kullanılan bayraklar

@css/generic (genel admin), @css/kick, @css/ban, @css/slay, @css/changemap. Bir eklenti kendine özel bayrak da tanımlayabilir (@eklentiadi/ozelyetki gibi); bunları eklentinin dokümantasyonunda bulursunuz.

Gruplarla toplu yetki

Birden fazla admini aynı yetkilerle tanımlamak için configs/admin_groups.json içinde grup tanımlayıp admini o gruba ekleyebilirsiniz. Grup isimleri # ile başlamalıdır.

admin_groups.json örneğiadmin_groups.json

{
  "#moderator": {
    "flags": ["@css/generic", "@css/kick", "@css/ban"],
    "immunity": 50
  }
}

Eklentiyi güncellemek

Yeni sürüm çıktığında genelde yapmanız gereken dosyaları üzerine kopyalamaktır. Config dosyalarınız ayrı klasörde (configs/plugins/) tutulduğu için .dll değiştirmek ayarlarınızı silmez. Yine de büyük güncelleme öncesi config klasörünü yedeklemekte fayda vardır; bazı eklentiler yeni sürümde config yapısını değiştirebilir.

Eklenti kaldırma

Bir eklentiyi tamamen kaldırmak istiyorsanız:

Önce css_plugins unload <eklenti_adı> ile çalışmasını durdurun
plugins/ altındaki ilgili alt klasörü silin
İsterseniz configs/plugins/ altındaki config klasörünü de silin (ileride tekrar kuracaksanız bırakın; ayarlar korunur)

Sık karşılaşılan sorunlar

En sık görülen durumlar ve ilk kontrol noktaları:

Eklenti css_plugins list içinde görünmüyor

Klasör yapısını kontrol edin: dosyalar doğrudan plugins/ içine değil, kendi alt klasörüne konmalıdır. Ayrıca eklentinin CounterStrikeSharp sürümüyle uyumuna bakın; çok eski veya çok yeni bir eklenti sürüm uyuşmazlığından yüklenmeyebilir.

Admin komutları çalışmıyor

admins.json içindeki SteamID formatını doğrulayın. Dosya adının gerçekten admins.json olduğunu, hâlâ admins.example.json olarak durmadığını kontrol edin.

Eklenti sunucu açılışında hata veriyor

Sunucu loglarına bakın. Genelde eksik bir bağımlılık .dll dosyası veya CounterStrikeSharp API sürümünün eklentinin istediği minimumun altında kalması yüzündendir. Hem CounterStrikeSharp’ı hem eklentiyi güncellemek çoğu zaman çözer.

Bir güncelleme sonrası her şey bozuldu

CS2’nin büyük güncellemeleri bazen gameinfo.gi dosyasını sıfırlar; bu da Metamod’u (dolayısıyla üzerindeki her şeyi) durdurur. İlk bakılacak yer burasıdır: Metamod satırının hâlâ yerinde olup olmadığını kontrol edin. Ayrıntı için Metamod kurulumu rehberine bakın.

Son olarak

Birden fazla eklenti kuracaksanız hepsini aynı anda eklemek yerine tek tek kurup her birinin düzgün çalıştığını doğruladıktan sonra bir sonrakine geçin. Sorun çıktığında hangi eklentinin sebep olduğunu bulmak, on eklentiyi birden kurup sonra tek tek kapatmaktan çok daha kolaydır.

CS2 eklentileri: hazır eklenti kataloğu
CounterStrikeSharp kurulumu: çatı katmanı
Metamod kurulumu: temel katman
CS2 sunucu kurma: sunucu henüz yoksa pillar rehber

Adım adım

CS2 eklenti kurulum adımları

CounterStrikeSharp eklentisini plugins klasörüne kurup css_plugins list ile doğrulamak için özet adımlar.

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

01
Altyapıyı doğrulayın
Metamod:Source ve CounterStrikeSharp kurulu ve aktif olsun.
02
Eklentiyi plugins altına koyun
Dosyaları game/csgo/addons/counterstrikesharp/plugins/ içinde eklenti adına ait alt klasöre kopyalayın.
03
Yeniden başlatın veya load edin
Sunucuyu yeniden başlatın ya da css_plugins load ile yükleyin.
04
css_plugins list ile doğrulayın
Eklenti listede görünmeli. Config oluşursa configs/plugins/ altında düzenleyin.
05
Gerekirse admin tanımlayın
Admin komutları için configs/admins.json dosyasına SteamID ve @ bayraklarını ekleyin.

Sık sorulan sorular

CS2 eklentileri için hangi altyapı gerekir?

Çoğu eklenti önce Metamod:Source, ardından CounterStrikeSharp ister. Bu iki katman yoksa eklentiler genelde yüklenmez.

Eklentiler nereye yüklenir?

CounterStrikeSharp eklentileri game/csgo/addons/counterstrikesharp/plugins/ altına, her eklenti kendi alt klasöründe. Sonra css_plugins list ile doğrulayın.

Sunucuyu kapatmadan eklenti açıp kapatabilir miyim?

Evet. css_plugins load, unload ve reload komutlarını kullanın. load dosya adı ister; unload/reload eklentinin asıl ismini ister.

Admin yetkilerini nereye yazarım?

addons/counterstrikesharp/configs/admins.json dosyasına. flags @ ile başlamalıdır. Ortak yetkiler için admin_groups.json ve # ile başlayan grup isimleri kullanılır.

Birden fazla eklentiyi aynı anda kurabilir miyim?

Kurabilirsiniz ama önerilmez. Tek tek kurup test etmek, sorun çıktığında sorumlu eklentiyi bulmayı kolaylaştırır.

Eklenti listede görünmüyor, neden?

Çoğunlukla dosyalar yanlış dizindedir (alt klasör yok), CounterStrikeSharp sürümü uyumsuzdur veya bağımlılık .dll eksiktir. Klasör yapısı ve logları kontrol edin.

Güncelleme sonrası her şey bozulduysa ne yapmalıyım?

Önce gameinfo.gi içindeki Metamod satırını kontrol edin; Valve büyük güncellemelerde sıfırlayabilir. Sonra CounterStrikeSharp ve eklenti sürümlerini güncelleyin.

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