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
bancezalı bir tespit, bir yetkili komutu, web paneli, oyun içi panel veya kendi scriptlerinden biri ban oluşturur.- Ban,
CXA-7KQ2MXgibi bir ID alır. Kayıtta oyuncunun adı, sebep, tespit, tüm identifierlar (license:veyadiscord:gibi hesap kimlikleri), donanım tokenları, banı kimin attığı, ne zaman atıldığı ve ne zaman biteceği tutulur. - Oyuncu sunucudan atılır ve ban ID'sinin yazdığı ban ekranını görür.
- 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.
- 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
| Depolama | Nerede | Ne zaman kullanılır |
|---|---|---|
oxmysql (varsayılan, önerilen) | Veritabanındaki cxa_bans tablosu, otomatik oluşturulur | MySQL olan her sunucu. Kaldırılan banlar tabloda active = 0 olarak kalır, geçmişin korunur. |
json | Resource içindeki data/bans.json | MySQL 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çenek | Anahtar | Varsayılan | Ne yapar |
|---|---|---|---|
| Depolama | Ban.Storage | oxmysql | Banların kaydedildiği yer, yukarıya bak. |
| Tablo adı | Ban.TableName | cxa_bans | MySQL tablo adı. Sadece harf, rakam ve _. |
| Ban ID ön eki | Ban.IdPrefix | CXA- | Her ban ID'sinin başındaki metin. |
| Ban ID uzunluğu | Ban.IdLength | 6 | Ön ekten sonraki rastgele karakter sayısı (4 ile 16 arası). |
| Varsayılan süre | Ban.DefaultDuration | 0 | Tespitin ban süresi yoksa kullanılan saat. 0 = kalıcı. |
| Otomatik ban veren | Ban.BannedBy | CXA Anticheat | Otomatik banlarda banı veren olarak kaydedilen ad. |
| Eşleşecek identifierlar | Ban.MatchIdentifiers | license, license2, steam, discord, xbl, live, fivem | Eşleşme sayılan identifier türleri. |
| Donanım tokenlarını eşleştir | Ban.MatchTokens | true | Aynı bilgisayarı yeni hesapta da engeller. |
| IP eşleştir | Ban.MatchIp | false | Aynı IP adresini de engeller. |
| Identifierları genişlet | Ban.ExtendIdentifiers | true | Banlı 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.
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:DDbiçiminde gösterir. - Appeal satırı Yapılandırma → Genel → İtiraz linki (
Config.AppealUrl) alanından gelir. Varsayılandiscord.gg/yourserversadece 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:
- Oyuncular sekmesini aç ve Çevrimiçi görünümünde kal ya da Canlı harita sekmesini aç (bkz. 3D Harita).
- Oyuncunun satırındaki Banla simgesine bas ya da oyuncuyu açıp Şu an çevrimiçi altındaki Ban düğmesine bas.
- 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.
- 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
# Ç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
cxareloadHer 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
-- 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
BanPlayerexport'u ile atılan banlar- Listede olmayan tespitlerden gelen otomatik banlar
Varsayılan liste sadece normal bir oyuncunun tetikleyemeyeceği tespitleri içerir:
ResourceInjection, Injection, BlacklistedWeapons, BlacklistedCommands, DevTools,
DamageModifier, Explosion, ExplosionInvisible, BlacklistedEvent, GiveWeapon,
RemoveWeapon, WeaponDamage, BlacklistedProjectile, ImpossibleDamage, EventAbuseListeyi 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 birNetwork check: global_bankaydı 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çenek | Anahtar | Varsayılan | Ne yapar |
|---|---|---|---|
| Bağlanırken ağ kontrolü | NetworkCheck.Enabled | true | Bağlanan her oyuncuyu CXA ağına sorar. Global ban ve hesap güveni için gerekir. [PERF] |
| Zaman aşımı | NetworkCheck.Timeout | 3000 ms | Girişin ağın cevabını ne kadar bekleyeceği. |
| Ulaşılamazsa girişe izin ver | NetworkCheck.FailOpen | true | Ağ zamanında cevap vermezse oyuncular normal şekilde girer. |
| Global banlıları engelle | GlobalBans.Enforce | false | Oyuncuları diğer sunuculardan gelen global banlara karşı kontrol eder. |
| Otomatik banlarımı paylaş | GlobalBans.Share | true | Aşağıdaki tespitlerden gelen otomatik banlarını paylaşır. |
| İşlem | GlobalBans.Action | reject | Bağlantıyı reject ile reddet ya da sadece log ile logla. |
| Şundan eski banları yoksay | GlobalBans.MaxAgeDays | 180 gün | Daha eski global banlar sayılmaz. 0 = asla yoksayma. |
| Min banlayan sunucu | GlobalBans.MinServers | 1 | Oyuncuyu kaç farklı sunucunun banlamış olması gerektiği (1 ile 10 arası). |
| Paylaşılan tespitler | GlobalBans.ShareDetections | 15 tespit, yukarıya bak | Sadece 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:
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
oxmysqldepolaması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
logile dene. - Global banlara bir hafta İşlem
logile başla, Connections kanalını kontrol et, sonrarejectyap.
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_banstablosunu 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.Identifierslistesindeki 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.netbağlantısı gerekir. - Giriş sırasında sadece
Config.Bypass.Identifierslistesindeki 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.Identifierslistesinde 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,0veya1olmaz. - 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
cxabaninfoile 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
logyap. - 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.cfgiçindeensure oxmysqlsatırınıensure cxa-anticheatsatı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