Kural Motoru
Kural motoru, yerleşik tespitlerin üstüne kod yazmadan kendi kontrollerini eklemeni sağlar. Bir kural şunu söyler: bu olduğunda ve şu doğruysa, bunu yap. Örneğin kimsenin spawn etmemesi gereken bir araç modelini engelle ya da birkaç günlük Discord hesaplarını geri çevir.
Örnek Kurallar Kapalı Gelir
CXA iki örnek kuralla gelir: block_adder ve new_discord_accounts. İkisi de kapalıdır. Aç, nasıl kurulduklarını oku, sonra değiştir ya da etkinleştir.
Nasıl Çalışır
Bir kuralın dört parçası vardır:
| Parça | Paneldeki adı | Config anahtarı | Nedir |
|---|---|---|---|
| Olay | Ne zaman | Event | Kontrolü başlatan oyun olayı, örneğin bir aracın spawn edilmesi. |
| Koşul | Koşul | Condition | Kısa bir test, örneğin model == 'adder'. |
| İşlemler | O zaman | Actions | Koşul doğru olduğunda ne olacağı, örneğin block ve log. |
| Sebep | Loglarda görünen sebep | Reason | Loglarda, kick ekranlarında ve ban kayıtlarında görünen metin. |
- Anticheat başlarken CXA açık olan her kuralı okur ve koşulunu bir kez çözümler. Okuyamadığı bir koşul, konsolda bir uyarıyla atlanır.
- CXA bir olayı ancak en az bir açık kural onu kullanıyorsa dinler. Hiçbir kuralın kullanmadığı olaylar hiçbir maliyet getirmez.
- Olay her gerçekleştiğinde CXA o olaydaki tüm açık kuralları kontrol eder. Eşleşen her kural kendi işlemlerini uygular.
- Anticheat'ten muaf yetkililer hiçbir zaman eşleşmez.
playerConnectingolayında yalnızca Bypass Identifierlar listesi dikkate alınır. Bkz. Yetkili Muafiyeti. - Kurallar yerleşik tespitlerin üstünde çalışır. Hiçbir tespiti kapatmazlar.
Kurulum
Adım 1 — Kuralları Aç
Web panelinde Yapılandırma → Ağ & kurallar → Güvenlik kuralları bölümünü aç. Her kural, açılıp kapanabilen bir satırdır; sağında bir açma/kapama anahtarı bulunur.
Adım 2 — Kural Ekle
"Yeni kural adı, örn. block_tanks" yazan alana bir ad yaz ve Kural ekle'ye tıkla. Ad küçük harfe çevrilir; a-z, 0-9 ve _ dışındaki karakterler _ olur. En fazla 32 karakter olabilir.
Yeni kural kapalı olarak, Entity oluşturuldu olayında, model == 'adder' koşulu ve Engelle ile Log işlemleriyle başlar; böylece düzenleyebileceğin bir örneğin olur.
Adım 3 — Olayı Seç ve Koşulu Yaz
Ne zaman altında olayı seç. Sonra Koşul altına koşulu yaz. Alanın altındaki satır kullanabileceğin alanları listeler, örneğin Alanlar: model, type, script. Panel koşulu okuyamazsa bu satır kırmızıya döner ve nedenini açıklar; kuralda da Hata rozeti çıkar.
Adım 4 — İşlemleri ve Sebebi Seç
O zaman altında Engelle, Log, Uyar, Kick ve Ban düğmelerinden bir veya birkaçına tıkla. Loglarda görünen sebep alanına en fazla 120 karakterlik kısa bir sebep yaz. Sebep yazmazsan kural adı kullanılır.
Adım 5 — Kuralı Aç ve Kaydet
Kuralın anahtarını aç ve Değişiklikleri kaydet'e tıkla. Sunucun bir dakika içinde alır ve anticheat'i yeniden yükler.
config.lua İçinde Kurallar
config.lua içinde ve Kodu içe aktar'a yapıştırdığın kodda kurallar Config.Rules altında durur. Her kural, kendi adının altında bir tablodur:
Config.Rules = {
block_lazer = { -- Kural adı: a-z, 0-9 ve _
Enabled = true, -- false = kural yok sayılır
Event = 'entityCreating', -- Ne zaman: aşağıdaki beş olaydan biri
Condition = "model == 'lazer' and script == true", -- Dışta çift tırnak, içte tek tırnak
Actions = { 'block', 'log' }, -- O zaman: block, log, warn, kick, ban
Reason = 'Spawned a fighter jet', -- Loglarda görünür
},
}Kodu içe aktar, yapıştırdığın kuralları mevcut kurallarına ekler; diğerlerini silmez. Lisansın varken panelde kaydedilen kurallar config.lua içindekilerin yerine geçer.
Olaylar
| Olay | Paneldeki adı | Ne zaman tetiklenir | block ne yapar |
|---|---|---|---|
entityCreating | Entity oluşturuldu | Bir oyuncunun oyunu ağda bir araç, ped veya obje oluşturur | Varlık oluşturulmaz. |
explosionEvent | Patlama | Bir oyuncunun oyunu bir patlama bildirir | Patlama iptal edilir. |
weaponDamageEvent | Silah hasarı | Bir oyuncunun oyunu başka bir pede veya oyuncuya hasar bildirir | Hasar iptal edilir. |
chatMessage | Chat mesajı | Bir oyuncu standart chat resource'u üzerinden mesaj gönderir | Mesaj gönderilmez. |
playerConnecting | Oyuncu bağlanıyor | Bir oyuncu sunucuya bağlanır | Bağlantı reddedilir. |
Alanlar
| Alan | Açıklama | Kullanıldığı olay |
|---|---|---|
model | Varlığın modeli. Adı tırnak içinde yaz, örneğin 'adder'. CXA bunu oyunun hash değerine çevirir. | entityCreating |
type | Varlığın türü: 1 = ped, 2 = araç, 3 = obje. | entityCreating |
script | Varlığı bir script oluşturduysa true, trafik ve diğer ortam nüfusu için false. | entityCreating |
type | Patlama türü numarası; patlama türleri listesindeki numaralarla aynı, örneğin 7 = Car, 37 = ProxMine. | explosionEvent |
damageScale | Patlamanın hasar çarpanı. | explosionEvent |
invisible | Patlama görünmezse true. | explosionEvent |
audible | Patlama ses çıkarıyorsa true. | explosionEvent |
weapon | Silah. Adı tırnak içinde yaz, örneğin 'WEAPON_PISTOL'. CXA bunu oyunun hash değerine çevirir. | weaponDamageEvent |
damage | Vuruşun hasarı, sayı olarak. | weaponDamageEvent |
distance | Ateş eden ile vurulan varlık arasındaki metre. CXA hedefi bulamazsa 0. | weaponDamageEvent |
headshot | Vuruş kafaya geldiyse true. | weaponDamageEvent |
message | Chat mesajının tam metni. | chatMessage |
name | Oyuncunun FiveM adı. | playerConnecting |
discordAge | Oyuncunun Discord hesabının gün olarak yaşı, Discord ID'sinden hesaplanır. Oyuncunun Discord identifier'ı yoksa boştur. | playerConnecting |
hasDiscord | Oyuncunun Discord identifier'ı varsa true. | playerConnecting |
hasSteam | Oyuncunun Steam identifier'ı varsa true. | playerConnecting |
identifiers | Oyuncunun kaç identifier ile bağlandığı. | playerConnecting |
Alan adları büyük/küçük harfe duyarlıdır. discordage değil, discordAge yaz.
Koşul Dili
Karşılaştırmalar
| Operatör | Anlamı | Örnek |
|---|---|---|
== | Eşit | model == 'adder' |
~= veya != | Eşit değil | type ~= 2 |
< | Küçük | discordAge < 30 |
<= | Küçük veya eşit | damage <= 0 |
> | Büyük | distance > 300 |
>= | Büyük veya eşit | damageScale >= 2 |
contains | Metin bu parçayı içeriyor | message contains 'discord.gg' |
==ve~=sayıları sayı olarak, geri kalan her şeyi büyük/küçük harfe bakmadan metin olarak karşılaştırır.name == 'ADMIN',adminile de eşleşir.<,<=,>ve>=yalnızca sayılarla çalışır. Taraflardan biri sayı değilse karşılaştırma yanlış olur. Discord'u olmayan bir oyuncunundiscordAgedeğeri yoktur, bu yüzdendiscordAge < 30onun için yanlıştır.containsbir metin parçası arar ve büyük/küçük harfe bakmaz. Küçük harfle ve iki yanında boşlukla yaz.
Değerler
- Metin tek veya çift tırnak içine yazılır:
'adder'ya da"adder". Tırnaksız metin okunamaz. - Sayılar olduğu gibi yazılır:
30,1.5. truevefalsetırnaksız yazılır.modelveweaponiçin adı yaz. CXA bunu oyunun hash değerine çevirdiği için büyük/küçük harf önemli değildir:'WEAPON_PISTOL'ile'weapon_pistol'aynıdır. Sayı olarak bir hash de çalışır.- CXA adları değil hash değerlerini karşılaştırdığı için
contains, model veya silah adlarının içinde arama yapmaz. Bu alanlarda==veya~=kullan. config.luaiçinde koşulun tamamı bir Lua metnidir. Dışına çift tırnak, içine tek tırnak koy:Condition = "model == 'adder'". Panelde yalnızca koşulun kendisini yazarsın.
and / or ile Birleştirmek
and, her parçanın doğru olması gerektiği anlamına gelir.or, en az bir parçanın doğru olması gerektiği anlamına gelir.and,or'dan önce değerlendirilir.a or b and c,a or (b and c)demektir.- Parantez desteklenmez.
(a or b) and cyerinea and c or b and cyaz. andveorbüyük/küçük harfe bakmaz ama iki yanında boşluk ister.- Tırnak içindeki metin, iki yanında boşluk olan and veya or kelimelerini içeremez; çünkü CXA koşulu önce bu kelimelerden böler.
Örnek: hasDiscord == false or discordAge < 7, Discord'u olmayan oyuncularla Discord hesabı 7 günden yeni olan oyuncuları yakalar.
İşlemler
| İşlem | Paneldeki düğme | Oyun içi olaylarda | playerConnecting olayında |
|---|---|---|---|
block | Engelle | Olayı iptal eder: varlık, patlama, hasar veya chat mesajı hiç gerçekleşmez. | Oyuncuyu Bu sunucuya giremezsin: <sebep> mesajıyla reddeder. |
log | Log | Bir Güvenlik kuralı tespiti loglar: Detections kanalı, panelin Tespitler sekmesi, konsol ve oyun içi yetkili uyarısı. | Connections kanalına Güvenlik kuralı eşleşti kaydı yazar. |
warn | Uyar | Oyuncuya ekranda bir uyarı gösterir ve Warns kanalına loglar. | Etkisi yoktur. |
kick | Kick | Oyuncuyu senin sebebinle sunucudan atar ve Kicks kanalına loglar. | Oyuncuyu block gibi reddeder ve Connections kanalına loglar. |
ban | Ban | Oyuncuyu kalıcı olarak banlar, sunucudan atar ve Bans kanalına loglar. | Oyuncuyu kalıcı olarak banlar, ban ekranını gösterir ve Connections kanalına loglar. |
- Bir kural yalnızca bir ceza uygular: seçtiklerin içindeki en güçlüsünü. Sıra
ban, sonrakick, sonrawarn, sonralog.blockbunların hepsine eklenebilir. - Oyun içi olaylarda yalnızca
blockseçili bir kural olayı log yazmadan, sessizce iptal eder. Görmek içinlogekle. - Kurallardan gelen banlar her zaman kalıcıdır. Ban sebebi senin yazdığın sebeptir.
warn, dil ayarı Türkçe ikenAnticheat uyarısı: Güvenlik kuralı. Devam edersen sunucudan atılırsın.gösterir.- Varsayılan Paylaşılan tespitler listesiyle kurallardan gelen banlar CXA ağıyla paylaşılmaz.
Hazır Gelen Örnek Kurallar
İki kural da Enabled = false ile gelir:
Config.Rules = {
block_adder = {
Enabled = false,
Event = 'entityCreating',
Condition = "model == 'adder'", -- Trafikten gelenler dahil her adder
Actions = { 'block', 'log' },
Reason = 'Spawned an adder',
},
new_discord_accounts = {
Enabled = false,
Event = 'playerConnecting',
Condition = 'discordAge < 30', -- 30 günden yeni Discord hesabı
Actions = { 'block', 'log' },
Reason = 'Discord account younger than 30 days',
},
}block_adder, trafikteki adderlar dahil her adder ile eşleşir. Kullanmadan önce aşağıdaki ilk örnekteki gibi and script == true ekle.
Örnekler
Bir Araç Modelini Engelle
Oyuncuların bir scriptle savaş uçağı spawn etmesini durdur; trafik etkilenmesin.
- Ne zaman: Entity oluşturuldu
- Koşul:
model == 'lazer' and script == true - O zaman: Engelle, Log
block_lazer = {
Enabled = true,
Event = 'entityCreating',
Condition = "model == 'lazer' and script == true", -- Trafik değil, sadece script spawnları
Actions = { 'block', 'log' },
Reason = 'Spawned a fighter jet',
},Yeni Discord Hesaplarını Reddet
7 günden yeni Discord hesaplarını geri çevir. İkinci kural, hiç Discord'u olmayan oyuncuları da reddeder.
young_discord = {
Enabled = true,
Event = 'playerConnecting',
Condition = 'discordAge < 7', -- Discord'u olmayan oyuncular bundan geçer
Actions = { 'block', 'log' },
Reason = 'Discord account younger than 7 days',
},
discord_required = {
Enabled = true,
Event = 'playerConnecting',
Condition = 'hasDiscord == false or discordAge < 7', -- Discord yok ya da çok yeni
Actions = { 'block', 'log' },
Reason = 'Discord missing or younger than 7 days',
},Reddedilen oyuncular dil ayarı Türkçe iken Bu sunucuya giremezsin: Discord account younger than 7 days görür. Sebebi istediğin dilde yazabilirsin.
Bir Silahı Logla
Biri 300 metreden uzaktan heavy sniper ile bir hedefi vurduğunda, hiçbir şeyi engellemeden log yaz.
log_long_sniper = {
Enabled = true,
Event = 'weaponDamageEvent',
Condition = "weapon == 'WEAPON_HEAVYSNIPER' and distance > 300", -- Mesafe metre cinsinden
Actions = { 'log' },
Reason = 'Heavy sniper hit from over 300 m',
},Chat'te Davet Linklerini Engelle
Discord daveti içeren chat mesajlarını durdur ve göndereni uyar.
no_invites = {
Enabled = true,
Event = 'chatMessage',
Condition = "message contains 'discord.gg/'", -- Büyük/küçük harf duyarsız
Actions = { 'block', 'warn' },
Reason = 'Posted a Discord invite',
},Panel Doğrulama Mesajları
Panel her kuralı sen yazarken, kaydederken ve kod içe aktarırken kontrol eder. Okuyamadığı bir kuralı kaydedemezsin.
| Mesaj | Anlamı |
|---|---|
Bir koşul yaz. | Koşul boş. |
"..." okunamadı. | Koşulun bir parçası okunamadı: tırnaksız metin, eksik değer, yanlış yazılmış operatör veya parantez. Tırnak içindeki kısım yerini gösterir. |
"..." bu olayın alanı değil. | Bu alan seçilen olayda yok ya da büyük/küçük harfi farklı. |
Bilinmeyen olay. | Olay, desteklenen beş olaydan biri değil. |
... kuralı: en az bir işlem seç. | Kuralda hiç işlem seçili değil. |
"..." kural adı sadece a-z, 0-9 ve _ içerebilir. | İçe aktarılan kodda başka karakterler içeren bir kural adı var. |
Maksimum 50 kural. | Sunucun kural sınırına ulaştı. |
Panel İngilizce açıksa aynı mesajları İngilizce görürsün, örneğin Cannot read "...". config.lua içinde yazılan kurallar için ise konsol sarı bir uyarı gösterir ve kuralı atlar:
[CXA] Security rule block_lazer has an invalid condition near: model == lazer(block_lazer güvenlik kuralının koşulu "model == lazer" kısmında geçersiz.)
Sınırlar ve Performans
| Sınır | Değer |
|---|---|
| Sunucu başına kural | 50 |
| Kural adı | a-z, 0-9 ve _, en fazla 32 karakter |
| Koşul | En fazla 300 karakter |
| Sebep | En fazla 120 karakter |
- Koşullar her olayda değil, anticheat başlarken bir kez çözümlenir.
- CXA yalnızca en az bir açık kuralın kullandığı olayları dinler.
- Dolu bir sunucuda Entity oluşturuldu ve Silah hasarı çok sık tetiklenir; bu olaylardaki her açık kural her seferinde kontrol edilir. Bu kuralları az, koşullarını kısa tut.
- Tüm kurallar tek bir tespit adını paylaşır:
SecurityRule. Bir oyuncu içinlogveyawarnyazıldıktan sonra, aynı oyuncunun sonrakilogveyawarneşleşmeleri Tespit bekleme süresi (Config.Logs.DetectionCooldown, varsayılan 10 saniye) boyunca atlanır. Engelleme yine her seferinde olur.
Öneriler
Önerilir:
- Yeni bir kurala yalnızca Log ile başla. Birkaç gün logları kontrol et, sonra Engelle, Kick veya Ban ekle.
- Trafik hiç eşleşmesin diye Entity oluşturuldu kurallarına
script == trueekle. - Açık bir sebep yaz. Oyuncular bunu kick ekranlarında ve ban kayıtlarında görür.
- Bir Discord kuralı Discord'u olmayan oyuncuları da kapsamalıysa
hasDiscord == false or ...kullan.
Kaçın:
- Test etmediğin bir kuralda Ban'dan. Kurallardan gelen banlar kalıcıdır.
- Blacklist araçlar veya chat kelimeleri gibi yerleşik bir tespiti tekrar eden kurallardan. Bunun yerine tespiti ve kendi ayarlarını kullan.
- Silah hasarı olayında çok sayıda kuraldan. Bu olay her vuruşta tetiklenir.
İlgili Özellikler
Giriş Taraması
playerConnectingkuralları, oyuncular bağlanırken yerleşik giriş kontrollerinin yanında çalışır.- Bkz. Giriş Taraması.
Entity Kontrolü
- Entity blacklistleri listedeki araçları, pedleri ve objeleri zaten engeller. Kurallar, listelerin ifade edemediği koşulları ekler.
- Bkz. Entity Kontrolü.
Patlama Kontrolü
- Patlama türleri ve numaraları orada listelenir.
- Bkz. Patlama Kontrolü.
Tespitler ve Cezalar
- Kural cezaları, Güvenlik kuralı tespit adı altında tespit cezaları gibi çalışır.
- Bkz. Tespitler ve Cezalar.
Muafiyet ve Duraklatma Export'ları
PauseDetection(src, 'SecurityRule', seconds)bir oyuncu için kural cezalarını duraklatır. Engelleme yine olur.- Bkz. Muafiyet ve Duraklatma Export'ları.
Config Editörü
- Kodu içe aktar, birden fazla kuralı tek seferde eklemenin en hızlı yoludur.
- Bkz. Config Editörü.
Sınırlamalar
- Koşullar parantez desteklemez; tırnak içindeki metin, iki yanında boşluk olan and veya or kelimelerini içeremez.
- Yalnızca yukarıdaki tablodaki alanlar kullanılabilir.
- Kurallardan gelen banlar kalıcıdır; süre ayarı yoktur.
playerConnectingolayındawarnetkisizdir ve loglar yalnızca Discord'a gider. Panelin Tespitler sekmesinde görünmezler.- Chat mesajı kuralları yalnızca standart
chatresource'ununchatMessageeventi üzerinden gönderilen mesajları görür. - Kurallar hiçbir zaman ekran görüntüsü almaz.
Sık Karşılaşılan Sorunlar
Kural Panelde "Hata" Gösteriyor
Ne görürsün: Kuralda kırmızı bir Hata rozeti var ve kaydedemiyorsun.
Nasıl düzeltilir:
- Koşul altındaki kırmızı satırı oku. Hangi kısmın yanlış olduğunu söyler.
- Metni tırnak içine al, alan adlarını ipucu satırından kontrol et ve parantezleri kaldır.
Konsol "Security rule ... has an invalid condition near" Yazıyor
Ne görürsün: Başlangıçta konsol [CXA] Security rule <ad> has an invalid condition near: <metin> yazıyor.
Nasıl düzeltilir:
- Koşul
config.luadosyasından geliyor ve atlandı.near:sonrasında gösterilen kısmı düzelt. - Kuralı paneldeki Kodu içe aktar'a yapıştır; doğrulama mesajları neyin yanlış olduğunu tam olarak gösterir.
Kuralım Hiç Eşleşmiyor
Ne görürsün: Kural açık ama hiçbir şey engellenmiyor veya loglanmıyor.
Nasıl düzeltilir:
- Kuralın açık ve kaydedilmiş olduğunu kontrol et, sunucunun yeniden yüklenmesi için bir dakika bekle.
- Anticheat'ten muaf olmayan bir yetkiliyle test et. Muaf oyuncular hiçbir zaman eşleşmez.
- İşlemlere Log ekle. Yalnızca Engelle seçili bir kural sessizce iptal eder.
<ve>kontrollerinde alanın o oyuncu için bir sayı olduğundan emin ol. Discord'u olmayan oyunculardadiscordAgeboştur.
Discord'u Olmayan Oyuncular Yine de Giriyor
Ne görürsün: discordAge < 30 kuralı yeni hesapları reddediyor ama Discord'u hiç olmayan oyuncular rahatça giriyor.
Nasıl düzeltilir:
hasDiscord == false or discordAge < 30yaz.
Trafikteki Araçlar da Engelleniyor
Ne görürsün: Bir model kuralı o aracı trafikte çıktığında da engelliyor ve aracı oyununda oluşturan oyuncuyu logluyor.
Nasıl düzeltilir:
- Koşula
and script == trueekle.
Yalnızca İlk Eşleşme Loglanıyor
Ne görürsün: Bir oyuncu bir kuralı art arda birkaç kez tetikliyor ama yalnızca bir log çıkıyor.
Nasıl düzeltilir:
- Bu, Tespit bekleme süresidir. Aynı oyuncunun logları ve uyarıları
Config.Logs.DetectionCooldownsaniye boyunca atlanır. Her kaydı görmen gerekiyorsa Yapılandırma → Loglar → Loglama bölümünden düşür.
Sık Yapılan Koşul Hataları
-- ❌ Tırnaksız metin okunamaz
Condition = "model == adder"
-- ✅ Adları ve metinleri tırnak içine al
Condition = "model == 'adder'"
-- ❌ Alan adları büyük/küçük harfe duyarlıdır
Condition = "discordage < 30"
-- ✅ Alanı tam olarak listedeki gibi yaz
Condition = "discordAge < 30"
-- ❌ "contains" model adlarının içinde arama yapmaz
Condition = "model contains 'police'"
-- ✅ Her modeli == ile karşılaştır
Condition = "model == 'police' or model == 'police2'"
-- ❌ Parantez desteklenmez
Condition = "(type == 2 or type == 3) and script == true"
-- ✅ Ortak kısmı her grupta tekrar et
Condition = "type == 2 and script == true or type == 3 and script == true"
-- ❌ Tırnak içindeki " and " koşulu böler
Condition = "message contains 'cash and items'"
-- ✅ Her kelimeyi ayrı kontrol et
Condition = "message contains 'cash' and message contains 'items'"
-- ❌ "contains" küçük harfle yazılmalı
Condition = "message CONTAINS 'cheat'"
-- ✅ Operatörleri küçük harfle yaz
Condition = "message contains 'cheat'"© 2026 CodeXart Studios · CXA Anticheat