Ban ve Kick Export'ları

Bu export'larla kendi scriptlerin CXA Anticheat üzerinden oyuncuları banlayabilir, sunucudan atabilir ve banlarını kaldırabilir. Bu yolla oluşturulan bir ban normal bir CXA ban ID'si alır, CXA ban ekranını gösterir ve her girişte kontrol edilir; tıpkı panelden veya cxaban komutuyla verilen bir ban gibi.

Boş Süre, Varsayılan Süre Demektir

hours değerini boş bırakırsan BanPlayer, ban sistemi ayarlarındaki varsayılan süreyi kullanır. Kurulumdan sonra bu değer 0'dır, yani ban kalıcı olur. İstediğin saat sayısını her zaman kendin ver.

Ne Zaman Kullanılır

  • Yönetici menün, Discord botun veya destek aracın kendi listesini tutmak yerine oyuncuları CXA ban listesine banlamalıysa.
  • Bir whitelist veya başvuru sistemi, bir Discord ya da license tanımlayıcısının zaten banlı olup olmadığına bakmalıysa.
  • Bir yetkili aracı, oyuncunun itirazında gönderdiği ban ID'sinin ayrıntılarını göstermeliyse.

Export'lar

BanPlayer

Çevrimiçi bir oyuncuyu banlar ve ban ekranıyla sunucudan atar.

exports['cxa-anticheat']:BanPlayer(src, reason, hours, bannedBy)

Parametreler:

  • src (number): Oyuncunun sunucu ID'si
  • reason (string, opsiyonel): Ban ekranında ve loglarda görünür. Varsayılan: No reason given (Türkçe dilde Sebep belirtilmedi)
  • hours (number, opsiyonel): Saat cinsinden ban süresi, 0 = kalıcı. Ondalık değer de olur, 0.5 30 dakikadır. Varsayılan: ban sistemi ayarlarındaki varsayılan süre (0)
  • bannedBy (string, opsiyonel): Banı verenin adı olarak kaydedilir. Varsayılan: export'u çağıran resource'un adı

Dönüş değeri: Metin olarak ban ID'si, örneğin CXA-7KQ2MX. Anticheat başlamamışsa veya oyuncu çevrimiçi değilse false.

Ne olur:

  • CXA, External tespitiyle bir ban oluşturur. Ban, her CXA banı gibi oyuncunun tanımlayıcılarıyla ve donanım tokenlarıyla eşleşir.
  • Ban, oxmysql varsa cxa_bans tablosuna, yoksa data/bans.json dosyasına kaydedilir ve yeniden başlatmalardan sonra da kalır.
  • Oyuncu ban ekranıyla sunucudan atılır. Ekranda sunucu adın, ban ID'si, sebep, bitiş tarihi ve ayarladıysan itiraz bağlantın görünür.
  • Bans webhook kanalına sebep, banı veren, ban ID'si ve bitiş tarihini içeren bir "Player Banned" (Oyuncu Yasaklandı) mesajı gider.
  • Ban, paneldeki Tespitler sekmesinde External tespitiyle ve export'u çağıran resource'un adıyla görünür.
  • Ban CXA ağında paylaşılmaz. Yalnızca paylaşılan tespitlerden gelen otomatik banlar paylaşılır.
  • Yetkili muafiyetine bakılmaz. BanPlayer muaf yetkilileri de banlar, bu yüzden çağırmadan önce kendi yetki kontrolünü yap.

KickPlayer

Çevrimiçi bir oyuncuyu kick ekranıyla sunucudan atar.

exports['cxa-anticheat']:KickPlayer(src, reason)

Parametreler:

  • src (number): Oyuncunun sunucu ID'si
  • reason (string, opsiyonel): Kick ekranında görünür. Varsayılan: No reason given (Türkçe dilde Sebep belirtilmedi)

Dönüş değeri: Oyuncu atıldıysa true, oyuncu çevrimiçi değilse false.

