Event Guard

Hile menüleri scriptlerinin server eventlerini doğrudan çağırabilir; örneğin bir mesleğin ödeme eventini para veya item almak için birkaç saniyede yüzlerce kez. Event Guard, resource'larının server eventlerinin önünde duran küçük bir dosyadır ve her oyuncunun her eventi ne sıklıkla çağırabileceğini sınırlar. Bu sayfa ayrıca tuzak eventleri ve CXA'nın hiçbir kurulum gerektirmeden çalıştırdığı oyun eventi kontrollerini anlatır.

Bir Sınırdır, Doğrulama Değildir

Event Guard bir eventin ne sıklıkla çağrıldığını sınırlar. Tek bir çağrının dürüst olup olmadığını anlayamaz. Client'ın gönderdiği tutarı ne olursa olsun ödeyen bir script, sınırın içinde kalarak yine istismar edilebilir. Bu yüzden tutarları, mesafeleri ve koşulları her zaman kendi scriptlerinde sunucu tarafında kontrol et.

Event İstismarı Nedir

Çoğu script iki parçaya ayrılır. Client parçası oyuncunun oyununda, sunucu parçası senin sunucunda çalışır. Oyuncu bir teslimatı bitirdiğinde client parçası bir server eventi (myjob:server:payout gibi isimli bir mesaj) gönderir, sunucu parçası da oyuncuya ödeme yapar.

Bir hile menüsü aynı server eventini işi yapmadan, istediği kadar gönderebilir. Sunucu parçası her çağrıya güveniyorsa hileci her seferinde para alır. Event Guard doğal olmayan çağrı sayısını yakalar ve çağrılar scriptine ulaşmadan durdurur.

Nasıl Çalışır

  1. cxa-anticheat klasöründeki lib/eventguard.lua dosyasını bir resource'un ilk server scripti olarak eklersin; elle veya cxainject ile.
  2. Dosya o resource içindeki RegisterNetEvent, RegisterServerEvent ve AddEventHandler fonksiyonlarını sarar. Böylece resource'un ondan sonra kaydettiği her server eventi önce Event Guard'dan geçer.
  3. Her çağrı oyuncu ve event bazında sayılır. Sayım ilk çağrıyla başlar ve Window saniye sonra sıfırlanır.
  4. Bir oyuncu sınırı aştığında (normal eventler için MaxCalls, sıkı eventler için StrictMaxCalls) Event Guard bunu pencere başına bir kez CXA'ya bildirir. CXA cezayı EventAbuse (Server event istismarı) olarak uygular.
  5. BlockExceeded açıksa sınırın üstündeki her çağrı düşürülür ve scriptine hiç ulaşmaz.

Birkaç kural scriptlerini güvende tutar:

  • IgnoredEvents içindeki eventler hiçbir zaman sınırlanmaz.
  • Arkasında oyuncu olmayan, sunucunun kendisinin yaptığı çağrılar hiç sayılmaz.
  • cxa-anticheat çalışmıyorsa veya lisans aktif değilse Event Guard her çağrıyı geçirir; scriptlerin çalışmaya devam eder.
  • Korunan her resource ayarlarını CXA başladıktan 5 saniye sonra, ardından 60 saniyede bir CXA'dan okur. Paneldeki değişiklikler bir dakika içinde korunan tüm resource'lara ulaşır, resource'u yeniden başlatman gerekmez.
  • Muaf yetkililer hiçbir zaman cezalandırılmaz, ama BlockExceeded açıksa onların da sınır üstü çağrıları düşürülür.

Event Guard'ı Kurmak

Adım 1 — cxainject Komutunu Çalıştır

Sunucu konsoluna şunu yaz (txAdmin Live Console da olur):

Console
cxainject

Ne olur:

  • CXA sunucundaki her resource'u alfabetik sırayla dolaşır.
  • Resource'un fxmanifest.lua (veya __resource.lua) dosyasına, fx_version satırının hemen altına şu satırı ekler: server_script '@cxa-anticheat/lib/eventguard.lua'
  • cxa-anticheat'in kendisini, Inject edilmeyecekler (Inject.IgnoreResources) listesindeki her resource'u, satırı zaten olan resource'ları, sunucu tarafında Lua'sı olmayanları (.lua dosyalı server_script veya shared_script yoksa) ve Escrowlu resourceları atla açıksa .fxap dosyası olan her resource'u (escrow korumalı resource'lar) atlar.
  • Admin Discord kanalına bir özet yazar.

