Loglama ve Discord
CXA Anticheat her tespiti, banı ve yetkili işlemini en fazla üç yere yazar: webhooklar üzerinden Discord kanallarına, web panelindeki Tespitler sekmesine ve sunucu konsoluna. Bu sayfa her yeri, farklı logları farklı Discord kanallarına nasıl göndereceğini ve webhook adreslerini nasıl gizli tutacağını anlatır.
Webhook Adreslerine Şifre Gibi Davran
Bir webhook adresine sahip olan herkes o Discord kanalına mesaj gönderebilir. Webhookları panelde veya sv_config.lua içinde tut; oyuncuların okuyabildiği config.lua dosyasına asla koyma.
Nasıl Çalışır
- Bir tespit tetiklenir ya da bir yetkili birini banlar, atar veya banını kaldırır.
- Konsol açıksa sunucu konsoluna bir satır yazılır.
- Panel logları açıksa tespitler ve banlar paneldeki Tespitler sekmesine gönderilir.
- Discord webhookları açıksa ilgili Discord kanalı için bir mesaj sıraya alınır. Kanal cezaya göre seçilir:
banBans'a,kickKicks'e,warnWarns'a,logise tespitin log kanalına gider; bu genelde Detections'tır. - Kuyruk her Webhook aralığında bir Discord mesajı gönderir; böylece Discord'un istek sınırına (rate limit, Discord'un saniyede kabul ettiği mesaj sayısı) takılmazsın.
none cezası sadece işlemi engeller. Hiçbir yere loglanmaz.
Tespitler Sekmesi
Panelde lisansını aç ve Tespitler sekmesine git. Anticheat'in sunucunda bulduklarını gösterir.
- Üstteki kartlar Son 24 saat içindeki kayıtları, bunların içinden de Banlar, Kickler ve Loglanan kayıtları sayar.
- Oyuncu, tespit veya ban ID ara kutusuyla arama yap.
- Cezaya göre filtrele: Tüm cezalar, Ban, Kick, Uyarı veya Log.
- Yenile düğmesi en yeni kayıtları yükler.
- Tabloda Zaman, Oyuncu, Tespit, Ceza ve Ban ID sütunları vardır. Tespitin Detaylar kısmını ve oyuncunun Identifierlar listesini (
license,discord,steam,fivem) görmek için bir satıra tıkla. - Daha fazla yükle sonraki 50 kaydı gösterir.
Kayıtlar 30 gün saklanır. Sekme, Yapılandırma → Loglar → Panel logları açıkken ve sunucun çalışırken dolar. Web panelinden, oyun içi panelden veya BanPlayer export'u ile attığın banlar da burada görünür.
Kaydedilen yapılandırmalar, görüntülenen webhooklar ve panel işlemleri gibi ekibinin yaptığı değişiklikler ise İşlem kaydı sekmesinde listelenir. Bkz. Ekip Erişimi.
Discord Kanalları
| Kanal | Oraya ne gönderilir |
|---|---|
| Default | Boş bıraktığın her kanal için yedek. |
| Bans | Her yeni ban: tespitlerden gelen otomatik banlar, manuel banlar ve scriptlerinden gelen banlar. |
| Kicks | Tespitlerden gelen otomatik kickler. |
| Warns | warn cezalı tespitler (oyuncu bir uyarı görür ve sunucuda kalır). |
| Detections | Kendi kanalı olmayan log cezalı tespitler ve FlagPlayer export'undan gelen işaretlemeler. |
| Explosions | log cezalı patlama tespitleri. |
| Entities | log cezalı entity blacklist ve entity spam tespitleri. |
| Connections | Engellenen oyuncu adları, girmeye çalışan banlı oyuncular, çift hesaplar, VPN engellemeleri, global ban ve hesap güveni sonuçları ve Kural Motoru'ndaki giriş kuralları. |
| DevTools | log cezalı NUI devtools tespitleri. |
| Chat | log cezalı chat filtresi tespitleri. |
| Admin | Yetkili işlemleri: komutlarla atılan manuel banlar, ban kaldırmalar, manuel kickler, oyun içi panel işlemleri, Event Guard ekleme ve kaldırma, sunucu sağlığı uyarıları. |
| Screenshots | Ekran görüntüsü komutu, oyun içi panel veya web paneliyle alınan ekran görüntüleri. |
Bir kanal boşsa mesajları Default'a gider. Default da boşsa mesaj gönderilmez. En basit kurulum tek bir Default webhook'tur. Bir kanal çok kalabalıklaşınca diğer kanalları sonradan ekle.
Tespit Başına Log Kanalı
Log kanalı sadece tespitin cezası log olduğunda kullanılır. Banlar, kickler ve uyarılar her zaman Bans, Kicks ve Warns kanallarına gider.
Çoğu tespit Detections'a loglar. Bazılarının varsayılan olarak kendi kanalı vardır: patlamalar Explosions'a, entity blacklist ve entity spam Entities'e, chat filtresi Chat'e ve NUI devtools DevTools'a. NUI devtools için kanalı panelde Yapılandırma → Client tespitleri → NUI devtools → Log kanalı altından seçebilirsin.
Webhookları Kurmak
Adım 1 — Webhookları Discord'da Oluştur
Discord sunucunda logları alacak kanalın ayarlarını aç, Entegrasyonlar → Webhooklar bölümüne git, bir webhook oluştur ve adresini kopyala. Kullanmak istediğin her kanal için bunu tekrarla.
Adım 2 — Panele Ekle
- Lisansını aç ve Webhook & anahtarlar sekmesine git.
- Her adresi Discord webhookları altında kendi kanalına yapıştır. Her kanalın yanındaki açıklama o kanalın ne aldığını söyler.
- Webhook ve anahtarları kaydet düğmesine bas.
Panel Kaydedildi. Sunucun bir sonraki senkronizasyonda alır. yazar ve sunucun webhookları bir dakika içinde alır. Adresler https://discord.com/api/webhooks/... gibi Discord webhook adresleri olmalı; değilse alanda Geçerli bir Discord webhook adresi değil. yazar.
Kaydedilen webhooklar ve anahtarlar gizlenir. Birini tekrar görmek için alanındaki göz simgesine bas. Görüntüleme, İşlem kaydı'na Webhook / anahtarlar görüntülendi olarak yazılır. Bu sekmeyi sadece lisansın sahibi ve adminleri açabilir, bkz. Ekip Erişimi.
Adım 3 (Opsiyonel) — Bunun Yerine sv_config.lua Kullan
Webhookları resource klasöründeki, sadece sunucuda kalan sv_config.lua dosyasına da yazabilirsin. Default'a düşmesi için bir kanalı boş ('') bırak.
SvConfig.Webhooks = {
Default = 'https://discord.com/api/webhooks/123456789012345678/xxxxxxxx', -- Boş her kanal için kullanılır
Bans = '', -- Otomatik ve manuel banlar
Kicks = '', -- Otomatik kickler
Warns = '', -- Oyunculara gösterilen uyarılar
Detections = '', -- Sadece log tespitler
Explosions = '', -- Patlama logları
Entities = '', -- Blacklist / spam entity logları
Connections = '', -- Çift hesap, yasaklı isim, VPN, banlı giriş denemeleri
DevTools = '', -- NUI devtools tespitleri
Chat = '', -- Blacklist chat mesajları
Admin = '', -- Yönetici komut kullanımı (ban, unban, kick, screenshot)
Screenshots = '', -- Ekran görüntüsü komutuyla alınan görüntüler
}Hangi Değer Geçerli Olur
İki yerin birlikte nasıl çalışacağına sv_config.lua içindeki SvConfig.License.UsePanelSecrets karar verir.
UsePanelSecrets = true(varsayılan): panelde doldurduğun her kanal,sv_config.luaiçindeki aynı kanalın yerine geçer. Panelde boş bıraktığın kanallarsv_config.luadeğerini korur. Sonra boş kanallar Default'a düşer.UsePanelSecrets = false: paneldeki webhooklar ve anahtarlar yok sayılır, sadecesv_config.luakullanılır.
sv_config.lua içinde hâlâ bir adres varsa, kanalı panelde temizlemek onu sunucuda temizlemez. İki yerden de kaldır.
Ban Etiketi ve API Anahtarları
Webhook & anahtarlar sekmesindeki API anahtarları kartı diğer gizli bilgileri tutar.
| Alan | sv_config.lua anahtarı | Ne yapar |
|---|---|---|
| Ban log etiketi | SvConfig.BanMention | Tespitlerden gelen otomatik banların Bans kanalı mesajına eklenen metin, örneğin <@&ROLE_ID> veya @here. En fazla 64 karakter. |
| Steam Web API key | SvConfig.SteamApiKey | Loglarda Steam adlarını ve avatarlarını gösterir. Panele kaydedilen anahtar Hesap Güveni içindeki Steam hesap yaşı için de kullanılır. Steam anahtarları 32 karakterdir. |
| Fivemanage API key | SvConfig.Fivemanage.ApiKey | Ekran görüntüleri Fivemanage'de saklanıyorsa kullanılır. Bkz. Ekran Görüntülerini Fivemanage'de Saklamak. |
| VPN sağlayıcı ve VPN API anahtarı | SvConfig.Vpn | Giriş Taraması içindeki VPN kontrolü tarafından kullanılır. |
Log Ayarları
Bunları panelde Yapılandırma → Loglar altında değiştir.
| Seçenek | Anahtar | Varsayılan | Ne yapar |
|---|---|---|---|
| Discord webhookları | Logs.Discord | true | Logları Discord'a gönderir. |
| Panel logları | Logs.Panel | true | Tespitleri Tespitler sekmesine gönderir. |
| Konsol | Logs.Console | true | Tespitleri sunucu konsoluna yazar. |
| Bot adı | Logs.BotName | CXA Anticheat | Discord'daki webhook mesajlarının adı. |
| Avatar URL | Logs.AvatarUrl | yerleşik görsel | Webhook mesajlarının resmi. |
| IP'leri göster | Logs.ShowIp | false | Oyuncunun IP adresini Discord loglarına ekler. Gizlilik açısından hassas. |
| Donanım tokenlarını göster | Logs.ShowTokens | false | Oyuncunun ilk üç donanım tokenını Discord loglarına ekler. |
| Steam profili | Logs.UseSteamProfile | true | Steam adını ve avatarını gösterir. Steam Web API key gerekir. |
| Webhook aralığı | Logs.QueueInterval | 1200 ms | İki Discord mesajı arasındaki bekleme (250 ile 10000 arası). |
| Maks kuyruk | Logs.MaxQueueSize | 200 | Discord'a gönderilmeyi bekleyen mesajlar. Dolunca en eskileri silinir. [PERF] |
| Tespit bekleme süresi | Logs.DetectionCooldown | 10 sn | Aynı oyuncunun aynı tespitten bu süre içinde tekrar gelen log ve warn kayıtları atlanır. |
Embed renkleri altında her Discord mesajının sol çubuğunun rengini ondalık renk numarası olarak ayarlarsın.
| Renk | Anahtar | Varsayılan | Kullanıldığı yer |
|---|---|---|---|
| Ban | Logs.Colors.Ban | 15158332 (kırmızı) | Banlar ve banlı giriş denemeleri |
| Kick | Logs.Colors.Kick | 15105570 (turuncu) | Kickler, uyarılar, engellenen bağlantılar, sunucu sağlığı uyarıları |
| Log | Logs.Colors.Log | 3447003 (mavi) | Sadece log tespitler |
| Info | Logs.Colors.Info | 6749952 (yeşil) | Ekran görüntüleri |
| Admin | Logs.Colors.Admin | 10181046 (mor) | Yetkili işlemleri |
Bir Discord Logunda Neler Olur
Bir oyuncu logu oyuncunun adını ve sunucu ID'sini, framework'ün veriyorsa karakter adını, tespiti, cezayı, banlarda ban ID'si ile bitiş tarihini ve tespitin detaylarını gösterir. Identifierlar alanında license, license2, discord (etiket olarak), steam (profil bağlantısıyla), fivem, xbl ve live listelenir. IP ve donanım tokenları sadece sen açarsan eklenir. Ekran görüntüsü açık olan tespitler görüntüyü mesaja ekler.
Konsol Satırları
Her tespit, oyuncuyu, tespiti, cezayı ve detayları içeren tek bir satır yazar:
[CXA] John (ID: 12) -> Blacklisted weapon [ban] weapon: WEAPON_RAILGUNWebhookları Gizli Tutmak
- Webhookları panelde veya
sv_config.luaiçinde sakla. İkisi de sunucuda kalır ve oyunculara asla gönderilmez. - Webhook & anahtarlar sekmesini sadece ihtiyacı olanlara ver. Sekmeyi sadece sahip ve adminler açabilir ve her görüntüleme İşlem kaydı'na yazılır.
- Webhook & anahtarlar sekmesinde açılmış bir alanın veya
sv_config.luadosyasının ekran görüntüsünü asla paylaşma. - Bir webhook adresi sızarsa webhook'u Discord'da sil, yenisini oluştur ve yeni adresi kaydet.
Öneriler
Önerilir:
- Tek bir Default webhook ile başla, sonra Bans, Connections ve Admin'i kendi kanallarına ayır.
- Admin kanalını sadece yönetime açık tut. Her yetkili işlemini gösterir.
- Yetkililerinin Discord'da gerçekten IP görmesi gerekmiyorsa IP'leri göster kapalı kalsın.
- Loglarında Steam adları ve avatarları görünsün diye bir Steam Web API key ekle.
Kaçın:
- Webhookları
config.luadosyasına veya herkese açık destek kanallarına yapıştırmaktan. - Webhook aralığını çok düşük ayarlamaktan. Discord mesajları reddeder ve loglar geç gelir.
- Bir tespiti hâlâ denerken
nonekullanmaktan. Yakaladığı hiçbir şeyi görmezsin.
İlgili Özellikler
Ekran Görüntüleri
- Ekran görüntüsü açık olan tespitler Discord mesajlarına bir görüntü ekler. Ekran görüntüsü komutları Screenshots kanalına gönderir.
- Bkz. Ekran Görüntüleri.
Sunucu Sağlığı
- Discord uyarıları açıkken sağlık uyarıları Admin kanalına gönderilir.
- Bkz. Sunucu Sağlığı.
Ekip Erişimi
- Webhookları sahip ve adminler görebilir ve düzenleyebilir. Her görüntüleme ve değişiklik İşlem kaydı'na yazılır.
- Bkz. Ekip Erişimi.
Tespitler ve Cezalar
- Bir tespitin cezası, logun hangi kanala gideceğini belirler.
- Bkz. Tespitler ve Cezalar.
Sınırlamalar
- Panelde log kanalı seçilebilen tek tespit NUI devtools'tur. Diğer tespitler yukarıda listelenen kanalları kullanır.
- Tespit yağmuru sırasında Maks kuyruk değerini aşan Discord mesajları silinir ve panel bazı kayıtları atlayabilir. Panel lisans başına saatte en fazla 3000 tespit kabul eder.
- Tespitler panelde 30 gün saklanır. Discord mesajları sen kanalı sakladığın sürece kalır.
Sık Karşılaşılan Sorunlar
Discord'a Hiçbir Şey Gelmiyor
Ne görürsün: Tespitler konsolda görünüyor ama Discord'a gelmiyor.
Nasıl düzeltilir:
- Yapılandırma → Loglar → Discord webhookları ayarının açık olduğundan emin ol.
- Webhook & anahtarlar sekmesinde en azından Default kanalını doldur ve kaydet.
- Webhookları hem
sv_config.luaiçinde hem panelde ayarladıysanUsePanelSecretsdeğerine ve hangi değerin geçerli olduğuna bak. sv_config.luadosyasını düzenledikten sonra sunucuyu yeniden başlat.
Loglar Yanlış Kanala Gidiyor
Ne görürsün: Örneğin patlama logları Default kanalında görünüyor.
Nasıl düzeltilir:
- Explosions kanalı boş olduğu için mesajlar Default'a düşüyor. Kanalı doldur.
- Patlama veya chat tespitlerinde bile banların her zaman Bans kanalına gittiğini unutma.
"Geçerli bir Discord webhook adresi değil."
Ne görürsün: Panel bir webhook'u kaydetmiyor.
Nasıl düzeltilir:
- Adresin tamamını Discord'dan kopyala.
https://discord.com/api/webhooks/ile başlar. - Adresin önündeki veya arkasındaki boşlukları ve metni sil.
Loglar Geç Geliyor veya Bazıları Eksik
Ne görürsün: Discord mesajları olaydan dakikalar sonra geliyor ya da birkaçı hiç gelmiyor.
Nasıl düzeltilir:
- Kalabalık bir sunucu kuyruğu doldurabilir. Gürültülü
logtespitleri için Tespit bekleme süresini artır veya ihtiyacın olmayan tespitlerinoneyap. - Logları daha fazla kanala böl.
- Webhook aralığını varsayılan
1200ms'de bırak.
Tespitler Sekmesinde "Henüz tespit yok" Yazıyor
Ne görürsün: Sunucu çalıştığı hâlde sekme boş kalıyor.
Nasıl düzeltilir:
- Yapılandırma → Loglar → Panel logları ayarını aç.
- Sunucunun Genel bakış sekmesinde çevrimiçi göründüğünü kontrol et.
- Bir dakika bekle. Tespitler panele toplu olarak gönderilir.
Steam Adları ve Avatarları Görünmüyor
Ne görürsün: Discord loglarında Steam adı veya avatarı görünmüyor.
Nasıl düzeltilir:
- Webhook & anahtarlar sekmesine (veya
SvConfig.SteamApiKey) bir Steam Web API key ekle. - Yapılandırma → Loglar → Steam profili ayarını aç.
- Logda oyuncu için bir
steam:identifier'ı listelendiğini kontrol et. Yoksa aranacak bir Steam profili de yoktur.
© 2026 CodeXart Studios · CXA Anticheat