Banlar ve CXA Ağı

CXA Anticheat bir oyuncuyu banladığında, kendine ait bir ban ID'siyle bir ban kaydı oluşturur ve o oyuncuya bağlayabildiği her hesabı ve cihazı engeller. Sunucun otomatik banlarını CXA ağındaki diğer sunucularla paylaşabilir ve istersen başka sunucularda otomatik banlanmış oyuncuları da içeri almayabilir.

Global Banlar İsteğe Bağlıdır

Kendi otomatik banlarını paylaşmak varsayılan olarak açıktır. Başka sunucularda banlanmış oyuncuları engellemek ise Global banlıları engelle ayarını açana kadar kapalıdır. Manuel banlar asla paylaşılmaz.

Nasıl Çalışır

  1. ban cezalı bir tespit, bir yetkili komutu, web paneli, oyun içi panel veya kendi scriptlerinden biri ban oluşturur.
  2. Ban, CXA-7KQ2MX gibi bir ID alır. Kayıtta oyuncunun adı, sebep, tespit, tüm identifierlar (license: veya discord: gibi hesap kimlikleri), donanım tokenları, banı kimin attığı, ne zaman atıldığı ve ne zaman biteceği tutulur.
  3. Oyuncu sunucudan atılır ve ban ID'sinin yazdığı ban ekranını görür.
  4. Biri her bağlandığında CXA, onun identifierlarını ve donanım tokenlarını aktif banlarla karşılaştırır. Aktif banlar hafızada tutulur, bu yüzden bu kontrol veritabanını beklemez.
  5. Ban, paylaşım listendeki bir tespitten geldiyse hashlenmiş bir kopyası global ban olarak CXA ağına gönderilir.

Ban ID'leri ve Süreler

Her ban, Config.Ban.IdPrefix (varsayılan CXA-) ve Config.Ban.IdLength kadar rastgele karakterden (varsayılan 6) oluşan benzersiz bir ID alır. Karakterler büyük harf ve rakamdır; I, O, 0 ve 1 kullanılmaz. Böylece ID kolay okunur, örneğin CXA-7KQ2MX. Ön eki veya uzunluğu değiştirmek sadece yeni banları etkiler.

Süreler her zaman saat cinsindendir. 0 kalıcı demektir. Web paneli ve oyun içi panel en fazla 87600 saat kabul eder. Bir tespitin BanDuration değeri yoksa Config.Ban.DefaultDuration kullanılır (varsayılan 0, kalıcı). Süreli banlar kendiliğinden biter, onları kaldırman gerekmez.

Banlar Nerede Saklanır

DepolamaNeredeNe zaman kullanılır
oxmysql (varsayılan, önerilen)Veritabanındaki cxa_bans tablosu, otomatik oluşturulurMySQL olan her sunucu. Kaldırılan banlar tabloda active = 0 olarak kalır, geçmişin korunur.
jsonResource içindeki data/bans.jsonMySQL olmayan sunucular. Kaldırılan banlar dosyadan silinir.

[PERF] json ile her yeni ban veya ban kaldırma tüm dosyayı yeniden yazar. Binlerce banın olduğunda kullanma.

Storage oxmysql olduğu hâlde oxmysql 30 saniye içinde başlamazsa CXA JSON'a geçer ve oxmysql is not started, bans will be stored in data/bans.json yazar (oxmysql başlamadı, banlar data/bans.json dosyasına kaydedilecek). Depolama türünü değiştirmek mevcut banları bir yerden diğerine taşımaz.

Aktif banlar anticheat başlarken hafızaya yüklendiği için veritabanında elle yaptığın bir değişiklik, ban listesini paneldeki Banları yenile ile veya konsolda cxareload ile yenileyene kadar görülmez.

Banlar Nasıl Eşleştirilir

Bağlanan bir oyuncunun identifierlarından veya donanım tokenlarından biri aktif bir bana aitse oyuncu engellenir. Donanım tokenları, FiveM'in oyuncunun bilgisayarından ürettiği kimliklerdir. Hileci yeni bir Rockstar, Steam veya Discord hesabı açsa da aynı kalırlar; bu yüzden ban kaçırmaya karşı en güçlü korumadır.

Bu ayarları panelde Yapılandırma → Ban sistemi altında değiştir.

