Özel İşaretleme ve Güven
Kendi scriptlerin, sunucunda neyin imkansız olduğunu çoğu zaman herhangi bir anticheat'ten daha iyi bilir; örneğin bir meslek için fazla yüksek bir ödeme. FlagPlayer ile bunu CXA Anticheat'e bildirirler, CXA da onu kendi tespitlerinden biri gibi loglar ve cezalandırır. GetTrustScore CXA ağının bir oyuncunun hesabına ne kadar güvendiğini, IsActive ise anticheat'in çalışıp çalışmadığını söyler.
İşaretleme, Kontrolün Kadar İyidir
FlagPlayer, scriptinin bildirdiği her şeyi cezalandırır. Her işaretlemeyi sunucunun bildiği gerçeklere dayandır; client'ın kontrolsüz gönderdiği bir değere asla güvenme. Yeni bir kontrolü kick veya ban yapmadan önce birkaç gün log ile çalıştır.
Ne Zaman Kullanılır
- Bir para, item veya ödül eventi, sunucunun imkansız olduğunu bildiği bir istek alıyorsa.
- Scriptlerinden biri normal oyunda olamayacak bir değer buluyorsa; örneğin malzemeleri atlayan bir üretim sonucu.
- Oyuncu pazarı veya VIP alanı gibi bir özellik yalnızca yeterli güvene sahip hesaplara açık olmalıysa.
- Scriptin CXA çalışırken onu kullanmalı, çalışmıyorken kendi loguna dönmeliyse.
Export'lar
FlagPlayer
Kendi tespitini bildirir ve bir ceza uygular.
exports['cxa-anticheat']:FlagPlayer(src, reason, punishment, hours)
Parametreler:
- src (number): Oyuncunun sunucu ID'si
- reason (string, opsiyonel): Scriptinin bulduğu şey. Loglarda ve ban ya da kick ekranında görünür. Varsayılan:
External detectionetiketi (Türkçe dildeHarici tespit) - punishment (string, opsiyonel):
ban,kick,warn,logveyanone, küçük harfle. Varsayılan:log - hours (number, opsiyonel):
baniçin saat cinsinden süre,0= kalıcı. Varsayılan: ban sistemi ayarlarındaki varsayılan süre (0)
Dönüş değeri: CXA işaretlemeyi işlediyse true. Buna none ve bekleme süresi yüzünden atlanan tekrar eden bir log veya warn da dahildir. Anticheat aktif değilse, oyuncu çevrimiçi değilse veya zaten sunucudan atılıyorsa, ya da oyuncu muafsa veya onun için External ya da all duraklatılmışsa false.
Ne olur:
- İşaretleme, "External detection" (Harici tespit) olarak gösterilen
Externaltespiti olarak işlenir. nonedışında CXA konsola bir satır yazar, çevrimiçi yetkililere sohbet uyarısı gönderir ve paneldeki Tespitler sekmesine sebebinle ve resource adınla bir kayıt ekler.- Oyuncunun ne gördüğünü ve mesajın hangi webhook kanalına gittiğini ceza belirler:
| Ceza | Oyuncunun gördüğü | Webhook kanalı |
|---|---|---|
ban | Banlanır ve sebebini gösteren ban ekranıyla sunucudan atılır | Bans |
kick | Sebebini gösteren kick ekranıyla sunucudan atılır | Kicks |
warn | Ekranda bir uyarı ve sohbette bir satır. Oyuncu sunucuda kalır | Warns |
log | Hiçbir şey | Detections |
none | Hiçbir şey. Log da yazılmaz | Yok |
logvewarniçin bir bekleme süresi vardır. Aynı oyuncu için 10 saniye içindeki tekrar eden işaretlemeler atlanır (loglama ayarlarındaki Tespit bekleme süresi). Tüm scriptlerinExternalanahtarını paylaştığı için bu bekleme süresini de paylaşır.- Ekran görüntüsü eklenmez.
- Uyarı metni senin sebebini değil, tespit etiketini gösterir:
Anticheat warning: External detection. Keep doing it and you will be removed from the server.(Türkçe dilde:Anticheat uyarısı: Harici tespit. Devam edersen sunucudan atılırsın.) FlagPlayerile verilen bir banıCXA Anticheatvermiş görünür. Ban, CXA ağında yalnızcaExternalanahtarını global banların paylaşılan tespitlerine eklersen paylaşılır; varsayılan olarak ekli değildir.
Çıktı: Konsol satırı şöyle görünür:
[CXA] John (ID: 12) -> External detection [log] reason: Delivery payout of 50000 (max 2500), resource: my-deliveryÇevrimiçi yetkililer [CXA] ön ekli ve John (ID: 12) flagged for External detection [log] metinli bir sohbet uyarısı alır (Türkçe dilde: John (ID: 12) şüpheli bulundu: Harici tespit [log]).
GetTrustScore
Oyuncunun güven puanını ve seviyesini döndürür.
exports['cxa-anticheat']:GetTrustScore(src)
Parametreler:
- src (number): Oyuncunun sunucu ID'si
Dönüş değeri: { score, band } tablosu ya da bilinen bir puan yoksa nil. JavaScript ve TypeScript'te "puan yok" sonucu undefined olarak gelir.
| Seviye | Puan |
|---|---|
red | 0 - 19 |
orange | 20 - 39 |
yellow | 40 - 59 |
lime | 60 - 79 |
green | 80 - 100 |
Ne olur:
- CXA ağı puanı oyuncu girerken hesap yaşlarından, bağlı hesaplardan, ağ geçmişinden ve global banlardan hesaplar. CXA bu puanı oturumun geri kalanında saklar. Bkz. Hesap Güveni.
- Güven puanı giriş kontrolü kapalıyken de puan oluşur. Steam hesap yaşı gibi bazı etkenlere yalnızca bu giriş kontrolü açıkken bakılır.
- Giriş taraması veya bağlanırken ağ kontrolü kapalıysa, ağa zamanında ulaşılamadıysa, oyuncunun
licensetanımlayıcısı yoksa ya da oyuncu muafiyet tanımlayıcı listesindeysenilalırsın; çünkü bu oyuncular giriş kontrollerini atlar. - CXA son kez yeniden başlamadan önce girmiş oyuncular için de, yeniden bağlanana kadar
nilalırsın.
IsActive
Anticheat'in çalışıp çalışmadığını ve lisanslı olup olmadığını söyler.
exports['cxa-anticheat']:IsActive()
Parametreler: Yok.
Dönüş değeri: Klasörün adı cxa-anticheat ise, anticheat başlamışsa ve lisans doğrulanmışsa true. Aksi halde false.
Ne olur:
- Hiçbir şey değişmez, yalnızca mevcut durum okunur.
- CXA yeniden başlarken export bir an için yoktur. Çağırmadan önce
GetResourceState('cxa-anticheat')ile kontrol et; Sunucu Export'ları sayfasında gösterildiği gibi.
Örnekler
İmkansız Ödemeleri İşaretle
Kargo mesleğin hiçbir zaman 2.500'den fazla ödemiyor. Sunucu istenen tutarı kontrol eder, daha yükseğini reddeder ve bildirir. Üçüncü işaretlemeden sonra oyuncu sunucudan atılır.
local MAX_PAYOUT = 2500 -- Bir teslimatın ödeyebileceği en yüksek tutar
local strikes = {}
RegisterNetEvent('my-delivery:server:finish', function(amount)
local src = source
amount = tonumber(amount) or 0
if amount > MAX_PAYOUT then
-- Önce ödemeyi reddet, sonra bildir
strikes[src] = (strikes[src] or 0) + 1
local punishment = strikes[src] >= 3 and 'kick' or 'log'
local reason = ('Delivery payout of %d (max %d)'):format(amount, MAX_PAYOUT)
exports['cxa-anticheat']:FlagPlayer(src, reason, punishment)
return
end
-- Oyuncuya ödemeyi burada framework'ünle yap
end)
AddEventHandler('playerDropped', function()
strikes[source] = nil -- Oyuncu çıkınca sayacı unut
end)const MAX_PAYOUT = 2500; // Bir teslimatın ödeyebileceği en yüksek tutar
const strikes = new Map<number, number>();
onNet('my-delivery:server:finish', (amount: number) => {
const src = source;
const value = Number(amount) || 0;
if (value > MAX_PAYOUT) {
// Önce ödemeyi reddet, sonra bildir
const count = (strikes.get(src) ?? 0) + 1;
strikes.set(src, count);
const punishment = count >= 3 ? 'kick' : 'log';
const reason = `Delivery payout of ${value} (max ${MAX_PAYOUT})`;
exports['cxa-anticheat'].FlagPlayer(src, reason, punishment);
return;
}
// Oyuncuya ödemeyi burada framework'ünle yap
});
on('playerDropped', () => {
strikes.delete(source); // Oyuncu çıkınca sayacı unut
});VIP Özelliğini Güven Seviyesine Bağla
VIP pazarına yalnızca yellow ve üstü seviyedeki hesaplar ürün koyabilir.
local BAND_RANK = { red = 1, orange = 2, yellow = 3, lime = 4, green = 5 }
local function hasTrust(src, minimumBand)
local trust = exports['cxa-anticheat']:GetTrustScore(src)
if not trust then
return false -- Puan bilinmiyor: izin verip vermeyeceğine kendin karar ver
end
return BAND_RANK[trust.band] >= BAND_RANK[minimumBand]
end
RegisterNetEvent('my-market:server:createListing', function(item, price)
local src = source
if not hasTrust(src, 'yellow') then
TriggerClientEvent('chat:addMessage', src, { args = { 'Market', 'Your account cannot sell on the VIP market yet.' } })
return
end
-- İlanı burada oluştur
end)const BAND_RANK: Record<string, number> = { red: 1, orange: 2, yellow: 3, lime: 4, green: 5 };
function hasTrust(src: number, minimumBand: string): boolean {
const trust = exports['cxa-anticheat'].GetTrustScore(src);
if (!trust) return false; // Puan bilinmiyor: izin verip vermeyeceğine kendin karar ver
return BAND_RANK[trust.band] >= BAND_RANK[minimumBand];
}
onNet('my-market:server:createListing', (item: string, price: number) => {
const src = source;
if (!hasTrust(src, 'yellow')) {
emitNet('chat:addMessage', src, { args: ['Market', 'Your account cannot sell on the VIP market yet.'] });
return;
}
// İlanı burada oluştur
});CXA Çalışmıyorsa Kendi Loguna Dön
local function report(src, reason)
local running = GetResourceState('cxa-anticheat') == 'started' and exports['cxa-anticheat']:IsActive()
if running then
exports['cxa-anticheat']:FlagPlayer(src, reason, 'log')
else
-- Anticheat yokken kendi logun
print(('[my-script] %s (%d): %s'):format(GetPlayerName(src), src, reason))
end
endfunction report(src: number, reason: string): void {
const running = GetResourceState('cxa-anticheat') === 'started' && exports['cxa-anticheat'].IsActive();
if (running) {
exports['cxa-anticheat'].FlagPlayer(src, reason, 'log');
} else {
// Anticheat yokken kendi logun
console.log(`[my-script] ${GetPlayerName(src.toString())} (${src}): ${reason}`);
}
}Tip Tanımları
type CxaPunishment = 'ban' | 'kick' | 'warn' | 'log' | 'none';
type CxaTrustBand = 'red' | 'orange' | 'yellow' | 'lime' | 'green';
interface CxaTrust {
score: number; // 0 ile 100 arası
band: CxaTrustBand;
}
interface CxaFlagExports {
FlagPlayer(src: number, reason?: string, punishment?: CxaPunishment, hours?: number): boolean;
GetTrustScore(src: number): CxaTrust | undefined;
IsActive(): boolean;
}
const cxa = exports['cxa-anticheat'] as CxaFlagExports;---@alias CxaPunishment 'ban'|'kick'|'warn'|'log'|'none'
---@alias CxaTrustBand 'red'|'orange'|'yellow'|'lime'|'green'
---@class CxaTrust
---@field score integer 0 ile 100 arası
---@field band CxaTrustBand
---@class CxaFlagExports
---@field FlagPlayer fun(self: CxaFlagExports, src: integer, reason?: string, punishment?: CxaPunishment, hours?: number): boolean
---@field GetTrustScore fun(self: CxaFlagExports, src: integer): CxaTrust|nil
---@field IsActive fun(self: CxaFlagExports): boolean
---@type CxaFlagExports
local cxa = exports['cxa-anticheat']Öneriler
Bilmekte Fayda Var
- Her yeni işaretlemeye
logile başla. Paneldeki Tespitler sekmesini birkaç gün izle, sonra cezayı yükselt. - Sebebe gerçekleri yaz: değeri, sınırı, itemi. Yetkililerin işaretlemeyi bu metne bakarak değerlendirir.
- İşaretlemeden önce işlemi reddet.
FlagPlayerbildirir; bir ödemeyi geri almaz. nilgüven puanını "kötü" değil "bilinmiyor" olarak değerlendir. CXA yeniden başlamadan önce girmiş oyuncuların, yeniden bağlanana kadar puanı yoktur.- Muaf olmayan bir oyuncuyla test et. Muafiyeti olan yetkililer hiçbir zaman işaretlenmez.
İlgili Özellikler
Tespitler ve Cezalar
ban,kick,warn,logvenone, CXA'nın kendi tespitlerinde nasıl çalışıyorsa aynen öyle çalışır. Bkz. Tespitler ve Cezalar.
Hesap Güveni
- Puanın ve seviyelerin nasıl hesaplandığı ve düşük güvenli hesapların girişte nasıl engelleneceği Hesap Güveni sayfasında anlatılıyor.
Loglama ve Discord
- İşaretlemeler cezaya göre Bans, Kicks, Warns veya Detections kanalına gider. Bkz. Loglama ve Discord.
Banlar ve CXA Ağı
FlagPlayerbanları,Externalanahtarını paylaşılan tespitlere eklemedikçe senin sunucunda kalır. Bkz. Banlar ve CXA Ağı.
Sık Karşılaşılan Sorunlar
FlagPlayer false Dönüyor
Ne görürsün: Çağrı false döner ve hiçbir şey loglanmaz.
Nasıl düzeltilir:
- Belki de yetkili olarak kendi üzerinde test ediyorsun. Muaf oyuncular hiçbir zaman işaretlenmez. Normal bir hesapla test et.
- Hiçbir scriptin o oyuncu için
Externalveyaallduraklatmadığını kontrol et. IsActive()sonucuna ve oyuncunun hâlâ çevrimiçi olduğuna bak.
Oyuncu Sunucuda Kalıyor ve Artık Kontrol Edilmiyor
Ne görürsün: Bir işaretlemeden sonra oyuncu sunucuda kalıyor ama CXA onu yok sayıyor, yeniden bağlanana kadar entitylerini ve patlamalarını engelliyor.
Nasıl düzeltilir:
- Ceza değeri desteklenen beş değerden biri değildi. Değeri tam yazıldığı gibi küçük harfle kullan. Başka bir değer
loggibi loglanır ama CXA oyuncuyu sonra zaten atılıyormuş gibi değerlendirir.
-- ❌ Büyük harf: desteklenen bir ceza değil
exports['cxa-anticheat']:FlagPlayer(src, 'Duplicated items', 'Kick')
-- ✅ Küçük harf
exports['cxa-anticheat']:FlagPlayer(src, 'Duplicated items', 'kick')// ❌ Büyük harf: desteklenen bir ceza değil
exports['cxa-anticheat'].FlagPlayer(src, 'Duplicated items', 'Kick');
// ✅ Küçük harf
exports['cxa-anticheat'].FlagPlayer(src, 'Duplicated items', 'kick');Yalnızca İlk İşaretleme Görünüyor
Ne görürsün: Scriptin bir oyuncuyu arka arkaya birkaç kez işaretliyor ama yalnızca bir kayıt görünüyor.
Nasıl düzeltilir:
- Bu,
logvewarniçin 10 saniyelik bekleme süresidir. Loglarını spamdan korur veFlagPlayerkullanan tüm scriptler tarafından paylaşılır. - Denemeleri kendi scriptinde say ve toplamla tek bir işaretleme gönder ya da yukarıdaki ödeme örneğindeki gibi birkaç denemeden sonra cezayı yükselt.
GetTrustScore nil Dönüyor
Ne görürsün: GetTrustScore, çevrimiçi bir oyuncu için nil dönüyor.
Nasıl düzeltilir:
- Panelde giriş taramasının ve bağlanırken ağ kontrolünün açık olduğunu kontrol et.
- CXA oyuncu girdikten sonra yeniden başladıysa puan, oyuncu yeniden bağlandığında geri gelir.
- Muafiyet tanımlayıcı listesindeki oyuncular giriş kontrollerini atlar ve hiçbir zaman puan almaz.
© 2026 CodeXart Studios · CXA Anticheat