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
cxa-anticheatklasöründekilib/eventguard.luadosyasını bir resource'un ilk server scripti olarak eklersin; elle veyacxainjectile.- Dosya o resource içindeki
RegisterNetEvent,RegisterServerEventveAddEventHandlerfonksiyonlarını sarar. Böylece resource'un ondan sonra kaydettiği her server eventi önce Event Guard'dan geçer. - Her çağrı oyuncu ve event bazında sayılır. Sayım ilk çağrıyla başlar ve
Windowsaniye sonra sıfırlanır. - Bir oyuncu sınırı aştığında (normal eventler için
MaxCalls, sıkı eventler içinStrictMaxCalls) Event Guard bunu pencere başına bir kez CXA'ya bildirir. CXA cezayıEventAbuse(Server event istismarı) olarak uygular. BlockExceededaçı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:
IgnoredEventsiç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
BlockExceededaçı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):
cxainjectNe olur:
- CXA sunucundaki her resource'u alfabetik sırayla dolaşır.
- Resource'un
fxmanifest.lua(veya__resource.lua) dosyasına,fx_versionsatı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ı (.luadosyalıserver_scriptveyashared_scriptyoksa) ve Escrowlu resourceları atla açıksa.fxapdosyası olan her resource'u (escrow korumalı resource'lar) atlar.AdminDiscord kanalına bir özet yazar.
Çıktı:
[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:
[CXA] Failed: my-locked-resourcePanel 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:
cxauninjectÇıktı:
[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.
| Ayar | Anahtar | Varsayılan | Ne yapar |
|---|---|---|---|
| Aktif (anahtar) | Enabled | true | Event Guard'ı korunan tüm resource'lar için açar veya kapatır |
| Ceza | Punishment | kick | Sınırı aşan oyuncuya ne olacağı |
| Ban süresi | BanDuration | 0 | Saat, 0 = kalıcı. Sadece ban cezasında kullanılır |
| Ekran görüntüsü | Screenshot | false | Discord loguna ekran görüntüsü ekler |
| Event başına maks çağrı | MaxCalls | 25 | Bir oyuncunun bir eventi Pencere başına kaç kez çağırabileceği |
| Pencere | Window | 5 sn | Sayım penceresinin uzunluğu |
| Sıkı eventler | StrictEvents | boş | Para, item veya ödül veren eventler. Sıkı sınırı kullanırlar |
| Sıkı maks çağrı | StrictMaxCalls | 5 | Sıkı eventler için Pencere başına sınır |
| Yoksayılan eventler | IgnoredEvents | boş | Hiçbir zaman sınırlanmayan eventler |
| Limit üstü çağrıları engelle | BlockExceeded | true | Sınırın üstündeki çağrıları düşürür. Kapalıysa çağrılar yine çalışır, sadece ceza uygulanır |
| Inject edilmeyecekler | Inject.IgnoreResources | yukarıya bak | cxainject'in hiç dokunmadığı resource'lar |
| Escrowlu resourceları atla | Inject.SkipEscrowed | false | .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:
[CXA] John (ID: 12) -> Server event abuse [kick] calls: 26 in 5s, event: my-delivery:server:payout, resource: my-deliveryBu 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.
| Ayar | Anahtar | Varsayılan | Ne yapar |
|---|---|---|---|
| Tuzak eventler (anahtar) | Config.ServerDetections.BlacklistedEvents.Enabled | false | Tuzağı açar |
| Ceza | Punishment | log | Tuzak eventi tetikleyen oyuncuya ne olacağı |
| Tuzak eventler (liste) | Config.BlacklistedEvents | 7 isim | Sahte 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.
| Ayar | Anahtar | Varsayılan | Ne yapar |
|---|---|---|---|
| Ceza | Punishment | kick | İstismar edene ne olacağı |
| Ses eventleri | Events | 4 InteractSound eventi | İzlenen eventler |
| Maks çağrı | MaxCalls | 8 | Pencere başına oyuncu başına izin verilen çağrı |
| Pencere | Window | 10 sn | Sayım penceresinin uzunluğu |
| Maks ses mesafesi | MaxDistance | 30 m | Daha 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:
| Event | Tespit | Varsayılan | Neyi durdurur |
|---|---|---|---|
giveWeaponEvent | Silah verme (GiveWeapon) | ban | Başka bir oyuncuya silah vermeyi, bir mod menü özelliği |
removeWeaponEvent, removeAllWeaponsEvent | Silah silme (RemoveWeapon) | ban | Başka bir oyuncunun silahlarını silmeyi |
clearPedTasksEvent | Ped task temizleme (ClearPedTasks) | kick | Oyuncuları araçtan atmayı veya dondurmayı |
startProjectileEvent | Mermi / roket (BlacklistedProjectile, ProjectileSpam) | ban, spam kick | Blacklist silahların mermilerini ve 5 saniyede 25'ten fazla mermiyi |
ptFxEvent | Efekt spamı (ParticleSpam) | kick | 5 saniyede 30'dan fazla efekti |
fireEvent | Ateş spamı (FireSpam) | kick | 5 saniyede 20'den fazla ateşi |
weaponDamageEvent | Silah hasarı, İmkansız hasar, Silent aim ve fazlası | değişir | Blacklist silahlarla hasarı ve imkansız isabetleri |
| Sohbet mesajları | Chat filtresi (ChatFilter) | ban | Chat kelimeleri listesindeki kelimeleri içeren mesajları |
explosionEvent | Patlamalar | değişir | Bkz. Patlama Kontrolü |
entityCreating | Entity blacklist ve Entity spam | log | Bkz. 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
cxainjectkomutunu 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
logolarak tut; gürültülü eventleri Yoksayılan eventler'e taşıdıktan sonrakickyap. - CXA'yı sunucundan kaldırmadan önce
cxauninjectçalıştır, çünkü satırcxa-anticheatklasö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.
İlgili Özellikler
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.
cxainjectvecxauninjectile aynı işi yaparlar ve önce onay isterler.- Bkz. Uzaktan İşlemler.
Konsol ve Sohbet Komutları
cxainjectvecxauninjectsadece 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ğı
EventAbuseveBlacklistedEventvarsayı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
.fxapdosyası 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
eventveresourcealanları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ı
logyap.
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.luadosyası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