Ekran Görüntüleri

CXA bir oyuncunun oyun ekranının görüntüsünü alıp Discord'a gönderebilir; bir tespit tetiklendiğinde otomatik olarak ya da yetkililer istediğinde. Ekran görüntüleri banların için kanıt sağlar ve oyuncu şikayetlerini kontrol etmene yardım eder.

screenshot-basic Gerekir ve Varsayılan Olarak Kapalıdır

Ekran görüntüleri ücretsiz screenshot-basic resource'unu kullanır; bu resource sunucunda çalışıyor olmalı. Ayrıca Yapılandırma → Sistem → Ekran görüntüleri bölümünden açana kadar kapalıdırlar.

Gereksinimler

GereksinimNeden gerekli
screenshot-basic başlatılmışCXA görüntüyü bu resource'tan ister. server.cfg içinde ensure screenshot-basic satırını ensure cxa-anticheat satırının üstüne koy.
Ekran görüntüleri açıkConfig.Screenshot.Enabled varsayılan olarak false.
Discord webhooklarıEkran görüntüleri Discord'a gönderilir. İlgili kanal için webhook yoksa görüntü hiçbir yerde saklanmaz.

Nasıl Çalışır

Bir tespit tetiklendiğinde alınan otomatik görüntüler:

  1. Ekran görüntüsü açık olan bir tespit tetiklenir. Konsol satırı ve oyun içi yetkili uyarısı hemen çıkar.
  2. CXA, Format ve Kalite ayarlarınla screenshot-basic'ten oyuncunun oyununun görüntüsünü ister.
  3. CXA görüntü gelene kadar, en fazla Zaman aşımı kadar milisaniye bekler.
  4. CXA cezayı uygular. ban ve kick için oyuncu bu beklemeden sonra sunucudan çıkarılır.
  5. Görüntü o cezanın Discord loguna eklenir: Bans, Kicks veya Warns kanalı, log için de tespitin log kanalı.

Zaman aşımı içinde görüntü gelmezse ceza görüntüsüz uygulanır. Cezası none olan tespitler hiç log yazmadığı için ekran görüntüsü de almaz.

Yetkililerin cxascreenshot komutuyla, oyun içi panelle ya da web paneliyle aldığı manuel görüntüler Screenshots kanalına gönderilir.

[PERF] Sunucun her görüntüyü alır, çözer ve Discord'a yükler. Bu her görüntü için CPU zamanı ve bant genişliği demektir; özelliğin varsayılan olarak kapalı olmasının sebebi budur.

Kurulum

Adım 1 — screenshot-basic'i Başlat

screenshot-basic'i diğer resource'lar gibi kur ve CXA'dan önce başlat:

# Ekran görüntüleri (CXA ekran görüntüleri ve Canlı Ekranlar için gerekli)
ensure screenshot-basic

# CXA Anticheat ondan sonra
ensure cxa-anticheat

Adım 2 — Ekran Görüntülerini Aç

Web panelinde Yapılandırma → Sistem → Ekran görüntüleri bölümünü aç, grubu etkinleştir ve kaydet.

SeçenekAnahtarVarsayılanNe yapar
Ekran görüntüleriEnabledfalseTespitler ve yetkililer için ekran görüntülerini açar.
ResourceResource'screenshot-basic'Ekran görüntüsü resource'unun adı. Yalnızca screenshot-basic kopyanın klasör adı farklıysa değiştir.
FormatEncoding'jpg'Görüntü biçimi: jpg, png veya webp.
KaliteQuality0.60,1 ile 1,0 arası. Düşük değer daha küçük yükleme demektir.
Zaman aşımıTimeout6000 msGörüntüsüz ceza vermeden önce CXA'nın görüntüyü ne kadar bekleyeceği. Panel aralığı 1000-30000 ms.
Ekran görüntülerinin saklanacağı yerUpload'discord'discord görüntüyü Discord loguna ekler. fivemanage görüntüyü Fivemanage hesabına yükler ve onun yerine linkini gönderir. Bkz. Ekran Görüntülerini Fivemanage'de Saklamak.

Aynı varsayılanlar config.lua içinde:

Config.Screenshot = {
    Enabled = false,                         -- [PERF] Her görüntü sunucu tarafından çözülüp yüklenir (CPU + bant genişliği)
    Resource = 'screenshot-basic',
    Encoding = 'jpg',                        -- 'jpg', 'png' veya 'webp'
    Quality = 0.6,                           -- 0.1 - 1.0, düşük = daha küçük yükleme
    Timeout = 6000,                          -- Görüntüsüz ceza vermeden önce beklenecek süre (ms)
    Upload = 'discord',                      -- 'discord' veya 'fivemanage'
}

Adım 3 — Webhookları Ayarla

