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)))

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

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ış

ExportNe yaparSayfa
BanPlayerÇevrimiçi bir oyuncuyu CXA ban ID'siyle banlar ve ban ekranıyla sunucudan atarBan ve Kick Export'ları
KickPlayerÇevrimiçi bir oyuncuyu kick ekranıyla sunucudan atarBan ve Kick Export'ları
UnbanPlayerAktif bir banı ban ID'siyle kaldırırBan ve Kick Export'ları
GetBanAktif bir banın kaydını döndürürBan ve Kick Export'ları
IsIdentifierBannedBir tanımlayıcının (identifier) veya donanım tokenının banlı olup olmadığına bakarBan ve Kick Export'ları
IsPlayerBypassedOyuncunun tüm kontrolleri atlayıp atlamadığını söylerMuafiyet ve Duraklatma Export'ları
RefreshBypassGrubunu değiştirdiğin oyuncunun muafiyetini yeniden hesaplarMuafiyet ve Duraklatma Export'ları
SetTemporaryBypassBir oyuncu için tüm tespitleri belirli bir saniye boyunca duraklatırMuafiyet ve Duraklatma Export'ları
PauseDetectionBir oyuncu için tek bir tespiti veya bir tespit grubunu duraklatırMuafiyet ve Duraklatma Export'ları
AllowTeleportScriptli bir ışınlanma işaretlenmesin diye hareket kontrollerini duraklatırMuafiyet ve Duraklatma Export'ları
FlagPlayerKendi tespitini bildirir ve bir ceza uygularÖzel İşaretleme ve Güven
GetTrustScoreOyuncunun güven puanını ve seviyesini döndürürÖzel İşaretleme ve Güven
IsActiveAnticheat'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') ve IsActive() ile kontrol et, Lua çağrılarını pcall iç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.
  • BanPlayer banları ve FlagPlayer iş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

  • IsPlayerBypassed ve RefreshBypass, muafiyet kurallarını Yetkili Muafiyeti ayarlarından okur.
  • Muaf oyuncular tüm kontrolleri atlar, bu yüzden FlagPlayer onlar için hiçbir şey yapmaz.

Banlar ve CXA Ağı

  • BanPlayer banları, panel ve cxaban komutuyla 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-anticheat resource'unun başladığından emin ol. server.cfg dosyasında ensure cxa-anticheat satı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: banPlayer değ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ıyorken BanPlayer ve FlagPlayer false dö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 false dö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')

© 2026 CodeXart Studios · CXA Anticheat