Çıktı:

Output
[CXA] Event Guard injected into 42 resource(s), 3 already had it, 17 skipped, 0 failed.
[CXA] Injected: my-delivery, my-shop, my-garage
[CXA] Restart the server (or the listed resources) to apply.

(Event Guard 42 resource'a eklendi, 3 tanesinde zaten vardı, 17 atlandı, 0 başarısız; eklenenler listesi; uygulamak için sunucuyu veya listelenen resource'ları yeniden başlat.) Sayılar ve isimler sende farklı olur. Config.Locale Türkçe ise bu satırlar Türkçe yazılır. 40'tan fazla isim içeren listeler + ve gösterilmeyen isim sayısıyla biter. CXA bir dosyayı yazamazsa sarı bir satır o resource'ları listeler:

Output
[CXA] Failed: my-locked-resource

Panel de aynı işi yapar: Komutlar → Event Guard ekle. Lisansın sahibi ve adminleri kullanabilir.

Adım 2 — Yeniden Başlat

Yeni satır sadece resource başlarken yüklenir. Bu yüzden sunucunun tamamını ya da en azından Injected: sonrasında listelenen resource'ları yeniden başlat.

Varsayılan Yoksayma Listesi

Inject edilmeyecekler listesinde zaten monitor, sessionmanager, mapmanager, spawnmanager, hardcap, rconlog, chat, yarn, webpack, baseevents, oxmysql ve screenshot-basic var. CXA'nın dokunmasını istemediğin her resource'u cxainject çalıştırmadan önce ekle.

Event Guard'ı Kaldırmak

Satırı tüm resource'lardan tekrar kaldırmak için şunu yaz:

Console
cxauninject

Çıktı:

Output
[CXA] Event Guard removed from 42 resource(s), 20 did not have it, 0 failed.
[CXA] Injected: my-delivery, my-shop, my-garage
[CXA] Restart the server (or the listed resources) to apply.

İkinci satır burada da Injected: ile başlar; değiştirilen resource'ları listeler. Sonrasında yeniden başlat. Paneldeki buton Komutlar → Event Guard kaldır.

İki komut da sadece sunucu konsolundan veya panelden çalışır. Oyun sohbetine yazılırsa This command can only be used from the server console. (bu komut sadece sunucu konsolundan kullanılabilir) cevabını verir. İsimlerini Yapılandırma → Yetkili rolleri & komutlar → Komutlar altında değiştirebilirsin.

Elle Kurulum

Tek bir resource'u elle korumak için fxmanifest.lua dosyasını aç ve Event Guard satırını cxainject'in kullandığı yere, fx_version satırının hemen altına ekle:

fx_version 'cerulean'
server_script '@cxa-anticheat/lib/eventguard.lua' -- CXA Event Guard, diğer tüm scriptlerin üstünde kalsın
game 'gta5'

shared_script 'config.lua'
client_script 'client/main.lua'
server_script 'server/main.lua'

Sonra o resource'u yeniden başlat. Satır, resource'un kendi server scriptlerinden önce gelmeli; çünkü Event Guard sadece kendisi yüklendikten sonra kaydedilen eventleri sarabilir.

Yapılandırma

Panelde Yapılandırma → Server tespitleri → Event Guard bölümünü aç. Değişiklikler bir dakika içinde korunan tüm resource'lara uygulanır.

AyarAnahtarVarsayılanNe yapar
Aktif (anahtar)EnabledtrueEvent Guard'ı korunan tüm resource'lar için açar veya kapatır
CezaPunishmentkickSınırı aşan oyuncuya ne olacağı
Ban süresiBanDuration0Saat, 0 = kalıcı. Sadece ban cezasında kullanılır
Ekran görüntüsüScreenshotfalseDiscord loguna ekran görüntüsü ekler
Event başına maks çağrıMaxCalls25Bir oyuncunun bir eventi Pencere başına kaç kez çağırabileceği
PencereWindow5 snSayım penceresinin uzunluğu
Sıkı eventlerStrictEventsboşPara, item veya ödül veren eventler. Sıkı sınırı kullanırlar
Sıkı maks çağrıStrictMaxCalls5Sıkı eventler için Pencere başına sınır
Yoksayılan eventlerIgnoredEventsboşHiçbir zaman sınırlanmayan eventler
Limit üstü çağrıları engelleBlockExceededtrueSınırın üstündeki çağrıları düşürür. Kapalıysa çağrılar yine çalışır, sadece ceza uygulanır
Inject edilmeyeceklerInject.IgnoreResourcesyukarıya bakcxainject'in hiç dokunmadığı resource'lar
Escrowlu resourceları atlaInject.SkipEscrowedfalse.fxap dosyası olan resource'lara dokunmaz