Webhook & anahtarlar → Discord webhookları bölümünü aç ve şunları doldur:

  • Screenshots: yetkililerin aldığı ekran görüntüleri için.
  • Bans, Kicks, Warns ve Detections: tespit loglarına eklenen otomatik görüntüler için.

Boş kalan her kanal Default'a düşer. Bunları sv_config.lua içindeki SvConfig.Webhooks ile de ayarlayabilirsin. Bkz. Loglama ve Discord.

Adım 4 — Tespitleri Seç

Bunu destekleyen her tespitin Yapılandırma sekmesinde kendi Ekran görüntüsü anahtarı vardır; yanında "Loga ekran görüntüsü ekler (screenshot-basic gerekir)." ipucu yazar. config.lua içinde bu, tespitin Screenshot = true satırıdır.

Şu tespitlerde Ekran görüntüsü varsayılan olarak açıktır:

TespitConfig yolu
Araç taşımaConfig.ClientDetections.VehicleCarry
Waypointe ışınlanmaConfig.ClientDetections.WaypointTeleport
Duvar arkası vurma (illegal RPF)Config.ClientDetections.WallShot
Aimbot (kafa oranı)Config.ServerDetections.Aimbot
Uzaktan yumruk (infinite punch)Config.ServerDetections.MeleeDistance
Tek yumruk (illegal RPF)Config.ServerDetections.OnePunch
Modifiyeli oyun dosyaları (illegal RPF)Config.GameFiles.Integrity
Hızlı şarjör, hızlı koşu, strafe boost (illegal RPF)Config.GameFiles.Timing

Bunlar ancak 2. adımı tamamladıktan sonra görüntü alır. Görüntünün karar vermene yardım edeceği tespitlerde anahtarı aç, örneğin noclip veya görünmezlik; sık tetiklenen tespitlerde kapalı bırak.

Elle Ekran Görüntüsü Almak

cxascreenshot

Bir oyuncunun ekran görüntüsünü alır ve Screenshots kanalına gönderir.

Kullanım:

Console
# Sunucu konsolunda
cxascreenshot 12

# Oyun sohbetinde
/cxascreenshot 12

Parametreler:

  • id (number): Oyuncunun sunucu ID'si

Ne olur:

  • CXA yetkini, oyuncunun çevrimiçi olduğunu ve ekran görüntülerinin kullanılabilir olduğunu kontrol eder.
  • Görüntüyü alır ve Ekran Görüntüsü başlığıyla, oyuncunun identifierları ve Yetkili alanında senin adınla (konsoldan Console) Screenshots kanalına gönderir.

Çıktı:

  • Başarılı olursa %s oyuncusunun ekran görüntüsü loglara gönderildi. (%s yerine oyuncunun adı).
  • Geçerli bir ID yoksa Kullanım: /cxascreenshot <id>.
  • O ID'de kimse yoksa Oyuncu bulunamadı.
  • Ekran görüntüleri kapalıysa veya resource çalışmıyorsa Ekran görüntüsü kapalı veya screenshot-basic başlatılmamış.
  • Zaman aşımı içinde görüntü gelmezse Ekran görüntüsü alınamadı.

Bu metinler dil ayarı Türkçe iken görünür; İngilizce'de örneğin Screenshot of <name> was sent to the logs. yazar. Varsayılan olarak sunucu konsolu ve owner, admin, moderator yetkili rolleri kullanabilir. Komutu Yapılandırma → Yetkili rolleri & komutlar bölümünden yeniden adlandır, sınırla ya da (adı boş bırakarak) kapat. Bkz. Konsol ve Sohbet Komutları.

Oyun İçi Panel

Oyun içi paneli /cxa ile aç, bir oyuncu seç ve Ekran görüntüsü'ne tıkla. Panel Ekran görüntüsü alınıyor… yazar, ardından görüntüyü bir pencerede açar. Aynı görüntü Screenshots kanalına da gönderilir ve işlem Admin kanalına Oyun içi panel işlemi olarak loglanır. Varsayılan olarak owner, admin ve moderator rolleri kullanabilir (Config.Permissions.Menu.Screenshot).

codexart.net Paneli

Web panelinde Oyuncular sekmesini aç ve çevrimiçi bir oyuncunun yanındaki kamera düğmesine tıkla ya da oyuncunun detayını açıp Görüntü'ye tıkla. Canlı harita sekmesinde bir oyuncu seçip Görüntü'ye tıklayabilirsin. Ekran görüntüsü al ile onayla.

Panel Sıraya alındı. Sunucun 30 saniye içinde uygular. yanıtını verir. Görüntü Screenshots kanalına gider, web panelinde gösterilmez. Sonuç Komutlar → Sonuçlar bölümünde görünür, örneğin sent_to_webhook, screenshot_unavailable, screenshot_failed veya player_offline. Bunu owner, admin veya editor rolündeki ekip üyeleri yapabilir; her istek İşlem kaydı sekmesine Ekran görüntüsü istendi olarak yazılır.