Ne olur:

  • Oyuncu, sunucu adını ve sebebi gösteren CXA kick ekranıyla sunucudan atılır.
  • Hiçbir şey loglanmaz. Webhook mesajı da panel kaydı da oluşmaz. Kayıt istiyorsan atmayı kendin logla ya da Kicks kanalına log yazan FlagPlayer export'unu kick ile kullan.

UnbanPlayer

Aktif bir banı kaldırır.

exports['cxa-anticheat']:UnbanPlayer(banId)

Parametreler:

  • banId (string): Ban ID'si, tam olarak CXA'nın gösterdiği gibi, örneğin CXA-7KQ2MX. Büyük/küçük harfe duyarlıdır.

Dönüş değeri: Aktif bir ban kaldırıldıysa true, bu ID ile aktif bir ban yoksa false.

Ne olur:

  • Ban hafızadan hemen silinir, oyuncu hemen tekrar girebilir.
  • oxmysql ile satır cxa_bans tablosunda kalır ve pasif olarak işaretlenir. JSON depolamada data/bans.json dosyasından silinir.
  • Ban CXA ağında global ban olarak paylaşıldıysa oradan da geri çekilir.
  • Hiçbir şey loglanmaz. cxaunban komutu Admin webhook kanalına yazar, bu export yazmaz.

GetBan

Aktif bir banın kaydını döndürür.

exports['cxa-anticheat']:GetBan(banId)

Parametreler:

  • banId (string): Ban ID'si, örneğin CXA-7KQ2MX. Büyük/küçük harfe duyarlıdır.

Dönüş değeri: Aşağıdaki alanları içeren bir tablo. Ban yoksa, kaldırıldıysa veya süresi dolduysa nil. JavaScript ve TypeScript'te "ban yok" sonucu undefined olarak gelir.

AlanTürİçeriği
banIdstringBan ID'si, örneğin CXA-7KQ2MX
namestringOyuncunun banlandığı andaki adı. Çevrimdışı banlarda banlanan tanımlayıcı
reasonstringBan sebebi
detectionstringOtomatik banlarda tespit anahtarı (örneğin Noclip), komut ve panel banlarında Manual, export banlarında External
identifiersstring[]Oyuncunun tanımlayıcıları ve tekrar girmeye çalıştığında eklenen yenileri
tokensstring[]Oyuncunun donanım tokenları
bannedBystringBanı veren: otomatik banlarda CXA Anticheat, komutlarda Console veya Ad (ID), panelde Panel: ad, export'larda senin bannedBy değerin
createdAtnumberBanın oluşturulduğu an, saniye cinsinden Unix zaman damgası
expiresAtnumberBanın bittiği an, saniye cinsinden Unix zaman damgası. 0 kalıcı demektir

Ne olur:

  • Kayıt hafızadan okunur. Veritabanı sorgusu yapılmaz.
  • Süresi dolmuş bir ban sorgulandığında kaldırılır ve nil döner.

IsIdentifierBanned

Bir tanımlayıcının veya donanım tokenının aktif bir bana ait olup olmadığına bakar.

exports['cxa-anticheat']:IsIdentifierBanned(identifier)

Parametreler:

  • identifier (string): Ön ekiyle birlikte tam bir tanımlayıcı, örneğin license:1234567890abcdef1234567890abcdef12345678 veya discord:123456789012345678, ya da bir donanım tokenı

Dönüş değeri: İki değer. Lua'da: banlıysa true, banId, değilse false, nil. JavaScript ve TypeScript'te: banlıysa [true, banId] dizisi, değilse false.

Ne olur:

  • Kontrol hafızada çalışır; bir oyuncu bağlanırken bile çağırmak ucuzdur.
  • Yalnızca banların eşleştiği tanımlayıcı türleri sayılır: varsayılan olarak license, license2, steam, discord, xbl, live ve fivem. ip: tanımlayıcısı yalnızca IP eşleştirme açıkken sayılır. Donanım tokenları, varsayılan olarak açık olan token eşleştirme açık olduğu sürece sayılır.
  • Yalnızca bu sunucunun kendi banlarına bakılır. CXA ağındaki global banlar kontrol edilmez.

