CXA Anticheat Kurulumu
CXA Anticheat diğer FiveM resource'ları gibi kurulur: tek bir klasörü sunucuna kopyalarsın, server.cfg dosyasına (sunucunun neyi başlatacağını söyleyen dosya) iki satır eklersin ve sunucuyu yeniden başlatırsın. Ayarların web panelinde durur, korunmak için hiçbir Lua dosyasını düzenlemen gerekmez.
Başlamadan Önce
CXA-XXXXX-XXXXX-XXXXX-XXXXX biçiminde aktif bir lisans anahtarına ve OneSync açık bir FiveM sunucusuna ihtiyacın var. Henüz anahtarın yoksa önce Lisans ve Sunucu IP'si sayfasını oku.
Gereksinimler
| Gereksinim | Neden gerekli |
|---|---|
| OneSync açık FiveM sunucusu (FXServer) | Sunucu taraflı kontroller, yalnızca OneSync ile var olan entity, hasar ve patlama eventlerini okur. |
| CXA lisans anahtarı | Anticheat başlarken lisansı kontrol eder ve yapılandırmanı panelden indirir. |
codexart.net adresine giden HTTPS erişimi | Sunucun lisansı doğrular ve config değişikliklerini HTTPS üzerinden alır. |
oxmysql (opsiyonel, önerilir) | Banları veritabanına kaydeder. Yoksa banlar data/bans.json dosyasına yazılır. |
screenshot-basic (opsiyonel) | Ekran Görüntüleri ve Canlı Ekranlar için gerekir. |
CXA Anticheat ESX, QBCore, Qbox ve standalone sunucularla çalışır. Framework'ü kendisi algılar, senin bir şey seçmene gerek yoktur.
Kurulum Adımları
Adım 1 — Dosyaları Al
cxa-anticheat resource'unu satın alımınla birlikte sana gelen indirme bağlantısından indir. Arşivi sakla; yeniden kurulumda tekrar kullanabilirsin.
Adım 2 — Klasörü Yükle
Arşivi bilgisayarında çıkar ve cxa-anticheat klasörünün tamamını sunucundaki resources klasörüne yükle, örneğin resources/[security]/cxa-anticheat.
Yüklemeden sonra klasörde şunlar olmalı:
fxmanifest.lua,config.lua,sv_config.luavelocales.luaclient,server,lib,webvedataklasörleri
Klasörün Tamamını Yükle
Klasörü tek seferde yükle ya da arşivi doğrudan sunucuda çıkar. Web dosya yöneticisiyle dosyaları tek tek yüklemek çoğu zaman bazı dosyaları atlar ve resource başlamaz.
Klasörün Adını Değiştirme
Klasörün adı tam olarak cxa-anticheat kalmalı. Ad değiştirilirse anticheat kendini kapatır ve konsola kırmızı bir hata yazar. Bu, başka bir adla çalışan değiştirilmiş kopyalara karşı seni korur.
Adım 3 — Lisans Anahtarını Ekle
Anahtarını server.cfg dosyasına yaz. Önerilen yol budur, çünkü server.cfg oyunculara hiçbir zaman gönderilmez.
# CXA lisans anahtarın. "setr" veya "sets" değil "set" kullan,
# böylece anahtar sunucuda kalır ve oyunculara asla gösterilmez.
set cxa_license "CXA-XXXXX-XXXXX-XXXXX-XXXXX"İstersen anahtarı sv_config.lua dosyasına da yazabilirsin. Bu dosya da yalnızca sunucuda kalır.
SvConfig.License = {
Key = 'CXA-XXXXX-XXXXX-XXXXX-XXXXX', -- Boş bırakırsan cxa_license convar'ı kullanılır
ApiUrl = 'https://codexart.net/api/anticheat', -- Destek ekibi söylemedikçe değiştirme
OfflineGraceHours = 72, -- API'mize ulaşılamazsa son config ile korumaya devam eder
AutoReload = true, -- Panelde yeni config kaydettiğinde anticheat'i yeniden yükler
UsePanelSecrets = true, -- Panelde girilen webhooklar bu dosyadakilerin yerine geçer
}Anahtarını Gizli Tut
Anahtarına sahip olan herkes onunla bir sunucu başlatmayı deneyebilir. server.cfg veya sv_config.lua dosyanı asla herkese açık yerlerde paylaşma. Anahtarı config.lua dosyasına da taşıma; config.lua oyuncuların da okuyabildiği ortak bir dosyadır.
Adım 4 — server.cfg Dosyasını Düzenle
ensure cxa-anticheat satırını veritabanından, framework'ünden ve screenshot-basic'ten sonra ekle. CXA başlarken bu resource'lara bakar, bu yüzden onların zaten çalışıyor olması gerekir.
# 1. Veritabanı (opsiyonel, CXA'nın banları MySQL'e kaydetmesini sağlar)
ensure oxmysql
# 2. Framework'ün, örneğin bunlardan biri
ensure qb-core
# ensure es_extended
# ensure qbx_core
# 3. Ekran görüntüleri ve ekran izleme (opsiyonel)
ensure screenshot-basic
# 4. CXA Anticheat: önce lisans anahtarı, sonra resource
set cxa_license "CXA-XXXXX-XXXXX-XXXXX-XXXXX"
ensure cxa-anticheat
# 5. Opsiyonel: admin grubunun hiçbir kontrole takılmaması
add_ace group.admin cxa.bypass allowSon satır opsiyoneldir. ACE izinlerini (FiveM'in yerleşik yetki sistemi) kullanarak anticheat'in adminlerini kontrol etmesini engeller. Kimleri kapsadığını tam olarak bilmek için eklemeden önce Yetkili Muafiyeti sayfasını oku.
Adım 5 — İlk Başlatma
Sadece resource'u değil, sunucunun tamamını yeniden başlat ve konsolu izle. Birkaç saniye sonra şuna benzer satırlar görmelisin:
[CXA] License verified (remote), configuration v1.
[CXA] Illegal RPF scanner active without pure mode (sv_pureLevel 0), legal graphics mods can still join.
[CXA] Anticheat started | Framework: qbcore | Storage: oxmysql | Active bans: 0Bu satırları görüyorsan CXA Anticheat kurulmuş ve sunucunu koruyor demektir. Framework, depolama türü ve ban sayısı kendi sunucuna göre değişir; satırların sırası da farklı olabilir.
Lisansı İlk Sunucu Bağlar
Anahtarınla ilk başlayan sunucu, lisansı kendi IP adresine bağlar. Anahtarı bir test makinesinde değil, korumak istediğin sunucuda başlat. Ayrıca bir test sunucusu da kullanacaksan ikinci bir lisans gerekir. Bkz. Lisans ve Sunucu IP'si.
İlk Başlatmadan Sonra
Kontrol Panelini Aç
- codexart.net/anticheat/panel adresine git ve giriş yap.
- Lisansını aç.
- Genel bakış (Overview) sekmesi, sunucunu bir dakika içinde çevrimiçi olarak gösterir.
Ödemede kullandığın e-posta codexart.net hesabına aitse lisans zaten hesabına tanımlı ve aktiftir. Değilse önce anahtarı panelde etkinleştir. Ayrıntılar için Lisans ve Sunucu IP'si sayfasına bak.
CXA'ya Yetkililerini Tanıt
Anticheat'in hangi yetkilileri tamamen atlayacağına, hangilerinin yalnızca komutlara erişeceğine karar ver. Yetkili Muafiyeti ve Yetkili Rolleri ve Komut Erişimi sayfalarını oku.
Tespit Ayarlarını Gözden Geçir
Panelde Yapılandırma (Configuration) bölümünü aç ve client ile sunucu tespitlerini tek tek incele. Yeni bir sunucuda, scriptlerinle çakışabilecek tespitleri birkaç gün log olarak bırak, logları kontrol et, sonra kick veya ban yap. Her cezanın anlamı Tespitler ve Cezalar sayfasında anlatılıyor. AI Asistanıyla Config sayfası da ayarları scriptlerine göre bir AI asistanına nasıl yaptıracağını gösteriyor.
Her Şeyin Çalıştığını Kontrol Et
- Sunucuna gir.
- Panelde Oyuncular (Players) bölümünü aç ve çevrimiçi listede kendini gördüğünü kontrol et.
- Bir yetkili rolün varsa, oyun içi paneli açmak için oyun sohbetine
/cxayaz.
Yeni Sürüme Güncelleme
Güncellemek için resource dosyalarını yeni sürümle değiştir ve sunucuyu yeniden başlat. Eski klasöründen şu iki dosyayı sakla:
sv_config.lua, çünkü lisans anahtarın ve webhookların bu dosyadadırdata/bans.json, yalnızca banları MySQL yerine JSON'da tutuyorsan
Tespit ayarların panelde saklandığı için güncellemeden sonra aynı kalır.
Sık Karşılaşılan Sorunlar
"This resource must be named "cxa-anticheat""
Ne görürsün: Konsol şunu yazar: [CXA] This resource must be named "cxa-anticheat" but it is "...". The anticheat is disabled until the folder is renamed and the server restarted. (Resource'un adı "cxa-anticheat" olmalı; klasör yeniden adlandırılıp sunucu yeniden başlatılana kadar anticheat kapalı.)
Nasıl düzeltilir:
- Klasörün adını tam olarak
cxa-anticheatyap: tamamı küçük harf, arada tire. ensuresatırınıensure cxa-anticheatolarak düzelt.- Sunucunun tamamını yeniden başlat.
"No valid license key"
Ne görürsün: Konsol şunu yazar: No valid license key. Set SvConfig.License.Key or add: set cxa_license "CXA-XXXXX-..." to server.cfg (Geçerli bir lisans anahtarı yok.)
Nasıl düzeltilir:
set cxa_licensesatırınınensure cxa-anticheatsatırının üstünde olduğunu kontrol et.- Anahtarda yazım hatası var mı bak. Elle yazmak yerine panelden kopyala.
- Anahtarın çift tırnak içinde olduğundan emin ol.
"License key is not redeemed yet"
Ne görürsün: Anahtar var ama henüz bir hesaba tanımlanmamış (etkinleştirilmemiş).
Nasıl düzeltilir:
- Panele giriş yap, anahtarı etkinleştir ve sunucuyu yeniden başlat.
"This license is bound to another server IP"
Ne görürsün: Lisans ilk olarak başka bir IP adresinde başlatılmış.
Nasıl düzeltilir:
- Anahtarı yalnızca bağlı olduğu sunucuda başlat.
- Yeni bir hostinge geçtiysen kontrol panelinden ticket aç, lisansı taşıyalım.
- İkinci bir sunucu çalıştıracaksan ek lisans al.
"License has expired" veya "License is suspended"
Ne görürsün: Lisansın süresi dolmuş veya lisans askıya alınmış.
Nasıl düzeltilir:
- Lisansını CXA Anticheat sayfasından yenile. Sunucu yenilemeyi kendisi algılar.
- Askıya alınmış bir lisans için kontrol panelinden ticket aç.
"Anticheat did not start: no verified license or configuration yet"
Ne görürsün: Sunucu codexart.net adresine ulaşamadı ve geri dönebileceği kayıtlı bir yapılandırması yok.
Nasıl düzeltilir:
- Hostingin giden HTTPS bağlantılarına izin veriyor mu kontrol et. Bazı güvenlik duvarları bunları varsayılan olarak engeller.
sv_config.luaiçindekiApiUrldeğerinin hâlâhttps://codexart.net/api/anticheatolduğundan emin ol.- Bağlantı düzelince sunucuyu yeniden başlat.
"oxmysql is not started, bans will be stored in data/bans.json"
Ne görürsün: CXA başlarken oxmysql resource'unu bulamadı.
Nasıl düzeltilir:
ensure oxmysqlsatırınıensure cxa-anticheatsatırının üstüne taşı.- MySQL kullanmıyorsan bir sorun yok: banlar
data/bans.jsondosyasına kaydedilir.
Sunucum Panelde Görünmüyor
Ne görürsün: Konsolda hata yok ama panel sunucuyu çevrimdışı gösteriyor.
Nasıl düzeltilir:
- Bir dakika bekle. Lisans doğrulandıktan sonra sunucu panele birkaç saniyede bir rapor verir.
- Panelde açtığın lisansın,
server.cfgdosyasındaki anahtarla aynı olduğunu kontrol et. - Konsolda sarı renkli bir
[CXA]uyarısı ara ve bu sitede o mesajı arat.
© 2026 CodeXart Studios · CXA Anticheat