Muafiyet ve Duraklatma Export'ları

Bazı scriptler, bir anticheat'e hile gibi görünen şeyleri bilerek yapar: ışınlanma, oyuncuyu gizleyen bir karakter oluşturma ekranı, bir ara sahne ya da nitro. Bu export'larla scriptin bunu CXA Anticheat'e tek bir oyuncu ve kısa bir süre için bildirir. CXA'da tespit bazlı bir muafiyet izni olmadığı için, tek bir oyuncuda tek bir tespiti kapatmanın yolu da bu export'lardır.

Kontrolsüz Bir Client Eventinden Duraklatma Yapma

Hileciler, client scriptlerinin tetikleyebildiği her eventi tetikleyebilir. my-script:server:startCutscene gibi bir client eventi hiçbir kontrol yapmadan tespitleri duraklatıyorsa hileciler onu kendileri çağırır. Duraklatmayı yalnızca işlemin gerçek olduğunu zaten bilen sunucu kodundan yap; örneğin ara sahneyi sunucu kendisi başlattığı için.

Ne Zaman Kullanılır

  • Yönetici ışınlanma scriptin, hapis scriptin veya bir yarış başlangıcı oyuncuları haritanın başka bir yerine taşıyorsa.
  • Karakter oluşturma ekranı oyuncuyu gizliyor veya ölümsüz yapıyorsa.
  • Birkaç saniyelik bir ara sahne veya giriş kamerası oynuyorsa.
  • Sahte plaka scripti, oyuncu araçtayken plakayı değiştiriyorsa.
  • Bir script oyuncuları araçtan anında çıkarıyorsa.
  • Bir yetkili göreve girip çıkıyor ve oturum sırasında grubu değişiyorsa.

Nasıl Çalışır

  • Bir duraklatma tek bir oyuncuya ve tek bir anahtara aittir, bir de bitiş zamanı vardır. Anahtar Noclip gibi bir tespit anahtarı, Movement gibi bir grup anahtarı ya da all olabilir.
  • Bir anahtar duraklatılmışken sunucu o anahtarın cezalarını atlar, oyuncunun client'ı da o kontrolü çalıştırmayı bırakır.
  • Duraklatmalar kendiliğinden biter. Aynı anahtar için export'u tekrar çağırırsan yeni bir bitiş zamanı ayarlanır; yani duraklatmayı uzatabilir veya kısaltabilirsin.
  • Duraklatmalar hafızada tutulur. Oyuncu çıktığında biterler; CXA yeniden başladığında da biterler, örneğin panelde yeni bir config kaydettikten birkaç saniye sonra.
  • Duraklatma her korumayı değil, cezayı atlar. Blacklist'teki entity spawnları ve spam limitini aşan entityler yine engellenir. Patlamalar istisnadır: Explosion veya all duraklatılmışken oyuncunun patlamaları ne engellenir ne de loglanır.
  • Muafiyet ile duraklatma farklıdır. Muafiyet Yetkili Muafiyeti kurallarından gelir ve oyuncu bu kurallara uyduğu sürece geçerlidir. Duraklatma geçicidir ve yalnızca scriptlerden gelir.
  • Oyun İçi Panel (/cxa) de aynı duraklatmaları kullanır: Goto ve Bring Movement anahtarını 15 saniye, Freeze 5 saniye duraklatır; Spectate ise izleyen yetkilinin tüm kontrollerini duraklatır.

Export'lar

IsPlayerBypassed

Oyuncunun tüm kontrolleri atlayıp atlamadığını söyler.

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

Parametreler:

  • src (number): Oyuncunun sunucu ID'si

Dönüş değeri: Oyuncu herhangi bir muafiyet kuralına uyuyorsa true, uymuyorsa false.

Ne olur:

  • CXA, Yetkili Muafiyeti kurallarına bakar: txAdmin'e giriş yapmış yöneticiler (bu seçenek açıksa), cxa.bypass ACE izni, listelenen tanımlayıcılar ve framework grupları.
  • Sonuç oyuncu başına varsayılan olarak 60 saniye önbellekte tutulur (muafiyet ayarlarındaki Önbellek süresi). Hemen yeniden hesaplamak için RefreshBypass kullan.
  • Duraklatmalar sayılmaz. SetTemporaryBypass sürerken bu export yine false döner.

RefreshBypass

Bir oyuncunun muafiyetini hemen yeniden hesaplar.

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

Parametreler:

  • src (number): Oyuncunun sunucu ID'si

Dönüş değeri: Yok.

