Özel İşaretleme ve Güven

Kendi scriptlerin, sunucunda neyin imkansız olduğunu çoğu zaman herhangi bir anticheat'ten daha iyi bilir; örneğin bir meslek için fazla yüksek bir ödeme. FlagPlayer ile bunu CXA Anticheat'e bildirirler, CXA da onu kendi tespitlerinden biri gibi loglar ve cezalandırır. GetTrustScore CXA ağının bir oyuncunun hesabına ne kadar güvendiğini, IsActive ise anticheat'in çalışıp çalışmadığını söyler.

İşaretleme, Kontrolün Kadar İyidir

FlagPlayer, scriptinin bildirdiği her şeyi cezalandırır. Her işaretlemeyi sunucunun bildiği gerçeklere dayandır; client'ın kontrolsüz gönderdiği bir değere asla güvenme. Yeni bir kontrolü kick veya ban yapmadan önce birkaç gün log ile çalıştır.

Ne Zaman Kullanılır

  • Bir para, item veya ödül eventi, sunucunun imkansız olduğunu bildiği bir istek alıyorsa.
  • Scriptlerinden biri normal oyunda olamayacak bir değer buluyorsa; örneğin malzemeleri atlayan bir üretim sonucu.
  • Oyuncu pazarı veya VIP alanı gibi bir özellik yalnızca yeterli güvene sahip hesaplara açık olmalıysa.
  • Scriptin CXA çalışırken onu kullanmalı, çalışmıyorken kendi loguna dönmeliyse.

Export'lar

FlagPlayer

Kendi tespitini bildirir ve bir ceza uygular.

exports['cxa-anticheat']:FlagPlayer(src, reason, punishment, hours)

Parametreler:

  • src (number): Oyuncunun sunucu ID'si
  • reason (string, opsiyonel): Scriptinin bulduğu şey. Loglarda ve ban ya da kick ekranında görünür. Varsayılan: External detection etiketi (Türkçe dilde Harici tespit)
  • punishment (string, opsiyonel): ban, kick, warn, log veya none, küçük harfle. Varsayılan: log
  • hours (number, opsiyonel): ban için saat cinsinden süre, 0 = kalıcı. Varsayılan: ban sistemi ayarlarındaki varsayılan süre (0)

Dönüş değeri: CXA işaretlemeyi işlediyse true. Buna none ve bekleme süresi yüzünden atlanan tekrar eden bir log veya warn da dahildir. Anticheat aktif değilse, oyuncu çevrimiçi değilse veya zaten sunucudan atılıyorsa, ya da oyuncu muafsa veya onun için External ya da all duraklatılmışsa false.

Ne olur:

  • İşaretleme, "External detection" (Harici tespit) olarak gösterilen External tespiti olarak işlenir.
  • none dışında CXA konsola bir satır yazar, çevrimiçi yetkililere sohbet uyarısı gönderir ve paneldeki Tespitler sekmesine sebebinle ve resource adınla bir kayıt ekler.
  • Oyuncunun ne gördüğünü ve mesajın hangi webhook kanalına gittiğini ceza belirler:
CezaOyuncunun gördüğüWebhook kanalı
banBanlanır ve sebebini gösteren ban ekranıyla sunucudan atılırBans
kickSebebini gösteren kick ekranıyla sunucudan atılırKicks
warnEkranda bir uyarı ve sohbette bir satır. Oyuncu sunucuda kalırWarns
logHiçbir şeyDetections
noneHiçbir şey. Log da yazılmazYok
  • log ve warn için bir bekleme süresi vardır. Aynı oyuncu için 10 saniye içindeki tekrar eden işaretlemeler atlanır (loglama ayarlarındaki Tespit bekleme süresi). Tüm scriptlerin External anahtarını paylaştığı için bu bekleme süresini de paylaşır.
  • Ekran görüntüsü eklenmez.
  • Uyarı metni senin sebebini değil, tespit etiketini gösterir: Anticheat warning: External detection. Keep doing it and you will be removed from the server. (Türkçe dilde: Anticheat uyarısı: Harici tespit. Devam edersen sunucudan atılırsın.)
  • FlagPlayer ile verilen bir banı CXA Anticheat vermiş görünür. Ban, CXA ağında yalnızca External anahtarını global banların paylaşılan tespitlerine eklersen paylaşılır; varsayılan olarak ekli değildir.

Çıktı: Konsol satırı şöyle görünür:

Output
[CXA] John (ID: 12) -> External detection [log] reason: Delivery payout of 50000 (max 2500), resource: my-delivery

Çevrimiçi yetkililer [CXA] ön ekli ve John (ID: 12) flagged for External detection [log] metinli bir sohbet uyarısı alır (Türkçe dilde: John (ID: 12) şüpheli bulundu: Harici tespit [log]).