SeçenekAnahtarVarsayılanNe yapar
DepolamaBan.StorageoxmysqlBanların kaydedildiği yer, yukarıya bak.
Tablo adıBan.TableNamecxa_bansMySQL tablo adı. Sadece harf, rakam ve _.
Ban ID ön ekiBan.IdPrefixCXA-Her ban ID'sinin başındaki metin.
Ban ID uzunluğuBan.IdLength6Ön ekten sonraki rastgele karakter sayısı (4 ile 16 arası).
Varsayılan süreBan.DefaultDuration0Tespitin ban süresi yoksa kullanılan saat. 0 = kalıcı.
Otomatik ban verenBan.BannedByCXA AnticheatOtomatik banlarda banı veren olarak kaydedilen ad.
Eşleşecek identifierlarBan.MatchIdentifierslicense, license2, steam, discord, xbl, live, fivemEşleşme sayılan identifier türleri.
Donanım tokenlarını eşleştirBan.MatchTokenstrueAynı bilgisayarı yeni hesapta da engeller.
IP eşleştirBan.MatchIpfalseAynı IP adresini de engeller.
Identifierları genişletBan.ExtendIdentifierstrueBanlı oyuncu yeni bir hesapla girmeye çalışınca o hesabın identifierları ve tokenları bana eklenir.

IP Eşleştirme Masum Oyuncuları Banlayabilir

Aynı evde, yurtta veya internet kafede olan oyuncular ve mobil internet kullananların çoğu tek bir IP adresini paylaşır. IP eşleştir açıkken içlerinden birine atılan ban hepsini engeller. Net bir sebebin yoksa kapalı bırak, onun yerine donanım tokenlarına güven.

Config.Bypass.Identifiers listesindeki oyuncular bağlanırken ban kontrolünü atlar. Bkz. Yetkili Muafiyeti.

Banlı Oyuncu Ne Görür

Banlanan oyuncu bu ekranla sunucudan atılır. Tekrar girmeye çalışan oyuncu da aynı ekranı görür.

Output
CXA Anticheat

You are banned from this server.

Ban ID: CXA-7KQ2MX
Reason: Blacklisted weapon
Expires: Never (permanent)
Appeal: discord.gg/yourserver

CodeXart Studios wishes you a safe flight..
  • İlk satır, Yapılandırma → Genel → Sunucu adı (Config.ServerName) alanındaki sunucu adındır.
  • Süreli bir ban, bitiş tarihini sunucunun saat diliminde YYYY-AA-GG SS:DD biçiminde gösterir.
  • Appeal satırı Yapılandırma → Genel → İtiraz linki (Config.AppealUrl) alanından gelir. Varsayılan discord.gg/yourserver sadece yer tutucudur; kendi itiraz bağlantınla değiştir ya da satırı gizlemek için boş bırak.
  • Dil, Yapılandırma → Genel → Dil (Config.Locale) ayarına göre değişir. Türkçe seçiliyse ekranda "Bu sunucudan yasaklandın." yazar.

Oyunculardan itiraz ederken ban ID'sini göndermelerini iste. Bu ID ile banı cxabaninfo ile bulabilir ve tek adımda kaldırabilirsin.

Ban Atmak ve Kaldırmak

Kontrol Panelinden

Çevrimiçi bir oyuncuyu banlamak için:

  1. Oyuncular sekmesini aç ve Çevrimiçi görünümünde kal ya da Canlı harita sekmesini aç (bkz. 3D Harita).
  2. Oyuncunun satırındaki Banla simgesine bas ya da oyuncuyu açıp Şu an çevrimiçi altındaki Ban düğmesine bas.
  3. Oyuncuyu banla penceresinde Süre (saat, 0 = kalıcı) alanını doldur. Kalıcı, 1 gün, 3 gün, 1 hafta ve 30 gün düğmeleri bunu senin yerine doldurur.
  4. Bir Sebep yaz ve onayla.

Sunucun banı 30 saniye içinde uygular. Yeni ban ID'si Oyuncular sayfasındaki Son panel işlemleri listesinde görünür. Panelden atılan banlar manuel bandır ve banı veren olarak Panel: <adın> kaydedilir.

Banı kaldırmak için:

  • Komutlar → Ban ID ile ban aç bölümünü aç, ban ID'sini yaz ve Ban aç düğmesine bas.
  • Ya da oyuncunun profilini Oyuncular sekmesinde aç. Bu sunucudaki tespitler altında banın yanındaki Ban kaldır bağlantısına bas.

Ban atmak ve kaldırmak için moderate yetkisi olan bir ekip rolü gerekir (sahip, admin veya editör). Bkz. Ekip Erişimi ve Uzaktan İşlemler.

Konsoldan ve Sohbetten

Console
# Çevrimiçi 12 numaralı oyuncuyu 72 saat banla
cxaban 12 72 Mod menü kullanımı

