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

  1. Bir tespit tetiklenir ya da bir yetkili birini banlar, atar veya banını kaldırır.
  2. Konsol açıksa sunucu konsoluna bir satır yazılır.
  3. Panel logları açıksa tespitler ve banlar paneldeki Tespitler sekmesine gönderilir.
  4. Discord webhookları açıksa ilgili Discord kanalı için bir mesaj sıraya alınır. Kanal cezaya göre seçilir: ban Bans'a, kick Kicks'e, warn Warns'a, log ise tespitin log kanalına gider; bu genelde Detections'tır.
  5. 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ı

KanalOraya ne gönderilir
DefaultBoş bıraktığın her kanal için yedek.
BansHer yeni ban: tespitlerden gelen otomatik banlar, manuel banlar ve scriptlerinden gelen banlar.
KicksTespitlerden gelen otomatik kickler.
Warnswarn cezalı tespitler (oyuncu bir uyarı görür ve sunucuda kalır).
DetectionsKendi kanalı olmayan log cezalı tespitler ve FlagPlayer export'undan gelen işaretlemeler.
Explosionslog cezalı patlama tespitleri.
Entitieslog cezalı entity blacklist ve entity spam tespitleri.
ConnectionsEngellenen 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ı.
DevToolslog cezalı NUI devtools tespitleri.
Chatlog cezalı chat filtresi tespitleri.
AdminYetkili 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ı.
ScreenshotsEkran 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

  1. Lisansını aç ve Webhook & anahtarlar sekmesine git.
  2. 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.
  3. 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.lua içindeki aynı kanalın yerine geçer. Panelde boş bıraktığın kanallar sv_config.lua değerini korur. Sonra boş kanallar Default'a düşer.
  • UsePanelSecrets = false: paneldeki webhooklar ve anahtarlar yok sayılır, sadece sv_config.lua kullanı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.

Alansv_config.lua anahtarıNe yapar
Ban log etiketiSvConfig.BanMentionTespitlerden gelen otomatik banların Bans kanalı mesajına eklenen metin, örneğin <@&ROLE_ID> veya @here. En fazla 64 karakter.
Steam Web API keySvConfig.SteamApiKeyLoglarda 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 keySvConfig.Fivemanage.ApiKeyEkran 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.VpnGiriş Taraması içindeki VPN kontrolü tarafından kullanılır.

Log Ayarları

Bunları panelde Yapılandırma → Loglar altında değiştir.

SeçenekAnahtarVarsayılanNe yapar
Discord webhooklarıLogs.DiscordtrueLogları Discord'a gönderir.
Panel loglarıLogs.PaneltrueTespitleri Tespitler sekmesine gönderir.
KonsolLogs.ConsoletrueTespitleri sunucu konsoluna yazar.
Bot adıLogs.BotNameCXA AnticheatDiscord'daki webhook mesajlarının adı.
Avatar URLLogs.AvatarUrlyerleşik görselWebhook mesajlarının resmi.
IP'leri gösterLogs.ShowIpfalseOyuncunun IP adresini Discord loglarına ekler. Gizlilik açısından hassas.
Donanım tokenlarını gösterLogs.ShowTokensfalseOyuncunun ilk üç donanım tokenını Discord loglarına ekler.
Steam profiliLogs.UseSteamProfiletrueSteam adını ve avatarını gösterir. Steam Web API key gerekir.
Webhook aralığıLogs.QueueInterval1200 msİki Discord mesajı arasındaki bekleme (250 ile 10000 arası).
Maks kuyrukLogs.MaxQueueSize200Discord'a gönderilmeyi bekleyen mesajlar. Dolunca en eskileri silinir. [PERF]
Tespit bekleme süresiLogs.DetectionCooldown10 snAynı 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.

RenkAnahtarVarsayılanKullanıldığı yer
BanLogs.Colors.Ban15158332 (kırmızı)Banlar ve banlı giriş denemeleri
KickLogs.Colors.Kick15105570 (turuncu)Kickler, uyarılar, engellenen bağlantılar, sunucu sağlığı uyarıları
LogLogs.Colors.Log3447003 (mavi)Sadece log tespitler
InfoLogs.Colors.Info6749952 (yeşil)Ekran görüntüleri
AdminLogs.Colors.Admin10181046 (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:

Output
[CXA] John (ID: 12) -> Blacklisted weapon [ban] weapon: WEAPON_RAILGUN

Webhookları Gizli Tutmak

  • Webhookları panelde veya sv_config.lua iç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.lua dosyası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.lua dosyası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 none kullanmaktan. 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

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.lua içinde hem panelde ayarladıysan UsePanelSecrets değerine ve hangi değerin geçerli olduğuna bak.
  • sv_config.lua dosyası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ü log tespitleri için Tespit bekleme süresini artır veya ihtiyacın olmayan tespitleri none yap.
  • Logları daha fazla kanala böl.
  • Webhook aralığını varsayılan 1200 ms'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