GetTrustScore

Oyuncunun güven puanını ve seviyesini döndürür.

exports['cxa-anticheat']:GetTrustScore(src)

Parametreler:

  • src (number): Oyuncunun sunucu ID'si

Dönüş değeri: { score, band } tablosu ya da bilinen bir puan yoksa nil. JavaScript ve TypeScript'te "puan yok" sonucu undefined olarak gelir.

SeviyePuan
red0 - 19
orange20 - 39
yellow40 - 59
lime60 - 79
green80 - 100

Ne olur:

  • CXA ağı puanı oyuncu girerken hesap yaşlarından, bağlı hesaplardan, ağ geçmişinden ve global banlardan hesaplar. CXA bu puanı oturumun geri kalanında saklar. Bkz. Hesap Güveni.
  • Güven puanı giriş kontrolü kapalıyken de puan oluşur. Steam hesap yaşı gibi bazı etkenlere yalnızca bu giriş kontrolü açıkken bakılır.
  • Giriş taraması veya bağlanırken ağ kontrolü kapalıysa, ağa zamanında ulaşılamadıysa, oyuncunun license tanımlayıcısı yoksa ya da oyuncu muafiyet tanımlayıcı listesindeyse nil alırsın; çünkü bu oyuncular giriş kontrollerini atlar.
  • CXA son kez yeniden başlamadan önce girmiş oyuncular için de, yeniden bağlanana kadar nil alırsın.

IsActive

Anticheat'in çalışıp çalışmadığını ve lisanslı olup olmadığını söyler.

exports['cxa-anticheat']:IsActive()

Parametreler: Yok.

Dönüş değeri: Klasörün adı cxa-anticheat ise, anticheat başlamışsa ve lisans doğrulanmışsa true. Aksi halde false.

Ne olur:

  • Hiçbir şey değişmez, yalnızca mevcut durum okunur.
  • CXA yeniden başlarken export bir an için yoktur. Çağırmadan önce GetResourceState('cxa-anticheat') ile kontrol et; Sunucu Export'ları sayfasında gösterildiği gibi.

Örnekler

İmkansız Ödemeleri İşaretle

Kargo mesleğin hiçbir zaman 2.500'den fazla ödemiyor. Sunucu istenen tutarı kontrol eder, daha yükseğini reddeder ve bildirir. Üçüncü işaretlemeden sonra oyuncu sunucudan atılır.

local MAX_PAYOUT = 2500 -- Bir teslimatın ödeyebileceği en yüksek tutar
local strikes = {}

RegisterNetEvent('my-delivery:server:finish', function(amount)
    local src = source
    amount = tonumber(amount) or 0
    if amount > MAX_PAYOUT then
        -- Önce ödemeyi reddet, sonra bildir
        strikes[src] = (strikes[src] or 0) + 1
        local punishment = strikes[src] >= 3 and 'kick' or 'log'
        local reason = ('Delivery payout of %d (max %d)'):format(amount, MAX_PAYOUT)
        exports['cxa-anticheat']:FlagPlayer(src, reason, punishment)
        return
    end
    -- Oyuncuya ödemeyi burada framework'ünle yap
end)

AddEventHandler('playerDropped', function()
    strikes[source] = nil -- Oyuncu çıkınca sayacı unut
end)

VIP Özelliğini Güven Seviyesine Bağla

VIP pazarına yalnızca yellow ve üstü seviyedeki hesaplar ürün koyabilir.

local BAND_RANK = { red = 1, orange = 2, yellow = 3, lime = 4, green = 5 }

local function hasTrust(src, minimumBand)
    local trust = exports['cxa-anticheat']:GetTrustScore(src)
    if not trust then
        return false -- Puan bilinmiyor: izin verip vermeyeceğine kendin karar ver
    end
    return BAND_RANK[trust.band] >= BAND_RANK[minimumBand]
end

RegisterNetEvent('my-market:server:createListing', function(item, price)
    local src = source
    if not hasTrust(src, 'yellow') then
        TriggerClientEvent('chat:addMessage', src, { args = { 'Market', 'Your account cannot sell on the VIP market yet.' } })
        return
    end
    -- İlanı burada oluştur
end)

CXA Çalışmıyorsa Kendi Loguna Dön

local function report(src, reason)
    local running = GetResourceState('cxa-anticheat') == 'started' and exports['cxa-anticheat']:IsActive()
    if running then
        exports['cxa-anticheat']:FlagPlayer(src, reason, 'log')
    else
        -- Anticheat yokken kendi logun
        print(('[my-script] %s (%d): %s'):format(GetPlayerName(src), src, reason))
    end
end

Tip Tanımları

type CxaPunishment = 'ban' | 'kick' | 'warn' | 'log' | 'none';
type CxaTrustBand = 'red' | 'orange' | 'yellow' | 'lime' | 'green';