Ne olur:

  • Önbellekteki sonuç atılır ve yeniden hesaplanır.
  • Yeni durum oyuncunun client'ına gönderilir; client kontrolleri hemen durur veya başlar.
  • CXA başlamamışken ya da oyuncunun client'ı anticheat'i yüklemeyi bitirmemişken hiçbir şey olmaz. Bu durumda CXA, client hazır olduğunda sonucu zaten yeniden hesaplar.
  • CXA; txAdmin bir yönetici girişi bildirdiğinde, bir ESX oyuncusu yüklendiğinde (esx:playerLoaded) ve bir QBCore oyuncusu yüklendiğinde (QBCore:Server:PlayerLoaded) kendiliğinden yeniler. Kendi scriptin oturum sırasında bir grubu, meslek yetkisini veya ACE principal'ını değiştirdiğinde bu export'u çağır.

SetTemporaryBypass

Bir oyuncu için tüm tespitleri duraklatır.

exports['cxa-anticheat']:SetTemporaryBypass(src, seconds)

Parametreler:

  • src (number): Oyuncunun sunucu ID'si
  • seconds (number): Duraklatmanın süresi. 0, negatif bir değer veya boş değer hiçbir şey yapmaz

Dönüş değeri: Yok.

Ne olur:

  • PauseDetection(src, 'all', seconds) ile aynıdır.
  • Bu bir muafiyet değil, duraklatma olduğu için IsPlayerBypassed false dönmeye devam eder.
  • Süre boyunca oyuncunun patlamaları engellenmez. Süreyi olabildiğince kısa tut.

PauseDetection

Bir oyuncu için tek bir tespiti veya bir tespit grubunu duraklatır.

exports['cxa-anticheat']:PauseDetection(src, key, seconds)

Parametreler:

  • src (number): Oyuncunun sunucu ID'si
  • key (string): Noclip gibi bir tespit anahtarı ya da Movement, Timing veya all. Anahtarlar büyük/küçük harfe duyarlıdır. Boş anahtar all anlamına gelir
  • seconds (number): Duraklatmanın süresi. 0, negatif bir değer veya boş değer hiçbir şey yapmaz

Dönüş değeri: Yok.

Ne olur:

  • Sunucu bu anahtarın cezalarını atlar, oyuncunun client'ı da ilgili kontrolü çalıştırmayı bırakır.
  • Bilinmeyen bir anahtar hata vermeden kabul edilir ve hiçbir şey yapmaz. Anahtarları Tüm Tespitler sayfasından veya aşağıdaki tablodan kopyala.

AllowTeleport

Scriptli bir ışınlanma işaretlenmesin diye hareket kontrollerini duraklatır.

exports['cxa-anticheat']:AllowTeleport(src, seconds)

Parametreler:

  • src (number): Oyuncunun sunucu ID'si
  • seconds (number, opsiyonel): Duraklatmanın süresi. Varsayılan: 5

Dönüş değeri: Yok.

Ne olur:

  • PauseDetection(src, 'Movement', seconds) ile aynıdır.
  • Sunucudaki ışınlanma ve hız kontrolünü ve client'taki waypoint'e ışınlanma kontrolünü duraklatır.
  • Sunucu hareket kontrolü varsayılan olarak kapalıdır. Yine de AllowTeleport çağır: böylece bir sunucu sahibi bu kontrolü açtığında scriptin çalışmaya devam eder.

Duraklatabileceğin Anahtarlar

AnahtarNeyi duraklatırTipik kullanım
allOyuncunun tüm tespitleriniAra sahneler, karakter oluşturma ekranları, scriptli etkinlikler
MovementSunucudaki ışınlanma ve hız kontrolünü ve client'taki waypoint'e ışınlanma kontrolünüIşınlanmalar; AllowTeleport ile aynı duraklatma
TimingClient'ın şarjör değiştirme, koşma ve strafe hızını ölçmesini; hızlı şarjör, hızlı koşu ve strafe boost kontrolleri bunu kullanırOyuncuyu bilerek daha hızlı koşturan veya şarjör değiştirten efektler
NoclipNoclip kontrolünüJetpack, drone veya oyuncuyu havada tutan scriptler
InvisibleGörünmezlik kontrolünüKarakter oluşturma ekranları veya gizli yetkili kameraları
GodModeGod mode kontrolünü (varsayılan olarak kapalı)Oyuncuları ölümsüz yapan güvenli bölgeler veya karakter seçim ekranları
HealthArmorİzin verilen üst sınırın üstündeki can veya zırhıBir etkinlik için ekstra can veren scriptler
SpeedHackYaya hızınıOyuncuyu daha hızlı koşturan uyuşturucu veya güçlendirme efektleri
SuperJumpZıplama yüksekliğiniZıplama güçlendirmeli mini oyunlar
Spectateİzleyici modu kontrolünüKendi spectate veya tekrar izleme scriptin
FreecamSerbest kamera kontrolünü (varsayılan olarak kapalı)Oyuncudan uzaklaşan scriptli kameralar
VehicleModifierMotor gücü artışlarını ve imkansız araç hızlarınıNitro veya tuning scriptleri
PlateChangeOyuncu araçtayken plaka yazısının değişmesiniSahte plaka scriptleri
FastVehicleExitAraçtan anında inmeyiOyuncuları araçtan ışınlayarak çıkaran scriptler
VehicleGodModeKullanılan aracın hiç hasar almamasınıScriptinin kurşun geçirmez yaptığı görev araçları
ExplosionOyuncunun tüm patlama kontrollerini. Duraklatma sırasında patlamalar engellenmezYalnızca tamamen güvendiğin scriptli patlamalar
ExternalKendi FlagPlayer çağrılarınıBir oyuncu için kendi kontrollerini kapatmak