Aynı ayarlar config.lua içinde (event isimleri örnektir, kendi isimlerini kullan):

Config.EventGuard = {
    Enabled = true,
    Punishment = 'kick',
    BanDuration = 0,
    MaxCalls = 25,                                   -- Pencere başına oyuncu başına bir eventin çağrı sayısı
    Window = 5,                                      -- saniye
    StrictEvents = { 'my-delivery:server:payout' },  -- örnek: para ödeyen bir event
    StrictMaxCalls = 5,
    IgnoredEvents = { 'my-hud:server:syncStatus' },  -- örnek: tasarımı gereği çok sık tetiklenen bir event
    BlockExceeded = true,                            -- sınır üstü çağrıları düşür
    Screenshot = false,
    Inject = {
        IgnoreResources = { 'monitor', 'sessionmanager', 'mapmanager', 'spawnmanager', 'hardcap', 'rconlog', 'chat', 'yarn', 'webpack', 'baseevents', 'oxmysql', 'screenshot-basic' },
        SkipEscrowed = false,                        -- true = .fxap resource'larına dokunma
    },
}

Sıkı Eventleri Seçmek

Sıkı eventler, bir hilecinin spamlamak isteyeceği eventlerdir: sunucu tarafındaki işleyicisi para, item, tecrübe puanı veya başka bir ödül veren eventler. Bunları bulmak için resource'larının sunucu dosyalarında framework'ünün para ve item fonksiyonlarını ara, örneğin addMoney ve addInventoryItem (ESX) ya da AddMoney ve AddItem (QBCore), ve onları çağıran server eventini not et.

AI Asistanıyla Config bunu senin yerine yapar: prompt, asistandan ödül eventlerini StrictEvents'e, tasarımı gereği çok sık tetiklenen eventleri de IgnoredEvents'e koymasını ister.

Bir Event Guard Logunu Okumak

Her Event Guard tespiti resource'u, eventi ve çağrı sayısını listeler; böylece hangi eventi ayarlayacağını tam olarak bilirsin:

Output
[CXA] John (ID: 12) -> Server event abuse [kick] calls: 26 in 5s, event: my-delivery:server:payout, resource: my-delivery

Bu dürüst bir oyuncuysa ve event bu sıklıkta tetiklenmek için tasarlandıysa onu Yoksayılan eventler'e ekle veya Event başına maks çağrı değerini yükselt.

Tuzak Eventler

Tuzak event, sunucundaki hiçbir scriptin kullanmadığı sahte bir server eventidir. Bazı hile menüleri eski scriptlerden bilinen event isimlerini çağırır; örneğin bir tespiti kapatmak veya başka oyuncuları atmak için. CXA Config.BlacklistedEvents içindeki her ismi bir server eventi olarak kaydeder ve bunlardan birini tetikleyen oyuncuyu BlacklistedEvent (Blacklist event kullandı) olarak işaretler. Bu, Event Guard olmadan da çalışır.

AyarAnahtarVarsayılanNe yapar
Tuzak eventler (anahtar)Config.ServerDetections.BlacklistedEvents.EnabledfalseTuzağı açar
CezaPunishmentlogTuzak eventi tetikleyen oyuncuya ne olacağı
Tuzak eventler (liste)Config.BlacklistedEvents7 isimSahte event isimleri

Varsayılan liste antilynx8:anticheat, antilynxr4:detect, antilynxr6:detection, ynx8:anticheat, HCheat:TempDisableDetection, mellotrainer:adminTempBan ve mellotrainer:adminKick isimlerini içerir. Anahtar Yapılandırma → Server tespitleri → Tuzak eventler altında, liste Yapılandırma → Listeler → Blacklistler → Tuzak eventler altındadır.

Sadece Kimsenin Kullanmadığı Eventleri Ekle