interface CxaTrust {
  score: number; // 0 ile 100 arası
  band: CxaTrustBand;
}

interface CxaFlagExports {
  FlagPlayer(src: number, reason?: string, punishment?: CxaPunishment, hours?: number): boolean;
  GetTrustScore(src: number): CxaTrust | undefined;
  IsActive(): boolean;
}

const cxa = exports['cxa-anticheat'] as CxaFlagExports;

Öneriler

Bilmekte Fayda Var

  • Her yeni işaretlemeye log ile başla. Paneldeki Tespitler sekmesini birkaç gün izle, sonra cezayı yükselt.
  • Sebebe gerçekleri yaz: değeri, sınırı, itemi. Yetkililerin işaretlemeyi bu metne bakarak değerlendirir.
  • İşaretlemeden önce işlemi reddet. FlagPlayer bildirir; bir ödemeyi geri almaz.
  • nil güven puanını "kötü" değil "bilinmiyor" olarak değerlendir. CXA yeniden başlamadan önce girmiş oyuncuların, yeniden bağlanana kadar puanı yoktur.
  • Muaf olmayan bir oyuncuyla test et. Muafiyeti olan yetkililer hiçbir zaman işaretlenmez.

İlgili Özellikler

Tespitler ve Cezalar

  • ban, kick, warn, log ve none, CXA'nın kendi tespitlerinde nasıl çalışıyorsa aynen öyle çalışır. Bkz. Tespitler ve Cezalar.

Hesap Güveni

  • Puanın ve seviyelerin nasıl hesaplandığı ve düşük güvenli hesapların girişte nasıl engelleneceği Hesap Güveni sayfasında anlatılıyor.

Loglama ve Discord

  • İşaretlemeler cezaya göre Bans, Kicks, Warns veya Detections kanalına gider. Bkz. Loglama ve Discord.

Banlar ve CXA Ağı

  • FlagPlayer banları, External anahtarını paylaşılan tespitlere eklemedikçe senin sunucunda kalır. Bkz. Banlar ve CXA Ağı.

Sık Karşılaşılan Sorunlar

FlagPlayer false Dönüyor

Ne görürsün: Çağrı false döner ve hiçbir şey loglanmaz.

Nasıl düzeltilir:

  • Belki de yetkili olarak kendi üzerinde test ediyorsun. Muaf oyuncular hiçbir zaman işaretlenmez. Normal bir hesapla test et.
  • Hiçbir scriptin o oyuncu için External veya all duraklatmadığını kontrol et.
  • IsActive() sonucuna ve oyuncunun hâlâ çevrimiçi olduğuna bak.

Oyuncu Sunucuda Kalıyor ve Artık Kontrol Edilmiyor

Ne görürsün: Bir işaretlemeden sonra oyuncu sunucuda kalıyor ama CXA onu yok sayıyor, yeniden bağlanana kadar entitylerini ve patlamalarını engelliyor.

Nasıl düzeltilir:

  • Ceza değeri desteklenen beş değerden biri değildi. Değeri tam yazıldığı gibi küçük harfle kullan. Başka bir değer log gibi loglanır ama CXA oyuncuyu sonra zaten atılıyormuş gibi değerlendirir.
-- ❌ Büyük harf: desteklenen bir ceza değil
exports['cxa-anticheat']:FlagPlayer(src, 'Duplicated items', 'Kick')

-- ✅ Küçük harf
exports['cxa-anticheat']:FlagPlayer(src, 'Duplicated items', 'kick')

Yalnızca İlk İşaretleme Görünüyor

Ne görürsün: Scriptin bir oyuncuyu arka arkaya birkaç kez işaretliyor ama yalnızca bir kayıt görünüyor.

Nasıl düzeltilir:

  • Bu, log ve warn için 10 saniyelik bekleme süresidir. Loglarını spamdan korur ve FlagPlayer kullanan tüm scriptler tarafından paylaşılır.
  • Denemeleri kendi scriptinde say ve toplamla tek bir işaretleme gönder ya da yukarıdaki ödeme örneğindeki gibi birkaç denemeden sonra cezayı yükselt.

GetTrustScore nil Dönüyor

Ne görürsün: GetTrustScore, çevrimiçi bir oyuncu için nil dönüyor.

Nasıl düzeltilir:

  • Panelde giriş taramasının ve bağlanırken ağ kontrolünün açık olduğunu kontrol et.
  • CXA oyuncu girdikten sonra yeniden başladıysa puan, oyuncu yeniden bağlandığında geri gelir.
  • Muafiyet tanımlayıcı listesindeki oyuncular giriş kontrollerini atlar ve hiçbir zaman puan almaz.

© 2026 CodeXart Studios · CXA Anticheat