Config & Performans

Bu sayfa tosun-ac/configs/anticheat_config.lua ayarlarını açıklar. Her ayar için ne korur, performans etkisi ve önerilen değer verilmiştir.

Altın kural: ms/sn değerini büyütmek = daha az CPU/DB yükü (panel biraz geç güncellenir). Küçültmek = daha hızlı tepki ama daha çok yük. İlk hafta tüm action değerlerini "log" tutun, false-positive ayıklayın, sonra "kick"/"ban"'a geçin.

Performans bütçesi — neyin ne kadar yük getirdiği

ÖzellikYükAğırlık
LiveWatch (canlı ekran/video)İstemci capture + ağ + DB🔴 Yüksek
ResourceGuard.deepScanSunucu CPU (her .lua/.js hash)🔴 Yüksek
BackdoorGuard / signatureScanPeriyodik CPU + disk🟠 Orta
v12 VPN checkBağlantıda dış API (cache'li)🟡 Düşük
Tespitler (client loop)Oyuncu makinesi CPU🟢 Çok düşük

LiveWatch — en ağır özellik

ts.LiveWatch.interval (1500ms ≈ 6.7 FPS): küçük değer = çok daha fazla ağ+CPU. Önerilen: tosun_render ile 1500, screenshot-basic ile 2500–3000. quality 0.7 ideal; maxConcurrent küçük sunucuda 3, büyükte 5–8.

ServerPerf — lag / hitch azaltma

AyarVars.Önerilen
panelPlayerSyncIntervalMs1200012000 (büyük sunucu 15–20k)
liveWatchDbPollMs45004500
configSyncIntervalSec120120 (asla <60 — overflow riski)

Guard'lar (sunucu CPU)

  • ResourceGuard.deepScan = false tutun (açıkken her dosya hashlenir, yük ciddi artar; yalnız denetimde açın).
  • ResourceGuard.resyncInterval 90000 — küçültmek sık hashing demek.
  • BackdoorGuard.scanIntervalMs 1800000 (30dk); büyük sunucuda 3600000 yapın, 0 = sadece açılış.
  • BackdoorGuard.autoQuarantine = false (false-positive'de meşru kaynağı durdurabilir; önce panelde inceleyin).
  • EventScanner.scanIntervalMs 3600000 (1sa) — düşük yük.

Tespitler (detections)

Tespitler oyuncu istemcisinde döner → sunucu yükü ~yok, istemci CPU'su çok düşük. Hepsi açık olmalı; tek risk false-positive. ts.confirmHits ile bir tespiti banlamadan önce 2–3 kez doğrulayın (FP'yi büyük ölçüde azaltır, perf maliyeti yok).

v12 (VPN / temizlik / heartbeat)

  • enableVpnCheck = true (ban-evasion'ı yakalar; bağlantıda dış API, 3sn timeout, 24sa cache).
  • blockHosting = false önerilir (VPS/staff false-positive).
  • keepDetectionsDays 90 — yoğun sunucuda 30–60 yaparak tabloyu küçük tutun.
Hızlı öneriler
  • Lag mı var? → ServerPerf değerlerini büyüt, LiveWatch.interval artır, deepScan=false, BackdoorGuard aralığını büyüt.
  • Maksimum güvenlik? → tüm action'lar kick/ban, autoBlockInfected/autoQuarantine pilot, launcherGate (launcher dağıttıysan).
  • Her zaman: ilk hafta "log", confirmHits aç, kara liste/whitelist'i panelden yönet, Debug=false.

Aşağıda neredeyse tüm ayarlar tek tek açıklanmıştır.

A) Temel ayarlar

AyarVars.Açıklama / Öneri
DebugfalseGeliştirici logları — üretimde false
Locale"tr"Dil (tr/en/de/fr/es/pt/ru/zh)
punishTypeBANVarsayılan ceza: LOG / KICK / BAN
banIDFormat11=ABCD-1234, 2=#1234
autoSQLfalseİlk boot'ta tablo kur → sonra false
showReasontrueBan sebebini oyuncuya göster
spoilerIPtrueLoglarda IP'yi gizle (gizlilik)
needDiscordfalseGirişte Discord bağlama zorunlu
maxUsernameLength-1-1 = sınırsız
txAdminAuthtruetxAdmin admin yetkisini tanı
NuiNeverBanUnauthorizedtrueYetkisiz NUI'de ban yerine sadece log
screenshotModulescreenshot-basicEkran görüntüsü kaynağı (tosun_render daha akıcı)

B) Tespitler — tam liste (hepsi açık önerilir, perf ~yok)

Tümü oyuncu istemcisinde döner; sunucu yükü yok. Risk false-positive → ilk hafta punishType="LOG", confirmHits açık.

Aim / Combat