Örnekler

Yönetici Menünden Banla

Yönetici menün sunucuya bir ban isteği gönderir. Sunucu önce kendi yetkini kontrol eder, sonra CXA üzerinden banlar ve yetkiliye ban ID'sini söyler.

RegisterNetEvent('my-admin:server:ban', function(targetId, hours, reason)
    local src = source
    -- Yalnızca kendi ACE iznine sahip yetkililer banlayabilir
    if not IsPlayerAceAllowed(src, 'myadmin.ban') then
        return
    end
    if GetResourceState('cxa-anticheat') ~= 'started' then
        return
    end
    -- Loglarda ve GetBan sonucunda görünen banı veren
    local issuer = ('Admin Menu: %s'):format(GetPlayerName(src))
    -- Saati her zaman ver, boş değer varsayılan süre (kalıcı) demektir
    local banId = exports['cxa-anticheat']:BanPlayer(tonumber(targetId), reason, tonumber(hours) or 24, issuer)
    if banId then
        TriggerClientEvent('chat:addMessage', src, { args = { 'Admin', ('Player banned, ban ID: %s'):format(banId) } })
    else
        TriggerClientEvent('chat:addMessage', src, { args = { 'Admin', 'Player is offline or the anticheat is not running.' } })
    end
end)

Bir Banı Sorgula ve Kaldır

Destek ekibin için bir konsol komutu. Önce banı yazdırır, sonra kaldırır ve kendi log satırını yazar, çünkü UnbanPlayer hiçbir şey loglamaz.

-- Sunucu konsolunda kullanım: appealunban CXA-7KQ2MX
RegisterCommand('appealunban', function(src, args)
    if src ~= 0 then
        return -- Yalnızca konsol
    end
    local banId = (args[1] or ''):upper() -- Ban ID'leri büyük harflidir
    local ban = exports['cxa-anticheat']:GetBan(banId)
    if not ban then
        print(('No active ban %s'):format(banId))
        return
    end
    print(('%s was banned by %s for: %s'):format(ban.name, ban.bannedBy, ban.reason))
    if exports['cxa-anticheat']:UnbanPlayer(banId) then
        print(('Ban %s removed after an appeal'):format(banId)) -- Kendi log satırın
    end
end, true)

Başvuruyu Kabul Etmeden Önce Kontrol Et

Whitelist başvuru sistemin, yetkililer başvuranı kabul etmeden önce onun Discord tanımlayıcısını kontrol eder.

local function isApplicantBanned(discordId)
    -- Tam tanımlayıcıyı "discord:" ön ekiyle ver
    local banned, banId = exports['cxa-anticheat']:IsIdentifierBanned('discord:' .. discordId)
    if banned then
        print(('Applicant is banned, ban ID: %s'):format(banId))
    end
    return banned
end

Tip Tanımları

interface CxaBanRecord {
  banId: string;
  name: string;
  reason: string;
  detection: string;
  identifiers: string[];
  tokens: string[];
  bannedBy: string;
  createdAt: number; // Saniye cinsinden Unix zamanı
  expiresAt: number; // Saniye cinsinden Unix zamanı, 0 = kalıcı
}

interface CxaBanExports {
  BanPlayer(src: number, reason?: string, hours?: number, bannedBy?: string): string | false;
  KickPlayer(src: number, reason?: string): boolean;
  UnbanPlayer(banId: string): boolean;
  GetBan(banId: string): CxaBanRecord | undefined;
  IsIdentifierBanned(identifier: string): [true, string] | false; // Banlı: [true, banId]
}

const cxa = exports['cxa-anticheat'] as CxaBanExports;

Öneriler