Ekran Görüntüleri Nereye Gider

Kim aldıDiscord kanalıBaşka nerede görünür
Ekran görüntüsü açık bir tespitO logun kanalı: Bans, Kicks, Warns veya tespitin log kanalıHiçbir yerde
cxascreenshotScreenshotsSohbette veya konsolda yanıt
Oyun içi panelScreenshotsOyun içi panel penceresinde
Web paneliScreenshotsKomutlar → Sonuçlar bölümünde sonuç

Ekran görüntüleri asla sunucuna kaydedilmez. Ekran görüntülerinin saklanacağı yer Discord webhook ise saklandıkları tek yer Discord'dur. Fivemanage seçiliyse Fivemanage hesabında saklanırlar: Discord logu görüntüyü Fivemanage linkinden gösterir, paneldeki Loglar sekmesinde tespit logları önizleme ve Ekran görüntüsünü aç linki gösterir, web panelinden alınan bir görüntü de oyuncunun Son panel işlemleri listesinde Ekran görüntüsünü aç olarak çıkar.

Ekran Görüntülerini Fivemanage'de Saklamak

Fivemanage, FiveM sunucuları için yapılmış bir medya barındırma servisidir. Ekran görüntülerini Discord dışında tutmak istediğinde kullan; örneğin daha uzun saklamak veya doğrudan panelden açmak için.

  1. Fivemanage'de bir hesap aç, panelindeki Tokens sayfasını aç ve bir API tokenı oluştur.
  2. Web panelinde Webhook & anahtarlar sekmesini aç, tokenı Fivemanage API key alanına yapıştır ve kaydet. İstersen bunun yerine sv_config.lua dosyasına da yazabilirsin:
SvConfig.Fivemanage = {
    ApiKey = '',
}
  1. Yapılandırma → Sistem → Ekran görüntüleri bölümünü aç, Ekran görüntülerinin saklanacağı yer seçeneğini Fivemanage yap ve kaydet.

Görüntüyü sunucunun kendisi yükler, bu yüzden token asla oyunculara gitmez. Fivemanage'e ulaşılamazsa veya token reddedilirse sunucu konsolunda gerçek durum koduyla Fivemanage upload failed (HTTP 401), the screenshot is attached to the Discord log instead yazar ve görüntü eskisi gibi Discord loguna eklenir. Fivemanage seçili ama token kayıtlı değilse görüntüler Discord'a gider.

Banlar Gecikmez

Ban ve kick'lerde önce oyuncu sunucudan çıkarılır, yükleme ondan sonra yapılır; böylece Fivemanage hiçbir zaman cezayı yavaşlatmaz.

Gizlilik

Ekran görüntüsü, oyuncunun o anki oyun ekranında ne varsa onu gösterir; buna sohbet mesajları, telefon uygulamaları ve başka kişisel bilgiler de girebilir. Görüntülere özen göster:

  • Sunucu kurallarında oyunculara yetkililerin ekran görüntüsü alabileceğini söyle.
  • Ekran görüntüsü alan Discord kanallarına yalnızca yetkililerin erişmesine izin ver.
  • Manuel görüntüleri belirli bir şüpheyi kontrol etmek için kullan, oyuncuları sebepsiz izlemek için değil.
  • Kanıt olarak gerekmeyen görüntüleri Discord'dan sil.

Öneriler

Önerilir:

  • Varsayılan civarında bir Kalite ile jpg kullan. Yüklemeleri küçük, görüntüyü okunur tutar.
  • Ban öncesi kanıt istediğin tespitlerde ekran görüntüsünü aç.
  • Yetkili görüntüleri tespit logları arasında kaybolmasın diye Screenshots kanalına ayrı bir webhook ver.

Kaçın:

  • Henüz ayarladığın log tespitleri gibi çok sık tetiklenen tespitlerde ekran görüntüsünden. Her biri sunucu CPU'su ve bant genişliği harcar.
  • ban ve kick tespitlerinde çok uzun bir Zaman aşımından. Oyuncu, görüntü gelene veya süre dolana kadar oyunda kalır.
  • Ekran görüntülerini herkese açık kanallarda paylaşmaktan.

İlgili Özellikler

Tespitler ve Cezalar

  • Ekran görüntüsü anahtarı, bunu destekleyen her tespitin bir parçasıdır.
  • Bkz. Tespitler ve Cezalar.

Canlı Ekranlar

  • Canlı Ekranlar bir oyuncunun ekranını panelde yayınlar. Her kare, o oyuncunun oyununda alınan bir ekran görüntüsüdür.
  • Kendi ayarları vardır ve her zaman screenshot-basic adlı resource'u kullanır.
  • Bkz. Canlı Ekranlar.