# Bir identifier'ı banla, oyuncu çevrimdışı olsa bile (0 = kalıcı)
cxabanoffline license:1234567890abcdef1234567890abcdef12345678 0 Ban kaçırma

# Bir banın detaylarını göster
cxabaninfo CXA-7KQ2MX

# Bir banı kaldır
cxaunban CXA-7KQ2MX

# Ban listesini veritabanından hafızaya yeniden yükle
cxareload

Her komutu oyun içinde kimin kullanabileceği Yapılandırma → Yetkili rolleri & komutlar bölümünden ayarlanır. Bkz. Konsol ve Sohbet Komutları ve Yetkili Rolleri ve Komut Erişimi.

Oyun İçi Panelden

Yetkililer oyun içi paneli /cxa ile açar. Rollerine göre oyuncu listesinden ban atabilir, tüm aktif banlara göz atabilir ve onları kaldırabilirler. Bkz. Oyun İçi Panel (/cxa).

Kendi Scriptlerinden

Lua
-- 12 numaralı oyuncuyu 24 saat banla, banı veren ban logunda görünür
local banId = exports['cxa-anticheat']:BanPlayer(12, 'Money exploit', 24, 'my-shop')

-- Bir banı kaldır, ban varsa true döner
exports['cxa-anticheat']:UnbanPlayer('CXA-7KQ2MX')

-- Tek bir identifier'ı kontrol et, banlıysa true ve ban ID'sini döner
local banned, id = exports['cxa-anticheat']:IsIdentifierBanned('discord:123456789012345678')

Tüm parametreler ve dönüş değerleri için Ban ve Kick Export'ları sayfasına bak.

CXA Ağında Global Banlar

CXA Ağı Nedir

CXA Anticheat çalıştıran lisanslı her sunucu CXA ağının parçasıdır. Bir oyuncu bağlandığında sunucun onu ağa sorar. Cevapta aktif global banlar, oyuncunun Hesap Güveni puanı ve geçmişi bulunur; bunları Oyuncular sayfasında ve Ağ Sorgusu içinde görürsün.

Identifierlar ve donanım tokenları ağda sadece tek yönlü hash olarak saklanır. Böylece ağ, hesap kimliklerini açık metin olarak tutmadan bir oyuncuyu tekrar tanıyabilir. IP adresleri hiçbir zaman global banın parçası değildir.

Otomatik Banlarını Paylaşmak

Otomatik banlarımı paylaş açıkken (varsayılan) sunucun, tespiti Paylaşılan tespitler listesinde olan otomatik banları paylaşır. Şu banlar asla paylaşılmaz:

  • Komutlarla, oyun içi panelden ve web panelinden atılan manuel banlar
  • BanPlayer export'u ile atılan banlar
  • Listede olmayan tespitlerden gelen otomatik banlar

Varsayılan liste sadece normal bir oyuncunun tetikleyemeyeceği tespitleri içerir:

Output
ResourceInjection, Injection, BlacklistedWeapons, BlacklistedCommands, DevTools,
DamageModifier, Explosion, ExplosionInvisible, BlacklistedEvent, GiveWeapon,
RemoveWeapon, WeaponDamage, BlacklistedProjectile, ImpossibleDamage, EventAbuse

Listeyi kesin tespitlerle sınırlı tut. Paylaşılan bir ban, global banları uygulayan her sunucuda oyuncunun peşinden gider; senin sunucundaki bir hatalı tespit (false positive) masum bir oyuncuyu başka sunuculardan da uzak tutar.

Başka Yerde Banlanan Oyuncuları Engellemek

Bağlanan her oyuncuyu ağa karşı kontrol etmek için Global banlıları engelle ayarını aç. Bir oyuncunun identifierlarından veya tokenlarından birinde en az Min banlayan sunucu kadar farklı sunucunun aktif global banı varsa oyuncu etkilenir. Şundan eski banları yoksay süresinden eski global banlar sayılmaz.

Ne olacağına İşlem karar verir:

  • reject: oyuncu giremez.
  • log: oyuncu girer ve Connections kanalına bir Network check: global_ban kaydı düşer, böylece yetkililerin onu takip edebilir.

Yapılandırma

Bu ayarları panelde Yapılandırma → Ağ & güven altında değiştir.

