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 dildeSebep belirtilmedi) - hours (number, opsiyonel): Saat cinsinden ban süresi,
0= kalıcı. Ondalık değer de olur,0.530 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,
Externaltespitiyle 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_banstablosuna, yoksadata/bans.jsondosyası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
Externaltespitiyle 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.
BanPlayermuaf 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 dildeSebep 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
kickile 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_banstablosunda kalır ve pasif olarak işaretlenir. JSON depolamadadata/bans.jsondosyasından silinir. - Ban CXA ağında global ban olarak paylaşıldıysa oradan da geri çekilir.
- Hiçbir şey loglanmaz.
cxaunbankomutu 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.
| Alan | Tür | İçeriği |
|---|---|---|
banId | string | Ban ID'si, örneğin CXA-7KQ2MX |
name | string | Oyuncunun banlandığı andaki adı. Çevrimdışı banlarda banlanan tanımlayıcı |
reason | string | Ban sebebi |
detection | string | Otomatik banlarda tespit anahtarı (örneğin Noclip), komut ve panel banlarında Manual, export banlarında External |
identifiers | string[] | Oyuncunun tanımlayıcıları ve tekrar girmeye çalıştığında eklenen yenileri |
tokens | string[] | Oyuncunun donanım tokenları |
bannedBy | string | Banı veren: otomatik banlarda CXA Anticheat, komutlarda Console veya Ad (ID), panelde Panel: ad, export'larda senin bannedBy değerin |
createdAt | number | Banın oluşturulduğu an, saniye cinsinden Unix zaman damgası |
expiresAt | number | Banı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
nildö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:1234567890abcdef1234567890abcdef12345678veyadiscord: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,livevefivem.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)onNet('my-admin:server:ban', (targetId: number, hours: number, reason: string) => {
const src = source;
// Yalnızca kendi ACE iznine sahip yetkililer banlayabilir
if (!IsPlayerAceAllowed(src.toString(), 'myadmin.ban')) return;
if (GetResourceState('cxa-anticheat') !== 'started') return;
// Loglarda ve GetBan sonucunda görünen banı veren
const issuer = `Admin Menu: ${GetPlayerName(src.toString())}`;
// Saati her zaman ver, boş değer varsayılan süre (kalıcı) demektir
const banId: string | false = exports['cxa-anticheat'].BanPlayer(Number(targetId), reason, Number(hours) || 24, issuer);
if (banId) {
emitNet('chat:addMessage', src, { args: ['Admin', `Player banned, ban ID: ${banId}`] });
} else {
emitNet('chat:addMessage', src, { args: ['Admin', 'Player is offline or the anticheat is not running.'] });
}
});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)// Sunucu konsolunda kullanım: appealunban CXA-7KQ2MX
RegisterCommand('appealunban', (src: number, args: string[]) => {
if (src !== 0) return; // Yalnızca konsol
const banId = (args[0] ?? '').toUpperCase(); // Ban ID'leri büyük harflidir
const ban = exports['cxa-anticheat'].GetBan(banId);
if (!ban) {
console.log(`No active ban ${banId}`);
return;
}
console.log(`${ban.name} was banned by ${ban.bannedBy} for: ${ban.reason}`);
if (exports['cxa-anticheat'].UnbanPlayer(banId)) {
console.log(`Ban ${banId} removed after an appeal`); // Kendi log satırın
}
}, 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
endfunction isApplicantBanned(discordId: string): boolean {
// Tam tanımlayıcıyı "discord:" ön ekiyle ver
const result: [true, string] | false = exports['cxa-anticheat'].IsIdentifierBanned(`discord:${discordId}`);
if (result) {
const [, banId] = result; // Banlı: [true, banId]
console.log(`Applicant is banned, ban ID: ${banId}`);
return true;
}
return false; // Banlı değil: false
}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;---@class CxaBanRecord
---@field banId string
---@field name string
---@field reason string
---@field detection string
---@field identifiers string[]
---@field tokens string[]
---@field bannedBy string
---@field createdAt integer Saniye cinsinden Unix zamanı
---@field expiresAt integer Saniye cinsinden Unix zamanı, 0 = kalıcı
---@class CxaBanExports
---@field BanPlayer fun(self: CxaBanExports, src: integer, reason?: string, hours?: number, bannedBy?: string): string|false
---@field KickPlayer fun(self: CxaBanExports, src: integer, reason?: string): boolean
---@field UnbanPlayer fun(self: CxaBanExports, banId: string): boolean
---@field GetBan fun(self: CxaBanExports, banId: string): CxaBanRecord|nil
---@field IsIdentifierBanned fun(self: CxaBanExports, identifier: string): boolean, string|nil
---@type CxaBanExports
local cxa = exports['cxa-anticheat']Öneriler
Bilmekte Fayda Var
hoursdeğerini her zaman ver. Boş değer, sen değiştirmediysen kalıcı olan varsayılan süreye düşer.Admin Menu: Johngibi birbannedByver. Bu değer Bans kanalında veGetBansonucunda 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.
KickPlayerveUnbanPlayerlog yazmaz. Yetkililerinin kayda ihtiyacı varsa bu işlemleri kendi scriptinde logla.
İlgili Özellikler
Konsol ve Sohbet Komutları
cxaban,cxaunbanvecxabaninfoaynı ban listesi üzerinde çalışır. Bkz. Konsol ve Sohbet Komutları.- Komutlar Admin webhook kanalına log yazar,
KickPlayerveUnbanPlayerexport'ları yazmaz.
Banlar ve CXA Ağı
BanPlayerbanları 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.
BanPlayeryalnızca çevrimiçi oyuncuları banlar. Oyundan çıkmış oyuncular içincxabanofflinekomutunu kullan. IsActive()sonucuna bak. Anticheat başlamadan önceBanPlayerhiç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)// ❌ 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')// ❌ Ön ek eksik
exports['cxa-anticheat'].IsIdentifierBanned('123456789012345678');
// ✅ Tam tanımlayıcı
exports['cxa-anticheat'].IsIdentifierBanned('discord:123456789012345678');© 2026 CodeXart Studios · CXA Anticheat