Loglama ve Discord

Yetkili Rolleri ve Komut Erişimi

Ekip Erişimi

  • Web panelinden kimin ekran görüntüsü isteyebileceğini sitedeki ekip rolleri belirler.
  • Bkz. Ekip Erişimi.

Sınırlamalar

  • Güvenlik kuralları ve giriş taraması hiçbir zaman ekran görüntüsü almaz. Giriş taraması sırasında oyuncu henüz oyunda değildir.
  • Ekran görüntüsü tek bir anı gösterir. Tek kanıt olarak değil, tespit detaylarıyla birlikte kullan.
  • Resource seçeneği yalnızca ekran görüntülerinde geçerlidir. Canlı Ekranlar için resource'un adı tam olarak screenshot-basic olmalıdır.
  • Büyük png görüntülerin yüklenmesi jpg veya webp'ye göre daha uzun sürer.

Sık Karşılaşılan Sorunlar

"Ekran görüntüsü kapalı veya screenshot-basic başlatılmamış."

Ne görürsün: cxascreenshot komutu Ekran görüntüsü kapalı veya screenshot-basic başlatılmamış. yanıtını veriyor. İngilizce dil ayarında Screenshots are disabled or screenshot-basic is not started. yazar.

Nasıl düzeltilir:

  • Yapılandırma → Sistem → Ekran görüntüleri ayarını aç ve kaydet. Sunucun bir dakika içinde uygular.
  • screenshot-basic'in çalıştığını kontrol et: sunucu konsoluna ensure screenshot-basic yaz ve satırı server.cfg dosyasına ekle.
  • Ekran görüntüsü resource'unun klasör adı farklıysa o adı Resource alanına yaz.

"Ekran görüntüsü alınamadı."

Ne görürsün: cxascreenshot komutu Ekran görüntüsü alınamadı. yanıtını veriyor (İngilizce: Screenshot could not be taken.) ya da oyun içi panel aynı metni gösteriyor.

Nasıl düzeltilir:

  • Zaman aşımını yükselt. Oyuncunun oyunu görüntüyü zamanında teslim etmedi.
  • Başka bir oyuncuyla tekrar dene. Herkeste başarısız oluyorsa screenshot-basic'i yeniden başlat.

Komut "loglara gönderildi" Diyor Ama Hiçbir Şey Gelmiyor

Ne görürsün: ... oyuncusunun ekran görüntüsü loglara gönderildi. yanıtını alıyorsun ama Discord kanalı boş kalıyor.

Nasıl düzeltilir:

  • Webhook & anahtarlar bölümünde bir Screenshots webhook'u ya da Default webhook ayarla.
  • Yapılandırma → Loglar → Loglama → Discord webhookları ayarının açık olduğunu kontrol et.
  • Webhook'un Discord'da hâlâ var olduğunu kontrol et.

Tespit Loglarında Görüntü Yok

Ne görürsün: Ekran görüntüsü açık bir tespit, logunu görüntüsüz gönderiyor.

Nasıl düzeltilir:

  • Yapılandırma → Sistem → Ekran görüntüleri ayarının açık olduğunu kontrol et.
  • Tespitin cezasının none olmadığını kontrol et; bu ceza hiç log yazmaz.
  • Görüntü bazen eksik geliyorsa Zaman aşımını yükselt.
  • Tespitin kendi Ekran görüntüsü anahtarının açık ve kaydedilmiş olduğunu kontrol et.

Oyun İçi Panel "screenshot-basic çalışmıyor." Diyor

Ne görürsün: Oyun içi panelde Ekran görüntüsü'ne tıklayınca screenshot-basic çalışmıyor. yazıyor.

Nasıl düzeltilir:

  • Oyun içi panel, ekran görüntüleri kullanılamadığında her zaman bu metni gösterir; Yapılandırma → Sistem → Ekran görüntüleri kapalıyken de. Ayarı aç.
  • screenshot-basic'i başlat ve server.cfg içinde ensure cxa-anticheat satırının üstünde tut.

Komutlar → Sonuçlar Bir Hata Gösteriyor

Ne görürsün: Web panelinden istenen bir ekran görüntüsü screenshot_unavailable, screenshot_failed veya player_offline ile bitiyor.

Nasıl düzeltilir:

  • screenshot_unavailable: ekran görüntüleri kapalı ya da screenshot-basic çalışmıyor.
  • screenshot_failed: Zaman aşımı içinde görüntü gelmedi. Süreyi yükselt ve tekrar dene.
  • player_offline: oyuncu, sunucun isteği çalıştırmadan önce çıktı.

© 2026 CodeXart Studios · CXA Anticheat