antiAimbotOtomatik nişan
antiSilentAimGörünmeyen/sessiz aim
antiInstantAim1 frame'de 60°+ aim snap
antiMicroJitterAimbot mikro titremesi
antiGimbalLookTek frame'de 360° bakış
antiSpoofedShot / antiBulletTracerSahte atış/mermi kaynağı
antiNoRecoil / antiRapidFireGeri tepmesiz / hızlı ateş
antiMagicBulletDuvardan/engelden vurma
antiInfiniteAmmo / antiExplosiveAmmoSınırsız / patlayıcı mermi
antiDamageBoost / antiWeaponDamageBoost / antiDamageModHasar çarpanı (eşik: weaponDamageMultMax 1.10)
antiMeleeDamageBoost / antiMeleeDefenseBoostYakın dövüş hasar/savunma (1.08/1.12)
antiThermal / antiNightVision / antiRadarTermal/gece görüş/radar (radar varsayılan kapalı)
antiVDM / antiKill / antiTazeAraçla ezme / yetkisiz öldürme / taze grief

Hareket / Beden

antiGodMode / antiPlayerInvincibleÖlümsüzlük
antiNoClip / antiNoclip / antiVehicleNoClipDuvardan geçme (eşik: noclipHeightMin 3m, noclipFlatSpeedMin 3 m/s)
antiTeleport / antiTeleportInVehIşınlanma (eşik: teleportDistance 0=otomatik, araç maxVehicleTeleportDistance 90m)
antiFastRun / antiOnFootSpeedHack / antiSprintHackHızlı koşma (eşik: onFootSpeedMax 12 m/s, runSprintMultMax 1.15)
antiSpeedHackAraç hız + handling
antiSuperJump / antiInfiniteRollSüper zıplama / sonsuz takla
antiInfiniteStamina / antiStaminaRecoveryHack / antiSwimMultHackStamina/yüzme çarpanı
antiHealthRegenSpike / antiArmorRegenSpikeAni can/zırh artışı (healthRegenMaxPerSec 55, armorRegenMaxPerSec 65)
antiIllegalExtraHealth / antiIllegalExtraArmorÜst sınır aşımı (200 / 100)
antiInvisible / antiSmallPed / antiPedSwapGörünmezlik / küçük ped / ped swap
antiFreeCam / antiSpectate / antiBlipsFreecam/spectate/blip ESP (freecamMaxDistance 45m)

Araç

antiVehicleGodmode / antiVehicleHealthHackAraç ölümsüzlük/can taşması (vehHealthCapMax 1100)
antiVehicleTopSpeedMod / antiVehCheatPowerTop-speed/motor gücü (1.10 / 1.12)
antiVehiclePlayerDmgBoost / antiVehicleDefenseBoostAraç hasar/savunma çarpanı
antiVehicleGravityAbuseYerçekimi abuse (0.35–16.0)
antiBlacklistedVehicles / antiBlacklistedVehiclesSpawnKara liste araç / spawn
antiBlacklistPlate / antiPlateChangeKara liste plaka / plaka değişimi

Spawn / Entity / Görsel

antiEntitySpawn / antiSpamPed / antiPeds / antiAIsToplu araç/obje/ped spawn
antiBlacklistedWeapon / antiGiveWeapons / antiRemoveWeaponsKara liste/yetkisiz silah
antiObjectAttach / antiAttachChainAbuseObje attach abuse (zincir derinliği 4)
antiExplosionBlacklist / antiExplosiveAmmoPatlama kara listesi
antiOverlay / antiMenus / antiNUIDevToolsEkran overlay / mod menü / NUI DevTools
antiPickups / antiClipboardPasteVarsayılan KAPALI (gizlilik/FP)

Sistem / Bütünlük

antiResourceInjection / antiResourceClone / antiCustomNativeRuntime enjeksiyon / manifest klon / native hook
antiFileTampering / antiCipherBypass / antiHWIDSpoofDosya manipülasyonu / cipher spoof / HWID değişimi
antiResourceStop / antiResourceStart / antiModuleStopYetkisiz resource/modül durdurma-başlatma
antiStatebagCrash / antiServerEventSpam / antiCommandSpamStatebag crash / event-komut spam
antiClearTasks / BlacklistedTasks / antiFoldClearTasks abuse / yasaklı task
fakeTriggers / messageBlacklistHoneypot sahte event / yasaklı sohbet+OCR
antiLowFPSMacroDüşük FPS makro (lowFPSThreshold 6)

C) Eşik / tolerans değerleri (false-positive ayarı)

