18-11-2026, 18:15
CounterStrikeSharp Ders 6: Admin yetkisi gerektiren komutlar#1
Kısa özet: CounterStrikeSharp'ta komutu yalnızca adminlere açmak için [RequiresPermissions("@css/generic")] özniteliği kullanılır; yetkisiz oyuncu bilgilendirme mesajı alır. Adminler configs/admins.json içinde SteamID64 ve yetki etiketleriyle tanımlanır (@css/root, @css/generic, @css/kick, @css/ban, @css/slay, @css/changemap, @css/chat); kodda AdminManager.PlayerHasPermissions ile de kontrol edilebilir.
Yetki gerektiren komutlar
Bazı komutların yalnızca adminler tarafından kullanılması gerekir. CounterStrikeSharp bunu yetki etiketleriyle (permission) yapar; böylece komutları güvenle yetkililere açarsınız.
Yetki isteyen komut
KOD
using CounterStrikeSharp.API;
using CounterStrikeSharp.API.Core;
using CounterStrikeSharp.API.Core.Attributes.Registration;
using CounterStrikeSharp.API.Modules.Admin;
using CounterStrikeSharp.API.Modules.Commands;
[ConsoleCommand("css_hy_restart", "Maci yeniden baslatir")]
[RequiresPermissions("@css/generic")]
public void OnRestart(CCSPlayerController? oyuncu, CommandInfo komut)
{
Server.ExecuteCommand("mp_restartgame 1");
komut.ReplyToCommand("Mac yeniden baslatildi.");
}Yetkisi olmayan oyuncu komutu kullanamaz ve bilgilendirme mesajı alır.
Admin tanımlama
addons/counterstrikesharp/configs/admins.json:
KOD
{
"HepOyuncu Yonetici": {
"identity": "76561198000000000",
"flags": ["@css/root"]
}
}identity oyuncunun SteamID64 değeridir; yukarıdaki sayı yalnızca örnektir, kendi değerinizi yazın.
Yaygın yetki etiketleri
- @css/root: tüm yetkiler
- @css/generic: genel admin
- @css/kick, @css/ban, @css/slay, @css/changemap, @css/chat
Kodda elle kontrol
KOD
if (AdminManager.PlayerHasPermissions(oyuncu, "@css/ban")) { ... }Bir komutun içinde farklı seviyelerde farklı davranış istiyorsanız yetkiyi elle kontrol edin.
SteamID64 bulmak
SteamID64'ünüzü Steam profil adresinizden ya da oyun içinde status komutuyla öğrenebilirsiniz. Yetkileri minimum verin; root yetkisini yalnızca sunucu sahibi kullanmalı.
Sık yapılan hatalar
- Yetki özniteliğini unutmak.
- Herkese root yetkisi vermek.
- SteamID64 yerine başka kimlik yazmak.
- admins.json biçimini bozmak.
- Yetkisiz hesapla test etmemek.
Sık sorulan sorular
SteamID64 nedir? Steam hesabının 17 haneli numarasıdır.
root ne işe yarar? Tüm yetkileri verir.
Yetki nasıl denenir? Yetkili ve yetkisiz hesapla komutu çalıştırarak.
Örnek senaryo
css_hy_restart komutunu her oyuncu çalıştırabiliyordu. RequiresPermissions özniteliğini ekleyip admins.json içinde yetkili SteamID64'leri tanımlayınca yalnızca adminler çalıştırabiliyor ve diğerleri bilgilendirme mesajı alıyor.
Kontrol listesi
- Öznitelik eklendi mi?
- admins.json doğru mu?
- Yetkiler minimum mu?
- Yetkisiz hesapla denendi mi?
- root kısıtlı mı?
Ek ipucu
Yetki listesini bir tabloda (kim, hangi etiket, ne zaman eklendi) tutun; yetkili ayrıldığında hemen kaldırabilmeniz güvenlik için çok önemlidir. Değişiklikleri küçük adımlarla yapıp her adımdan sonra sonucu gözleyin, işe yarayan ayarı bir not dosyasına yazın ve çalışan son hâli yedekte tutun. Oyuncu ve yetkili geri bildirimlerini düzenli toplamak, hangi uygulamanın gerçekten işe yaradığını anlamanın en güvenilir yoludur.
Takıldığınız bir yer olursa bu konunun altına yazın; ekip ve topluluk yardımcı olur.
Test ve güvenlik
Yetkili komutları yazdıktan sonra iki hesapla test edin: biri yetkili, biri yetkisiz. Yetkisiz hesabın komutu çalıştıramadığını doğrulayın. admins.json dosyasındaki JSON biçiminin geçerli olduğundan emin olun; virgül ya da tırnak hatası tüm yetki listesinin yüklenmemesine yol açabilir. Dosyayı değiştirdikten sonra eklentileri ya da yetkileri yeniden yüklemeyi unutmayın ve değişiklikleri bir günlükte kaydedin.