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
Noclipgibi bir tespit anahtarı,Movementgibi bir grup anahtarı ya daallolabilir. - 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:
Explosionveyaallduraklatı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
Movementanahtarı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.bypassACE 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
RefreshBypasskullan. - Duraklatmalar sayılmaz.
SetTemporaryBypasssürerken bu export yinefalsedö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
IsPlayerBypassedfalsedö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):
Noclipgibi bir tespit anahtarı ya daMovement,Timingveyaall. Anahtarlar büyük/küçük harfe duyarlıdır. Boş anahtarallanlamı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
| Anahtar | Neyi duraklatır | Tipik kullanım |
|---|---|---|
all | Oyuncunun tüm tespitlerini | Ara sahneler, karakter oluşturma ekranları, scriptli etkinlikler |
Movement | Sunucudaki ışınlanma ve hız kontrolünü ve client'taki waypoint'e ışınlanma kontrolünü | Işınlanmalar; AllowTeleport ile aynı duraklatma |
Timing | Client'ı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ır | Oyuncuyu bilerek daha hızlı koşturan veya şarjör değiştirten efektler |
Noclip | Noclip kontrolünü | Jetpack, drone veya oyuncuyu havada tutan scriptler |
Invisible | Görünmezlik kontrolünü | Karakter oluşturma ekranları veya gizli yetkili kameraları |
GodMode | God 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 |
SpeedHack | Yaya hızını | Oyuncuyu daha hızlı koşturan uyuşturucu veya güçlendirme efektleri |
SuperJump | Zıplama yüksekliğini | Zıplama güçlendirmeli mini oyunlar |
Spectate | İzleyici modu kontrolünü | Kendi spectate veya tekrar izleme scriptin |
Freecam | Serbest kamera kontrolünü (varsayılan olarak kapalı) | Oyuncudan uzaklaşan scriptli kameralar |
VehicleModifier | Motor gücü artışlarını ve imkansız araç hızlarını | Nitro veya tuning scriptleri |
PlateChange | Oyuncu araçtayken plaka yazısının değişmesini | Sahte plaka scriptleri |
FastVehicleExit | Araçtan anında inmeyi | Oyuncuları araçtan ışınlayarak çıkaran scriptler |
VehicleGodMode | Kullanılan aracın hiç hasar almamasını | Scriptinin kurşun geçirmez yaptığı görev araçları |
Explosion | Oyuncunun tüm patlama kontrollerini. Duraklatma sırasında patlamalar engellenmez | Yalnızca tamamen güvendiğin scriptli patlamalar |
External | Kendi 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)// Sohbette kullanım: /tpcoords 215.0 -810.0 30.7 (command.tpcoords ACE izni gerekir)
RegisterCommand('tpcoords', (src: number, args: string[]) => {
const [x, y, z] = args.map(Number);
if (src === 0 || [x, y, z].some((v) => Number.isNaN(v))) return;
// Önce hareket kontrollerini duraklat, sonra oyuncuyu taşı
exports['cxa-anticheat'].AllowTeleport(src, 5);
SetEntityCoords(GetPlayerPed(src.toString()), x, y, z, false, false, false, false);
}, 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// Multicharacter scriptin, sunucuda oluşturma ekranını açarken bunu çağırır
function openCreator(src: number): void {
// Oluşturma ekranı oyuncuyu gizler ve ölümsüz yapar
exports['cxa-anticheat'].PauseDetection(src, 'Invisible', 300);
exports['cxa-anticheat'].PauseDetection(src, 'GodMode', 300);
emitNet('my-multichar:client:openCreator', src);
}
// Oyuncu oluşturma ekranını bitirdiğinde çağrılır
function closeCreator(src: number): void {
// 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);
}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
endfunction startRace(racers: number[], grid: { x: number; y: number; z: number; h: number }[]): void {
racers.forEach((src, i) => {
// 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);
emitNet('my-race:client:toGrid', src, grid[i]);
});
}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// Sunucun yeni bir oyuncu için 45 saniyelik bir giriş ara sahnesi başlatır
function playIntro(src: number): void {
// Ara sahnenin kendisinden birkaç saniye uzun
exports['cxa-anticheat'].SetTemporaryBypass(src, 50);
emitNet('my-intro:client:play', src);
}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))))
endfunction setDuty(src: number, onDuty: boolean): void {
const action = onDuty ? 'add_principal' : 'remove_principal';
ExecuteCommand(`${action} player.${src} group.admin`);
// Muafiyet sonuçları önbellekte tutulur, şimdi yeniden hesapla
exports['cxa-anticheat'].RefreshBypass(src);
console.log(`Bypassed now: ${exports['cxa-anticheat'].IsPlayerBypassed(src)}`);
}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;---@alias CxaPauseKey 'all'|'Movement'|'Timing'|string Herhangi bir tespit anahtarı, büyük/küçük harfe duyarlı
---@class CxaBypassExports
---@field IsPlayerBypassed fun(self: CxaBypassExports, src: integer): boolean
---@field RefreshBypass fun(self: CxaBypassExports, src: integer)
---@field SetTemporaryBypass fun(self: CxaBypassExports, src: integer, seconds: number)
---@field PauseDetection fun(self: CxaBypassExports, src: integer, key: CxaPauseKey, seconds: number)
---@field AllowTeleport fun(self: CxaBypassExports, src: integer, seconds?: number) Varsayılan 5 saniye
---@type CxaBypassExports
local cxa = exports['cxa-anticheat']Ö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.
SetTemporaryBypassyerine tek anahtarlıPauseDetectiontercih et. - Bir duraklatmayı erken bitirmek için aynı export'u
1saniyeyle tekrar çağır.0değ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
IsPlayerBypassedexport'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:
AllowTeleportexport'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
MovementveyaWaypointTeleportdeğilse o anahtarı daPauseDetectionile 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)// ❌ 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.bypassACE 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ış.
SetTemporaryBypassbir duraklatmadır;IsPlayerBypassedise yalnızca kalıcı muafiyet kurallarını bildirir. Duraklatmaları bilmen gerekiyorsa onları kendi scriptinde takip et.
© 2026 CodeXart Studios · CXA Anticheat