Resource'larından biri listedeki bir eventi gerçekten kullanıyorsa, o scripti kullanan her oyuncu tuzağa düşer. Bir ismi eklemeden önce resource'larında ara.

Ses Eventi İstismarı

InteractSound gibi ses resource'larının, diğer oyunculara ses çalan server eventleri vardır. Hileciler bunları tüm sunucuya yüksek sesler çalmak için çağırır. Ses istismarı (SoundAbuse) bu eventleri izler; Window saniye içinde bunları MaxCalls defadan fazla çağıran veya MaxDistance üstünde bir çalma yarıçapı isteyen oyuncuyu cezalandırır.

AyarAnahtarVarsayılanNe yapar
CezaPunishmentkickİstismar edene ne olacağı
Ses eventleriEvents4 InteractSound eventiİzlenen eventler
Maks çağrıMaxCalls8Pencere başına oyuncu başına izin verilen çağrı
PencereWindow10 snSayım penceresinin uzunluğu
Maks ses mesafesiMaxDistance30 mDaha büyük yarıçaplı bir PlayWithinDistance çağrısı işaretlenir

Varsayılan eventler InteractSound_SV:PlayOnAll, InteractSound_SV:PlayWithinDistance, InteractSound_SV:PlayOnSource ve InteractSound_SV:PlayOnOne'dır. Ayarları Yapılandırma → Server tespitleri → Ses istismarı altında bulursun. Bu kontrol oyuncuyu cezalandırır ama ses resource'unun çağrıyı işlemesini durdurmaz; bu yüzden ses resource'una da Event Guard ekle.

Oyun Eventi Kontrolleri

Scriptlerinin eventlerinin yanında, oyunun kendisi de bazı işlemleri sunucuya bildirir; örneğin başka bir pede silah vermek veya ateş başlatmak. CXA bunları Event Guard olmadan sunucuda kontrol eder:

EventTespitVarsayılanNeyi durdurur
giveWeaponEventSilah verme (GiveWeapon)banBaşka bir oyuncuya silah vermeyi, bir mod menü özelliği
removeWeaponEvent, removeAllWeaponsEventSilah silme (RemoveWeapon)banBaşka bir oyuncunun silahlarını silmeyi
clearPedTasksEventPed task temizleme (ClearPedTasks)kickOyuncuları araçtan atmayı veya dondurmayı
startProjectileEventMermi / roket (BlacklistedProjectile, ProjectileSpam)ban, spam kickBlacklist silahların mermilerini ve 5 saniyede 25'ten fazla mermiyi
ptFxEventEfekt spamı (ParticleSpam)kick5 saniyede 30'dan fazla efekti
fireEventAteş spamı (FireSpam)kick5 saniyede 20'den fazla ateşi
weaponDamageEventSilah hasarı, İmkansız hasar, Silent aim ve fazlasıdeğişirBlacklist silahlarla hasarı ve imkansız isabetleri
Sohbet mesajlarıChat filtresi (ChatFilter)banChat kelimeleri listesindeki kelimeleri içeren mesajları
explosionEventPatlamalardeğişirBkz. Patlama Kontrolü
entityCreatingEntity blacklist ve Entity spamlogBkz. Entity Kontrolü

Silah verme, Silah silme ve Ped task temizleme'nin iki ek anahtarı vardır: Engelle işlemi iptal eder; Sadece oyuncu hedefleri ise yalnızca hedef başka bir oyuncu olduğunda işlem yapar, böylece bir NPC'ye silah veren bir script cezalandırılmaz. Hepsi Yapılandırma → Server tespitleri altındadır.

Öneriler

Önerilir:

  • CXA'yı kurduktan sonra cxainject komutunu bir kez, yeni resource eklediğinde de tekrar çalıştır. Satırı zaten olan resource'lar atlanır.
  • Her ödül eventini Sıkı eventler'e koy. Hilecilerin hedeflediği eventler bunlardır.
  • Kalabalık bir sunucuda Event Guard'ı ilk günler log olarak tut; gürültülü eventleri Yoksayılan eventler'e taşıdıktan sonra kick yap.
  • CXA'yı sunucundan kaldırmadan önce cxauninject çalıştır, çünkü satır cxa-anticheat klasörünün içindeki bir dosyayı gösterir.