Bilmekte Fayda Var

  • hours değerini her zaman ver. Boş değer, sen değiştirmediysen kalıcı olan varsayılan süreye düşer.
  • Admin Menu: John gibi bir bannedBy ver. Bu değer Bans kanalında ve GetBan sonucunda görünür, böylece kimin kimi banladığını bilirsin.
  • Sebebi kısa ve açık yaz. Oyuncu onu ban ekranında okur.
  • Oyuncu adını değil ban ID'sini sakla. Ban ID'leri benzersizdir, adlar değildir.
  • KickPlayer ve UnbanPlayer log yazmaz. Yetkililerinin kayda ihtiyacı varsa bu işlemleri kendi scriptinde logla.

İlgili Özellikler

Konsol ve Sohbet Komutları

  • cxaban, cxaunban ve cxabaninfo aynı ban listesi üzerinde çalışır. Bkz. Konsol ve Sohbet Komutları.
  • Komutlar Admin webhook kanalına log yazar, KickPlayer ve UnbanPlayer export'ları yazmaz.

Banlar ve CXA Ağı

  • BanPlayer banları hiçbir zaman global ban olarak paylaşılmaz.
  • Global banların nasıl paylaşıldığını ve uygulandığını Banlar ve CXA Ağı sayfasında oku.

Loglama ve Discord

  • BanPlayer, Bans kanalına yazar. Bu kanalın webhook'unu panelde Webhook & anahtarlar bölümünde ayarla. Bkz. Loglama ve Discord.

Sık Karşılaşılan Sorunlar

BanPlayer false Dönüyor

Ne görürsün: BanPlayer false döner ve oyuncu sunucuda kalır.

Nasıl düzeltilir:

  • Oyuncunun hâlâ çevrimiçi olduğunu kontrol et. BanPlayer yalnızca çevrimiçi oyuncuları banlar. Oyundan çıkmış oyuncular için cxabanoffline komutunu kullan.
  • IsActive() sonucuna bak. Anticheat başlamadan önce BanPlayer hiçbir şey yapmaz.
  • Lua'da export'u nokta ile değil, iki nokta üst üste (:) ile çağır.

Ban Geçici Değil Kalıcı Oldu

Ne görürsün: Kısa bir ban istedin ama ban ekranında Never (permanent) (Asla, kalıcı) yazıyor.

Nasıl düzeltilir:

  • Saati üçüncü argüman olarak ver. Boş veya okunamayan bir değer varsayılan süreye düşer.
  • Birim saattir; dakika veya gün değil.
-- ❌ Saat yok: varsayılan süre (kalıcı) kullanılır
exports['cxa-anticheat']:BanPlayer(target, 'Combat logging')

-- ❌ Saat yerine dakika: bu 30 saatlik bir bandır
exports['cxa-anticheat']:BanPlayer(target, 'Combat logging', 30)

-- ✅ 30 dakika = 0.5 saat
exports['cxa-anticheat']:BanPlayer(target, 'Combat logging', 0.5)

UnbanPlayer veya GetBan Hiçbir Şey Bulmuyor

Ne görürsün: Var olan bir ban ID'si veriyorsun ama UnbanPlayer false dönüyor ya da GetBan hiçbir şey döndürmüyor.

Nasıl düzeltilir:

  • Ban ID'leri büyük/küçük harfe duyarlıdır. Girdiyi önce büyük harfe çevir.
  • Banın süresi dolmuş veya ban zaten kaldırılmış olabilir. Sunucu konsolunda cxabaninfo <banId> ile kontrol et.

IsIdentifierBanned Hep false Dönüyor

Ne görürsün: Oyuncu banlı ama tanımlayıcısının kontrolü banlı olmadığını söylüyor.

Nasıl düzeltilir:

  • Tanımlayıcıyı ön ekiyle birlikte tam olarak ver.
  • ip: tanımlayıcıları yalnızca ban sistemi ayarlarında IP eşleştirme açıksa sayılır.
  • Tanımlayıcı türü, eşleştirilen tanımlayıcılar listesinde olmalı.
-- ❌ Ön ek eksik
exports['cxa-anticheat']:IsIdentifierBanned('123456789012345678')

-- ✅ Tam tanımlayıcı
exports['cxa-anticheat']:IsIdentifierBanned('discord:123456789012345678')

© 2026 CodeXart Studios · CXA Anticheat