confirmHits (noclip 3, teleport 3, fastrun 2…)Banlamadan önce N kez doğrula — FP'yi büyük ölçüde azaltır
spawnGraceSecondsMs 35000Spawn sonrası tespitsiz süre
noclipStrikeMax 3 / fakeTriggerStrikeMax 2Ardışık isabet toleransı
instantAimDegPerFrame 75 / gimbalLookDegPerFrame 270Aim/bakış açı eşikleri (büyüt = daha az FP)
maximumModifier 2.0Genel çarpan üst sınırı

D) Sistem blokları (action: log→kick→ban)

BlokNe yapar / Öneri
shieldNative hook + gizli NUI fingerprint/heartbeat + ban anı WebGL screenshot/video kanıtı. nuiHeartbeatAction önce "log"
nativeGuardHarici tosun-guard.exe ile RAM/bellek tarama. action "log"→"kick", requireGuard guard dağıttıysan true
shieldAiObje/araç/ped AI spawn rate-limit (maxVehiclePerSec 4, maxObjectPerSec 25). action "cancel"
shieldExplosionGörünmez/sessiz patlama engeli (action "ban")
premiumGuardParticle/projectile/sound/ragdoll/requestControl guard + rate-limit. Tümü önce "log"
guard (watchdog)Ayrı tosun-guard resource canlılık kontrolü. action "log" (guard yoksa FP olmasın)
v16 serverMovementSunucu-taraflı ışınlanma (teleportSpeedFlag 150 m/s, action "log")
cloudBridgeThreat-score + merkezi threat-intel sorgusu (threatIntelMinScore 70, action "log")
launcherGateSadece launcher ile giriş — launcher dağıtmadıysan false bırak
licenseLockÜrün dağıtımı lisans kilidi — üretimde önce "log", sonra "reject"
Framework.moneyCheckPara hilesi (moneyCheckThreshold 5M sert, moneySoftThreshold 75k yumuşak)
PhoneNotify / connectingCard / AdminMenuTelefon bildirimi / bağlantı kartı / yönetici menüsü

E) Hazır ayar setleri (preset)

SenaryoÖnerilen
RP sunucusu (dengeli)Tüm action = "log" (ilk hafta) → sonra "kick"; confirmHits açık; blockHosting=false; LiveWatch açık; launcherGate=false
Hardcore / PvPaction'lar "ban"; nativeGuard.action="kick"; shieldExplosion="ban"; eşikleri sıkılaştır; premiumGuard "kick"
Düşük-RAM / VPSdeepScan=false; LiveWatch.interval 3000; ServerPerf değerlerini büyüt; BackdoorGuard.scanIntervalMs 3600000; keepDetectionsDays 30
Maksimum güvenliklauncherGate=true (launcher dağıttıysan); requireGuard=true; autoBlockInfected/autoQuarantine pilot; tüm action "ban"; licenseLock "reject"

F) False-ban (yanlış ban) azaltma

  • İlk hafta punishType="LOG" + her blok action="log" — gerçek oyuncuyu izleyip ayıkla.
  • ts.confirmHits ile bir tespiti banlamadan önce 2–3 kez doğrula.
  • Eşikleri gevşet: instantAimDegPerFrame, maxVehicleTeleportDistance, onFootSpeedMax vb. büyüt.
  • Kalıcı muafiyet: panel → AC → Whitelist. Geçici/aktivite bazlı muafiyet için export'lar:
exports['tosun-ac']:AddWhitelist("license:abc", 3600)   -- 1 saat muaf
exports['tosun-ac']:WhitelistArea(src, "parkur", 120)   -- aktivite süresince
exports['tosun-ac']:BypassDetection(src, {"antiTeleport","antiFastRun"}, 8000)
exports['tosun-ac']:SetPlayerExempt(src, true, 60000, "kiyafet")

G) Sorun giderme

BelirtiÇözüm
AC panele bağlanmıyor (heartbeat kırmızı)Panel ac_api_key = FiveM webPanelKey aynı mı? fivem_url oyun sunucusu adresi mi (web değil)? tosun-ac started mı?
Oyuncular giremiyorlauncherGate.enabled=false yap (launcher yoksa); firstHeartbeatDeadline'ı artır (ağır kaynaklı sunucu); VPN ise blockHosting=false
Lag / hitchServerPerf değerlerini büyüt; LiveWatch.interval artır; ResourceGuard.deepScan=false; BackdoorGuard.scanIntervalMs büyüt
Staff/VPS yanlış VPN-banbypassStaffIpCheck=true; blockHosting=false; staff'ı AdminBypassIdentifiers'a ekle
Meşru oyuncu banlanıyor (FP)İlgili action="log" yap; confirmHits artır; eşiği gevşet; export ile muaf tut
Reliable network overflow hatasıNetworkJoin değerlerini düşürme; configSyncIntervalSec ≥ 60 tut

Tüm tespit anahtarlarının tam listesi ve panelden aç/kapa: panel → AC Ayarları.

Ana sayfa Tosun Dev Docs