SeçenekAnahtarVarsayılanNe yapar
Bağlanırken ağ kontrolüNetworkCheck.EnabledtrueBağlanan her oyuncuyu CXA ağına sorar. Global ban ve hesap güveni için gerekir. [PERF]
Zaman aşımıNetworkCheck.Timeout3000 msGirişin ağın cevabını ne kadar bekleyeceği.
Ulaşılamazsa girişe izin verNetworkCheck.FailOpentrueAğ zamanında cevap vermezse oyuncular normal şekilde girer.
Global banlıları engelleGlobalBans.EnforcefalseOyuncuları diğer sunuculardan gelen global banlara karşı kontrol eder.
Otomatik banlarımı paylaşGlobalBans.SharetrueAşağıdaki tespitlerden gelen otomatik banlarını paylaşır.
İşlemGlobalBans.ActionrejectBağlantıyı reject ile reddet ya da sadece log ile logla.
Şundan eski banları yoksayGlobalBans.MaxAgeDays180 günDaha eski global banlar sayılmaz. 0 = asla yoksayma.
Min banlayan sunucuGlobalBans.MinServers1Oyuncuyu kaç farklı sunucunun banlamış olması gerektiği (1 ile 10 arası).
Paylaşılan tespitlerGlobalBans.ShareDetections15 tespit, yukarıya bakSadece bu tespit anahtarlarından gelen banlar paylaşılır.

[PERF] Ağ kontrolü bağlanan her oyuncu için bir HTTPS isteğidir ve her girişe Zaman aşımı süresine kadar ekleyebilir.

Global Banlı Oyuncu Ne Görür

İşlem reject olduğunda oyuncu şunu görür:

Output
You are banned on the CXA Anticheat network and cannot join CXA Anticheat. If you believe this is a mistake, contact the server that banned you.

(CXA Anticheat ağında yasaklısın ve bu sunucuya giremezsin; hata olduğunu düşünüyorsan seni banlayan sunucuyla iletişime geç.) CXA Anticheat yerine senin sunucu adın yazar. Ağa ulaşılamazsa ve Ulaşılamazsa girişe izin ver kapalıysa, bağlanan herkes bunun yerine Security check could not be completed, please try again in a minute. görür (güvenlik kontrolü tamamlanamadı, bir dakika sonra tekrar dene).

Paylaşılan Banı Geri Çekmek

Bir banı kaldırdığında CXA onun paylaşılan kopyasını da ağdan geri çeker. Bu, ban kaldırabildiğin her yerde çalışır: panel, cxaunban, oyun içi panel ve UnbanPlayer export'u. Ardından İşlem kaydı listesinde Ban kaldırılınca global ban geri çekildi yazar.

Bir global banı sadece onu atan sunucu geri çekebilir. Başka bir sunucunun global banına rağmen tek bir oyuncuyu içeri almak için onun identifierlarından birini Her zaman izinli identifierlar (TrustScore.Whitelist) listesine ekle. Bu listedeki identifierlar global ban ve hesap güveni kontrollerini atlar.

Öneriler

Önerilir:

  • Banlar dosya hatalarından etkilenmesin ve geçmiş kalsın diye oxmysql depolamasını kullan.
  • Donanım tokenlarını eşleştir ve Identifierları genişlet açık kalsın. İkisi birlikte ban kaçırmanın çoğunu yakalar.
  • Kendi İtiraz linkini ayarla ve oyunculardan ban ID'sini iste.
  • Yeni bir tespiti ban vermeden ve Paylaşılan tespitler listesine eklemeden önce birkaç gün log ile dene.
  • Global banlara bir hafta İşlem log ile başla, Connections kanalını kontrol et, sonra reject yap.

Kaçın:

  • Aynı şehirden veya aynı mobil operatörden çok oyuncusu olan bir sunucuda IP eşleştir ayarını açmaktan.
  • Normal oyuncularda tetiklenebilecek tespitleri Paylaşılan tespitler listesine eklemekten.
  • Sunucu çalışırken cxa_bans tablosunu düzenleyip ardından Banları yenile çalıştırmamaktan.

İlgili Özellikler

Oyuncular ve Ağ Sorgusu

  • Oyuncular sayfasındaki oyuncu profili global ban sayısını ve global ban geçmişini gösterir; kendi banların "bu sunucu" olarak işaretlenir.
  • Ağ Sorgusu, herhangi bir identifier'ın tüm ağdaki otomatik banlarını aktif veya geri çekilmiş olarak gösterir.

Hesap Güveni

  • Aktif bir global ban, Global banlıları engelle kapalı olsa bile oyuncunun güven puanını kırmızı seviyeye düşürür.
  • Bkz. Hesap Güveni.

Loglama ve Discord

  • Yeni banlar Bans kanalına, ban kaldırmalar ve yetkili banları Admin kanalına, engellenen giriş denemeleri Connections kanalına düşer.
  • Bkz. Loglama ve Discord.