Kaçın:

  • Sadece logları susturmak için Limit üstü çağrıları engelle ayarını kapatmaktan. Çağrılar o zaman yine scriptlerine ulaşır.
  • Scriptlerinin kullandığı eventleri tuzak listesine eklemekten.
  • Sadece Event Guard'a güvenmekten. Scriptlerin bir ödülün verilebilir olduğunu yine sunucu tarafında kontrol etmeli.

Tespitler ve Cezalar

  • Event Guard diğer tüm tespitlerle aynı cezaları, bekleme sürelerini ve uyarıları kullanır.
  • Event istismarı EventAbuse (Server event istismarı) olarak loglanır.
  • Bkz. Tespitler ve Cezalar.

Uzaktan İşlemler

  • Panelin Komutlar sekmesinde Event Guard ekle ve Event Guard kaldır butonları vardır.
  • cxainject ve cxauninject ile aynı işi yaparlar ve önce onay isterler.
  • Bkz. Uzaktan İşlemler.

Konsol ve Sohbet Komutları

  • cxainject ve cxauninject sadece konsolda çalışan komutlardır; oyundaki bir yetkili resource'larını düzenleyemez.
  • İsimleri Yapılandırma → Yetkili rolleri & komutlar → Komutlar altında belirlenir.
  • Bkz. Konsol ve Sohbet Komutları.

Banlar ve CXA Ağı

  • EventAbuse ve BlacklistedEvent varsayılan Paylaşılan tespitler listesindedir; bu tespitlerden gelen otomatik banlar CXA ağıyla paylaşılabilir.
  • Bkz. Banlar ve CXA Ağı.

Sık Karşılaşılan Sorunlar

"This command can only be used from the server console."

Ne görürsün: Oyun sohbetine /cxainject veya /cxauninject yazdın ve bu cevabı aldın (bu komut sadece sunucu konsolundan kullanılabilir).

Nasıl düzeltilir:

  • Komutu eğik çizgi olmadan sunucu konsoluna veya txAdmin Live Console'a yaz.
  • Ya da paneldeki Komutlar → Event Guard ekle butonunu kullan.

Bir Resource Atlandı

Ne görürsün: Özette atlanan resource'lar var ve senin resource'lardan biri Injected: listesinde yok.

Nasıl düzeltilir:

  • Resource'un sunucu tarafında Lua'sı var mı kontrol et. Sadece client tarafı olan resource'lar bilerek atlanır; koruyacak server eventleri yoktur.
  • Inject edilmeyecekler listesine bak. Resource listede olabilir.
  • Escrowlu resourceları atla açıksa .fxap dosyası olan resource'lar atlanır.
  • Resource'ta satır zaten varsa "zaten vardı" olarak sayılır, eklenmiş olarak değil.

Oyuncular Normal Oynarken "Server event abuse" ile Atılıyor

Ne görürsün: Dürüst oyuncular Server event abuse (Server event istismarı) sebebiyle atılıyor, hep aynı event için.

Nasıl düzeltilir:

  • Logdaki event ve resource alanlarını oku.
  • Event tasarımı gereği sık tetikleniyorsa (örneğin bir HUD veya durum senkronu) onu Yoksayılan eventler'e ekle.
  • Bazı işlemlerin hızlı çağırdığı normal bir eventse Event başına maks çağrı veya Pencere değerini yükselt.
  • Sıkı bir eventse Sıkı maks çağrı değerini biraz yükselt.
  • Test ederken Cezayı log yap.

Event Guard Hiçbir Şey Yapmıyor Gibi

Ne görürsün: Event Guard'ı ekledin ama bir testte eventi spamlamak hiçbir şeyi tetiklemiyor.

Nasıl düzeltilir:

  • Sunucuyu yeniden başlat. Satır sadece resource başlarken yüklenir.
  • Resource'un fxmanifest.lua dosyasını aç; satırın orada ve resource'un kendi server scriptlerinin üstünde olduğunu kontrol et.
  • CXA'nın çalıştığından ve lisansın aktif olduğundan emin ol. Aksi halde Event Guard her çağrıyı geçirir.
  • Muaf olmayan bir oyuncuyla test et. Muaf yetkililer hiçbir zaman cezalandırılmaz.
  • Eventin Yoksayılan eventler içinde olmadığını kontrol et.

© 2026 CodeXart Studios · CXA Anticheat