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
| Gereksinim | Neden 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çık | Config.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:
- Ekran görüntüsü açık olan bir tespit tetiklenir. Konsol satırı ve oyun içi yetkili uyarısı hemen çıkar.
- CXA, Format ve Kalite ayarlarınla
screenshot-basic'ten oyuncunun oyununun görüntüsünü ister. - CXA görüntü gelene kadar, en fazla Zaman aşımı kadar milisaniye bekler.
- CXA cezayı uygular.
banvekickiçin oyuncu bu beklemeden sonra sunucudan çıkarılır. - Görüntü o cezanın Discord loguna eklenir: Bans, Kicks veya Warns kanalı,
logiç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-anticheatAdı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çenek | Anahtar | Varsayılan | Ne yapar |
|---|---|---|---|
| Ekran görüntüleri | Enabled | false | Tespitler ve yetkililer için ekran görüntülerini açar. |
| Resource | Resource | 'screenshot-basic' | Ekran görüntüsü resource'unun adı. Yalnızca screenshot-basic kopyanın klasör adı farklıysa değiştir. |
| Format | Encoding | 'jpg' | Görüntü biçimi: jpg, png veya webp. |
| Kalite | Quality | 0.6 | 0,1 ile 1,0 arası. Düşük değer daha küçük yükleme demektir. |
| Zaman aşımı | Timeout | 6000 ms | Gö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ğı yer | Upload | '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:
| Tespit | Config yolu |
|---|---|
| Araç taşıma | Config.ClientDetections.VehicleCarry |
| Waypointe ışınlanma | Config.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:
# Sunucu konsolunda
cxascreenshot 12
# Oyun sohbetinde
/cxascreenshot 12Parametreler:
- 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.(%syerine 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 tespit | O logun kanalı: Bans, Kicks, Warns veya tespitin log kanalı | Hiçbir yerde |
cxascreenshot | Screenshots | Sohbette veya konsolda yanıt |
| Oyun içi panel | Screenshots | Oyun içi panel penceresinde |
| Web paneli | Screenshots | Komutlar → 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.
- Fivemanage'de bir hesap aç, panelindeki Tokens sayfasını aç ve bir API tokenı oluştur.
- Web panelinde Webhook & anahtarlar sekmesini aç, tokenı Fivemanage API key alanına yapıştır ve kaydet. İstersen bunun yerine
sv_config.luadosyasına da yazabilirsin:
SvConfig.Fivemanage = {
ApiKey = '',
}- 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
jpgkullan. 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
logtespitleri gibi çok sık tetiklenen tespitlerde ekran görüntüsünden. Her biri sunucu CPU'su ve bant genişliği harcar. banvekicktespitlerinde ç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-basicadlı resource'u kullanır. - Bkz. Canlı Ekranlar.
Loglama ve Discord
- Ekran görüntüleri Discord log mesajlarına eklenir.
- Bkz. Loglama ve Discord.
Yetkili Rolleri ve Komut Erişimi
cxascreenshotkomutunu ve oyun içi Ekran görüntüsü düğmesini hangi rollerin kullanacağını belirle.- Bkz. 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-basicolmalıdır. - Büyük
pnggörüntülerin yüklenmesijpgveyawebp'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 konsolunaensure screenshot-basicyaz ve satırıserver.cfgdosyası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
noneolmadığı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 veserver.cfgiçindeensure cxa-anticheatsatı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 dascreenshot-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