Yetkili Muafiyeti

  • Config.Bypass.Identifiers listesindeki identifierlar bağlanırken yerel banlara, global banlara ve hesap güvenine karşı kontrol edilmez.
  • Bkz. Yetkili Muafiyeti.

Sınırlamalar

  • Paylaşılan bir banı sadece ban kaldırma geri çeker. Süreli bir otomatik banın süresi kendiliğinden dolduğunda, paylaşılan kopyası diğer sunucuların Şundan eski banları yoksay süresini geçene kadar ağda kalır.
  • Global banlar, paylaşım ve geri çekme için aktif bir lisans ve codexart.net bağlantısı gerekir.
  • Giriş sırasında sadece Config.Bypass.Identifiers listesindeki identifierlar muafiyet sayılır. txAdmin yöneticileri ve bypass ACE izni ya da framework grubu olan oyuncular bağlanırken herkes gibi ban kontrolünden geçer.

Sık Karşılaşılan Sorunlar

Banlı Bir Oyuncu Hâlâ Girebiliyor

Ne görürsün: Banladığın bir oyuncu aynı veya yeni bir hesapla tekrar giriyor.

Nasıl düzeltilir:

  • Banın hâlâ aktif olduğunu cxabaninfo <banId> ile kontrol et. Süreli banlar kendiliğinden biter.
  • Oyuncunun identifierlarından hiçbirinin Config.Bypass.Identifiers listesinde olmadığından emin ol.
  • Aynı bilgisayardaki yeni hesap da engellensin diye Donanım tokenlarını eşleştir açık kalsın.
  • Banları doğrudan veritabanına eklediysen veya düzenlediysen Komutlar sekmesinde Banları yenile ya da konsolda cxareload çalıştır.
  • Depolama türünü değiştirdiysen eski banların hâlâ eski yerdedir.

"Active ban CXA-... was not found."

Ne görürsün: cxaunban veya cxabaninfo şunu cevaplar: Active ban CXA-7KQ2MX was not found. (CXA-7KQ2MX numaralı aktif ban bulunamadı.)

Nasıl düzeltilir:

  • Ban ID'sini ban logundan veya ban ekranından kopyala. ID'lerde asla I, O, 0 veya 1 olmaz.
  • Banın süresi dolmuş ya da ban zaten kaldırılmış olabilir.

Panelden Ban Kaldırma ban_not_found ile Başarısız Oluyor

Ne görürsün: Komutlar sekmesindeki Sonuçlar listesinde failed ve ban_not_found yazıyor.

Nasıl düzeltilir:

  • Ban ID'sini ban ekranında göründüğü gibi büyük harflerle yaz. En güvenlisi ban logundan kopyalamaktır.
  • Banın hâlâ var olduğunu cxabaninfo ile kontrol et.

Masum Bir Oyuncu Başkasının Banına Takılıyor

Ne görürsün: Yeni bir oyuncu, başka birine ait bir ban ID'siyle ban ekranını görüyor.

Nasıl düzeltilir:

  • IP eşleştir açıksa kapat. Oyuncu büyük ihtimalle banlı kişiyle aynı internet bağlantısını kullanıyor.
  • Ban yanlışsa ID'siyle kaldır, sonra doğru kişiyi tekrar banla.

Oyuncular "You are banned on the CXA Anticheat network" Görüyor

Ne görürsün: Senin sunucunda hiç banlanmamış oyuncular giremiyor.

Nasıl düzeltilir:

  • Global banların arkasındaki tespitleri görmek için oyuncuyu Ağ Sorgusu ile ara.
  • Tek bir sunucu yetmesin diye Min banlayan sunucu değerini yükselt.
  • Bu oyuncuları engellemek yerine izlemek istersen İşlem'i log yap.
  • Güvendiğin bir oyuncunun identifier'ını Her zaman izinli identifierlar listesine ekle.

"Security check could not be completed, please try again in a minute."

Ne görürsün: codexart.net adresine ulaşılamadığı sürece kimse giremiyor.

Nasıl düzeltilir:

  • Ulaşılamazsa girişe izin ver ayarını tekrar aç (NetworkCheck.FailOpen = true).
  • Hostinginin giden HTTPS bağlantılarına izin verdiğini kontrol et.

"oxmysql is not started, bans will be stored in data/bans.json"

Ne görürsün: Anticheat başlarken konsolda bu uyarı çıkıyor.

Nasıl düzeltilir:

  • server.cfg içinde ensure oxmysql satırını ensure cxa-anticheat satırının üstüne taşı ve sunucuyu yeniden başlat.
  • MySQL kullanmıyorsan Depolama'yı JSON dosyası yap, uyarı kaybolur.

© 2026 CodeXart Studios · CXA Anticheat