Sunucu Export'ları
Sunucu export'ları sayesinde kendi sunucu scriptlerin export'lar (bir resource'un diğer resource'lara sunduğu fonksiyonlar) üzerinden oyuncuları banlayabilir ve sunucudan atabilir, bir script bilerek alışılmadık bir şey yaparken tespitleri duraklatabilir ve kendi tespitlerini CXA Anticheat'e bildirebilir.
Yalnızca Sunucu Tarafı
Bu sayfadaki tüm export'lar sunucuda çalışır. Onları yalnızca server_script dosyalarından çağır. CXA Anticheat'in herkese açık eventi yoktur: iç eventleri sürümden sürüme değişebilir, bu yüzden scriptlerinden onları asla tetikleme ve dinleme.
Export'lar Nasıl Çağrılır
Lua'da bir export'u iki nokta üst üste (:) ile çağırırsın. JavaScript veya TypeScript'te nokta (.) kullanılır. Resource adı her zaman cxa-anticheat olur.
-- İki nokta söz dizimi: exports['resource']:ExportAdi(...)
local active = exports['cxa-anticheat']:IsActive()
print(('CXA Anticheat active: %s'):format(tostring(active)))// Nokta söz dizimi: exports['resource'].ExportAdi(...)
const active: boolean = exports['cxa-anticheat'].IsActive();
console.log(`CXA Anticheat active: ${active}`);Anticheat'in Çalıştığını Kontrol Et
Başlatılmamış bir resource'un export'unu çağırmak hata fırlatır. Ayrıca CXA Anticheat, panelde yeni bir config kaydettiğinde birkaç saniye sonra kendini yeniden başlatır; yani sunucun açıkken de kısa bir süre ulaşılamaz olabilir. Çağrılarını, önce resource durumuna bakan, sonra IsActive() soran küçük bir yardımcı fonksiyonla sar.
IsActive() yalnızca klasörün adı cxa-anticheat ise, anticheat başlamışsa ve lisans doğrulanmışsa true döner.
-- cxa-anticheat başlamışsa ve sunucuyu koruyorsa true döner
local function cxaReady()
if GetResourceState('cxa-anticheat') ~= 'started' then
return false
end
local ok, active = pcall(function()
return exports['cxa-anticheat']:IsActive()
end)
return ok and active == true
end// cxa-anticheat başlamışsa ve sunucuyu koruyorsa true döner
function cxaReady(): boolean {
if (GetResourceState('cxa-anticheat') !== 'started') return false;
try {
return exports['cxa-anticheat'].IsActive() === true;
} catch {
return false;
}
}server.cfg dosyasında ensure cxa-anticheat satırını bu export'ları çağıran resource'ların üstüne koy. Böylece scriptlerin başladığında export'lar hazır olur.
Genel Bakış
| Export | Ne yapar | Sayfa |
|---|---|---|
BanPlayer | Çevrimiçi bir oyuncuyu CXA ban ID'siyle banlar ve ban ekranıyla sunucudan atar | Ban ve Kick Export'ları |
KickPlayer | Çevrimiçi bir oyuncuyu kick ekranıyla sunucudan atar | Ban ve Kick Export'ları |
UnbanPlayer | Aktif bir banı ban ID'siyle kaldırır | Ban ve Kick Export'ları |
GetBan | Aktif bir banın kaydını döndürür | Ban ve Kick Export'ları |
IsIdentifierBanned | Bir tanımlayıcının (identifier) veya donanım tokenının banlı olup olmadığına bakar | Ban ve Kick Export'ları |
IsPlayerBypassed | Oyuncunun tüm kontrolleri atlayıp atlamadığını söyler | Muafiyet ve Duraklatma Export'ları |
RefreshBypass | Grubunu değiştirdiğin oyuncunun muafiyetini yeniden hesaplar | Muafiyet ve Duraklatma Export'ları |
SetTemporaryBypass | Bir oyuncu için tüm tespitleri belirli bir saniye boyunca duraklatır | Muafiyet ve Duraklatma Export'ları |
PauseDetection | Bir oyuncu için tek bir tespiti veya bir tespit grubunu duraklatır | Muafiyet ve Duraklatma Export'ları |
AllowTeleport | Scriptli bir ışınlanma işaretlenmesin diye hareket kontrollerini duraklatır | Muafiyet ve Duraklatma Export'ları |
FlagPlayer | Kendi tespitini bildirir ve bir ceza uygular | Özel İşaretleme ve Güven |
GetTrustScore | Oyuncunun güven puanını ve seviyesini döndürür | Özel İşaretleme ve Güven |
IsActive | Anticheat'in çalışıp çalışmadığını ve lisanslı olup olmadığını söyler | Özel İşaretleme ve Güven |
GetEventGuardConfig ve ReportEventAbuse, Event Guard tarafından kullanılan iç export'lardır; scriptlerinden çağrılmak için değildir.
Özellikler
Ban ve Kick
Yönetici menünün, Discord botunun veya meslek scriptinin ayrı bir liste yerine CXA Anticheat ile aynı ban listesini kullanmasını istiyorsan bunu kullan.
Örnek: Yönetici menünde bir Banla butonu var. Buton BanPlayer çağırdığında oyuncu CXA-7KQ2MX gibi bir CXA ban ID'si alır, ban ekranını görür ve Bans webhook kanalına loglanır. Bundan sonra CXA, tıpkı otomatik bir banda olduğu gibi oyuncuyu her girişte engeller. Ban ve Kick Export'ları sayfasını oku.
Muafiyet ve Duraklatma
Scriptlerinden biri, hile gibi görünecek bir şeyi bilerek yapıyorsa bunu kullan: ışınlanma, ara sahne ya da oyuncuyu gizleyen bir karakter oluşturma ekranı gibi.
Örnek: Yönetici ışınlanma scriptin bir oyuncuyu haritanın öbür ucuna taşıyor. Önce AllowTeleport çağırırsan o oyuncunun hareket kontrolleri birkaç saniye duraklar ve ışınlanma işaretlenmez. CXA'da tespit bazlı bir muafiyet izni olmadığı için, tek bir oyuncu için tek bir tespiti kapatmanın yolu da budur. Muafiyet ve Duraklatma Export'ları sayfasını oku.
Özel İşaretleme ve Güven
Kendi scriptlerin bir şeyin imkansız olduğunu biliyorsa ya da bir özelliği yalnızca CXA ağının güvendiği hesaplara açmak istiyorsan bunu kullan.
Örnek: Kargo mesleğin hiçbir zaman sabit bir tutardan fazla ödeme yapmıyor. Bir oyuncunun isteği çok daha fazlasını isterse scriptin ödemeyi reddeder ve FlagPlayer çağırır; deneme, diğer CXA tespitleri gibi loglanır. Aynı şekilde bir oyuncu pazarı GetTrustScore ile bakıp yalnızca yellow seviyesi ve üstündeki satıcılara izin verebilir. Özel İşaretleme ve Güven sayfasını oku.
Öneriler
Bilmekte Fayda Var
- Bir export'a güvenmeden önce
GetResourceState('cxa-anticheat')veIsActive()ile kontrol et, Lua çağrılarınıpcalliçine al. - Export'ları yalnızca durumu zaten doğrulamış sunucu kodundan çağır. Bir oyuncunun duraklatılıp duraklatılmayacağına veya muaf tutulup tutulmayacağına tek başına bir client eventi karar vermesin.
- Tespit anahtarları ve ceza değerleri büyük/küçük harfe duyarlıdır. Onları Tüm Tespitler sayfasından kopyala.
BanPlayerbanları veFlagPlayerişaretlemeleri, CXA'nın kendi tespitleriyle aynı webhook kanallarında ve panel sekmelerinde görünür; yetkililerin tek bir geçmiş görür.
İlgili Özellikler
Yetkili Muafiyeti
IsPlayerBypassedveRefreshBypass, muafiyet kurallarını Yetkili Muafiyeti ayarlarından okur.- Muaf oyuncular tüm kontrolleri atlar, bu yüzden
FlagPlayeronlar için hiçbir şey yapmaz.
Banlar ve CXA Ağı
BanPlayerbanları, panel vecxabankomutuyla aynı ban listesini kullanır. Bkz. Banlar ve CXA Ağı.UnbanPlayer, ban CXA ağında paylaşıldıysa onu ağdan da geri çeker.
Loglama ve Discord
- Export'lardan gelen banlar ve işaretlemeler webhook kanallarına ve paneldeki Tespitler sekmesine gider. Bkz. Loglama ve Discord.
Sık Karşılaşılan Sorunlar
"No such export ... in resource cxa-anticheat"
Ne görürsün: Scriptin No such export IsActive in resource cxa-anticheat hatasıyla durur (export adı çağrına göre değişir). (cxa-anticheat resource'unda böyle bir export yok.)
Nasıl düzeltilir:
cxa-anticheatresource'unun başladığından emin ol.server.cfgdosyasındaensure cxa-anticheatsatırını kendi resource'unun üstüne koy.- Export'u bir sunucu scriptinden çağırdığını kontrol et. Export'lar client tarafında yoktur.
- Yazımı kontrol et. Export adları büyük/küçük harfe duyarlıdır:
banPlayerdeğil,BanPlayer.
Export false Dönüyor veya Hiçbir Şey Dönmüyor
Ne görürsün: Çağrı çalışıyor ama false veya nil dönüyor ve hiçbir şey olmuyor.
Nasıl düzeltilir:
IsActive()sonucuna bak. Anticheat çalışmıyorkenBanPlayerveFlagPlayerfalsedöner, ban listesi de anticheat başlayana kadar boş kalır.- Oyuncunun hâlâ çevrimiçi olduğunu kontrol et. Sunucu ID'si alan export'lar, oyundan çıkmış oyuncular için
falsedöner. - Lua'da iki nokta üst üste kullan. Nokta kullanırsan tüm argümanlar bir sıra kayar:
-- ❌ Nokta: oyuncu ID'si kaybolur, çağrı false döner
exports['cxa-anticheat'].KickPlayer(source, 'Reason')
-- ✅ İki nokta: argümanlar doğru sırayla gelir
exports['cxa-anticheat']:KickPlayer(source, 'Reason')// ❌ TypeScript'te iki nokta söz dizimi yoktur
// exports['cxa-anticheat']:KickPlayer(source, 'Reason');
// ✅ Nokta söz dizimi
exports['cxa-anticheat'].KickPlayer(source, 'Reason');© 2026 CodeXart Studios · CXA Anticheat