Diğer tüm tespit anahtarları da aynı şekilde çalışır. Hepsi Tüm Tespitler sayfasında listelenir.

Örnekler

Yönetici Işınlanması

-- Sohbette kullanım: /tpcoords 215.0 -810.0 30.7 (command.tpcoords ACE izni gerekir)
RegisterCommand('tpcoords', function(src, args)
    local x, y, z = tonumber(args[1]), tonumber(args[2]), tonumber(args[3])
    if src == 0 or not x or not y or not z then
        return
    end
    -- Önce hareket kontrollerini duraklat, sonra oyuncuyu taşı
    exports['cxa-anticheat']:AllowTeleport(src, 5)
    SetEntityCoords(GetPlayerPed(src), x, y, z, false, false, false, false)
end, true)

Karakter Oluşturma Ekranı

Multicharacter resource'un oluşturma ekranını sunucu kodundan açar; böylece sunucu, oyuncunun gerçekten o ekranda olduğunu bilir.

-- Multicharacter scriptin, sunucuda oluşturma ekranını açarken bunu çağırır
local function openCreator(src)
    -- Oluşturma ekranı oyuncuyu gizler ve ölümsüz yapar
    exports['cxa-anticheat']:PauseDetection(src, 'Invisible', 300)
    exports['cxa-anticheat']:PauseDetection(src, 'GodMode', 300)
    TriggerClientEvent('my-multichar:client:openCreator', src)
end

-- Oyuncu oluşturma ekranını bitirdiğinde çağrılır
local function closeCreator(src)
    -- Yeni 1 saniyelik duraklatma 300 saniyenin yerine geçer, kontroller hemen geri gelir
    exports['cxa-anticheat']:PauseDetection(src, 'Invisible', 1)
    exports['cxa-anticheat']:PauseDetection(src, 'GodMode', 1)
end

Yarış Başlangıcı

local function startRace(racers, grid)
    for i, src in ipairs(racers) do
        -- Başlangıç gridine ışınlanma, ışınlanma hilesi gibi görünür
        exports['cxa-anticheat']:AllowTeleport(src, 10)
        -- Yarış, motor gücünü artıran nitro verir; en fazla 10 dakika
        exports['cxa-anticheat']:PauseDetection(src, 'VehicleModifier', 600)
        TriggerClientEvent('my-race:client:toGrid', src, grid[i])
    end
end

Ara Sahne

-- Sunucun yeni bir oyuncu için 45 saniyelik bir giriş ara sahnesi başlatır
local function playIntro(src)
    -- Ara sahnenin kendisinden birkaç saniye uzun
    exports['cxa-anticheat']:SetTemporaryBypass(src, 50)
    TriggerClientEvent('my-intro:client:play', src)
end

Görev Değişikliğinden Sonra Yenile

Görev scriptin, görevdeki yetkililere group.admin principal'ını verir; server.cfg dosyasında da add_ace group.admin cxa.bypass allow satırı vardır.

local function setDuty(src, onDuty)
    local action = onDuty and 'add_principal' or 'remove_principal'
    ExecuteCommand(('%s player.%d group.admin'):format(action, src))
    -- Muafiyet sonuçları önbellekte tutulur, şimdi yeniden hesapla
    exports['cxa-anticheat']:RefreshBypass(src)
    print(('Bypassed now: %s'):format(tostring(exports['cxa-anticheat']:IsPlayerBypassed(src))))
end

Tip Tanımları

type CxaPauseKey = 'all' | 'Movement' | 'Timing' | (string & {}); // Herhangi bir tespit anahtarı, büyük/küçük harfe duyarlı

interface CxaBypassExports {
  IsPlayerBypassed(src: number): boolean;
  RefreshBypass(src: number): void;
  SetTemporaryBypass(src: number, seconds: number): void;
  PauseDetection(src: number, key: CxaPauseKey, seconds: number): void;
  AllowTeleport(src: number, seconds?: number): void; // Varsayılan 5 saniye
}

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

Öneriler

Bilmekte Fayda Var

  • İşlemden sonra değil, önce duraklat. Duraklatmanın oyuncunun client'ına ulaşması bir an sürer.
  • İşini gören en dar anahtarı, en kısa süreyle duraklat. SetTemporaryBypass yerine tek anahtarlı PauseDetection tercih et.
  • Bir duraklatmayı erken bitirmek için aynı export'u 1 saniyeyle tekrar çağır. 0 değeri hiçbir şey yapmaz.
  • Uzun duraklatmalar CXA yeniden başladığında silinir. Etkinliğin uzun sürüyorsa her aşamada, örneğin her yarış checkpoint'inde, tekrar duraklat.
  • Scriptlerin bir grubu veya yetkiyi değiştirdiğinde her seferinde RefreshBypass çağır; böylece yetkililer 60 saniyelik önbellek süresince işaretlenmez.

İlgili Özellikler

Yetkili Muafiyeti

  • IsPlayerBypassed export'unun okuduğu muafiyet kuralları Yetkili Muafiyeti sayfasında ayarlanır.
  • Muaf oyuncular tüm kontrolleri kalıcı olarak atlar. Yalnızca bir script işlemi istisna gerektiriyorsa duraklatma kullan.

Oyun İçi Panel (/cxa)

  • Oyun İçi Panel (/cxa) içindeki Goto, Bring, Freeze ve Spectate işlemleri tespitleri aynı şekilde duraklatır.

Tespitler ve Cezalar

  • Scriptlerinden biri bir tespiti herkes için sürekli tetikliyorsa, onu her oyuncu için duraklatmak yerine o tespiti ayarla. Bkz. Tespitler ve Cezalar.

Sık Karşılaşılan Sorunlar

Işınlanmadan Sonra Oyuncular Hâlâ İşaretleniyor

Ne görürsün: AllowTeleport çağırıyorsun ama ışınlanma yine loglanıyor.

Nasıl düzeltilir:

  • AllowTeleport export'unu ışınlanmadan sonra değil, önce çağır.
  • Yeterli süre ver. Işınlanman bir kararma veya yükleme ekranı bekliyorsa 10 saniye veya daha fazlasını kullan.
  • Logdaki tespit anahtarına bak. Anahtar Movement veya WaypointTeleport değilse o anahtarı da PauseDetection ile duraklat.

PauseDetection Hiçbir Şey Yapmıyor

Ne görürsün: Bir tespiti duraklatıyorsun ama oyuncu için yine tetikleniyor.

Nasıl düzeltilir:

  • Anahtarlar büyük/küçük harfe duyarlıdır. Onları Tüm Tespitler sayfasından kopyala.
  • Argümanların sırasını kontrol et: oyuncu, anahtar, saniye.
  • Saniye 0'dan büyük olmalı.
-- ❌ Yanlış harf: bu anahtar yok, hiçbir şey duraklatılmaz
exports['cxa-anticheat']:PauseDetection(src, 'noclip', 10)

-- ❌ Yanlış sıra: saniye ile anahtar yer değiştirmiş
exports['cxa-anticheat']:PauseDetection(src, 10, 'Noclip')

-- ✅ Oyuncu, tam anahtar, saniye
exports['cxa-anticheat']:PauseDetection(src, 'Noclip', 10)

Grup Değişikliğinden Hemen Sonra Yetkililer İşaretleniyor

Ne görürsün: Bir yetkili yeni bir grup alıyor ama CXA onu bir dakikaya kadar kontrol etmeye devam ediyor.

Nasıl düzeltilir:

  • Scriptin grubu değiştirdikten hemen sonra RefreshBypass(src) çağır.
  • Yeni grubun muafiyet framework gruplarında olduğunu ya da cxa.bypass ACE iznine sahip olduğunu kontrol et.

Geçici Muafiyet Sırasında IsPlayerBypassed false Dönüyor

Ne görürsün: SetTemporaryBypass çağırdın ama IsPlayerBypassed false diyor.

Nasıl düzeltilir:

  • Bu beklenen bir davranış. SetTemporaryBypass bir duraklatmadır; IsPlayerBypassed ise yalnızca kalıcı muafiyet kurallarını bildirir. Duraklatmaları bilmen gerekiyorsa onları kendi scriptinde takip et.

© 2026 CodeXart Studios · CXA Anticheat