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
| Özellik | Yük | Ağırlık |
LiveWatch (canlı ekran/video) | İstemci capture + ağ + DB | 🔴 Yüksek |
ResourceGuard.deepScan | Sunucu CPU (her .lua/.js hash) | 🔴 Yüksek |
BackdoorGuard / signatureScan | Periyodik CPU + disk | 🟠 Orta |
| v12 VPN check | Bağ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
| Ayar | Vars. | Önerilen |
panelPlayerSyncIntervalMs | 12000 | 12000 (büyük sunucu 15–20k) |
liveWatchDbPollMs | 4500 | 4500 |
configSyncIntervalSec | 120 | 120 (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
| Ayar | Vars. | Açıklama / Öneri |
Debug | false | Geliştirici logları — üretimde false |
Locale | "tr" | Dil (tr/en/de/fr/es/pt/ru/zh) |
punishType | BAN | Varsayılan ceza: LOG / KICK / BAN |
banIDFormat | 1 | 1=ABCD-1234, 2=#1234 |
autoSQL | false | İlk boot'ta tablo kur → sonra false |
showReason | true | Ban sebebini oyuncuya göster |
spoilerIP | true | Loglarda IP'yi gizle (gizlilik) |
needDiscord | false | Girişte Discord bağlama zorunlu |
maxUsernameLength | -1 | -1 = sınırsız |
txAdminAuth | true | txAdmin admin yetkisini tanı |
NuiNeverBanUnauthorized | true | Yetkisiz NUI'de ban yerine sadece log |
screenshotModule | screenshot-basic | Ekran 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
antiAimbot | Otomatik nişan |
antiSilentAim | Görünmeyen/sessiz aim |
antiInstantAim | 1 frame'de 60°+ aim snap |
antiMicroJitter | Aimbot mikro titremesi |
antiGimbalLook | Tek frame'de 360° bakış |
antiSpoofedShot / antiBulletTracer | Sahte atış/mermi kaynağı |
antiNoRecoil / antiRapidFire | Geri tepmesiz / hızlı ateş |
antiMagicBullet | Duvardan/engelden vurma |
antiInfiniteAmmo / antiExplosiveAmmo | Sınırsız / patlayıcı mermi |
antiDamageBoost / antiWeaponDamageBoost / antiDamageMod | Hasar çarpanı (eşik: weaponDamageMultMax 1.10) |
antiMeleeDamageBoost / antiMeleeDefenseBoost | Yakın dövüş hasar/savunma (1.08/1.12) |
antiThermal / antiNightVision / antiRadar | Termal/gece görüş/radar (radar varsayılan kapalı) |
antiVDM / antiKill / antiTaze | Araçla ezme / yetkisiz öldürme / taze grief |
Hareket / Beden
antiGodMode / antiPlayerInvincible | Ölümsüzlük |
antiNoClip / antiNoclip / antiVehicleNoClip | Duvardan geçme (eşik: noclipHeightMin 3m, noclipFlatSpeedMin 3 m/s) |
antiTeleport / antiTeleportInVeh | Işınlanma (eşik: teleportDistance 0=otomatik, araç maxVehicleTeleportDistance 90m) |
antiFastRun / antiOnFootSpeedHack / antiSprintHack | Hızlı koşma (eşik: onFootSpeedMax 12 m/s, runSprintMultMax 1.15) |
antiSpeedHack | Araç hız + handling |
antiSuperJump / antiInfiniteRoll | Süper zıplama / sonsuz takla |
antiInfiniteStamina / antiStaminaRecoveryHack / antiSwimMultHack | Stamina/yüzme çarpanı |
antiHealthRegenSpike / antiArmorRegenSpike | Ani can/zırh artışı (healthRegenMaxPerSec 55, armorRegenMaxPerSec 65) |
antiIllegalExtraHealth / antiIllegalExtraArmor | Üst sınır aşımı (200 / 100) |
antiInvisible / antiSmallPed / antiPedSwap | Görünmezlik / küçük ped / ped swap |
antiFreeCam / antiSpectate / antiBlips | Freecam/spectate/blip ESP (freecamMaxDistance 45m) |
Araç
antiVehicleGodmode / antiVehicleHealthHack | Araç ölümsüzlük/can taşması (vehHealthCapMax 1100) |
antiVehicleTopSpeedMod / antiVehCheatPower | Top-speed/motor gücü (1.10 / 1.12) |
antiVehiclePlayerDmgBoost / antiVehicleDefenseBoost | Araç hasar/savunma çarpanı |
antiVehicleGravityAbuse | Yerçekimi abuse (0.35–16.0) |
antiBlacklistedVehicles / antiBlacklistedVehiclesSpawn | Kara liste araç / spawn |
antiBlacklistPlate / antiPlateChange | Kara liste plaka / plaka değişimi |
Spawn / Entity / Görsel
antiEntitySpawn / antiSpamPed / antiPeds / antiAIs | Toplu araç/obje/ped spawn |
antiBlacklistedWeapon / antiGiveWeapons / antiRemoveWeapons | Kara liste/yetkisiz silah |
antiObjectAttach / antiAttachChainAbuse | Obje attach abuse (zincir derinliği 4) |
antiExplosionBlacklist / antiExplosiveAmmo | Patlama kara listesi |
antiOverlay / antiMenus / antiNUIDevTools | Ekran overlay / mod menü / NUI DevTools |
antiPickups / antiClipboardPaste | Varsayılan KAPALI (gizlilik/FP) |
Sistem / Bütünlük
antiResourceInjection / antiResourceClone / antiCustomNative | Runtime enjeksiyon / manifest klon / native hook |
antiFileTampering / antiCipherBypass / antiHWIDSpoof | Dosya manipülasyonu / cipher spoof / HWID değişimi |
antiResourceStop / antiResourceStart / antiModuleStop | Yetkisiz resource/modül durdurma-başlatma |
antiStatebagCrash / antiServerEventSpam / antiCommandSpam | Statebag crash / event-komut spam |
antiClearTasks / BlacklistedTasks / antiFold | ClearTasks abuse / yasaklı task |
fakeTriggers / messageBlacklist | Honeypot sahte event / yasaklı sohbet+OCR |
antiLowFPSMacro | Düşü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 35000 | Spawn sonrası tespitsiz süre |
noclipStrikeMax 3 / fakeTriggerStrikeMax 2 | Ardışık isabet toleransı |
instantAimDegPerFrame 75 / gimbalLookDegPerFrame 270 | Aim/bakış açı eşikleri (büyüt = daha az FP) |
maximumModifier 2.0 | Genel çarpan üst sınırı |
D) Sistem blokları (action: log→kick→ban)
| Blok | Ne yapar / Öneri |
shield | Native hook + gizli NUI fingerprint/heartbeat + ban anı WebGL screenshot/video kanıtı. nuiHeartbeatAction önce "log" |
nativeGuard | Harici tosun-guard.exe ile RAM/bellek tarama. action "log"→"kick", requireGuard guard dağıttıysan true |
shieldAi | Obje/araç/ped AI spawn rate-limit (maxVehiclePerSec 4, maxObjectPerSec 25). action "cancel" |
shieldExplosion | Görünmez/sessiz patlama engeli (action "ban") |
premiumGuard | Particle/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 serverMovement | Sunucu-taraflı ışınlanma (teleportSpeedFlag 150 m/s, action "log") |
cloudBridge | Threat-score + merkezi threat-intel sorgusu (threatIntelMinScore 70, action "log") |
launcherGate | Sadece launcher ile giriş — launcher dağıtmadıysan false bırak |
licenseLock | Ürün dağıtımı lisans kilidi — üretimde önce "log", sonra "reject" |
Framework.moneyCheck | Para hilesi (moneyCheckThreshold 5M sert, moneySoftThreshold 75k yumuşak) |
PhoneNotify / connectingCard / AdminMenu | Telefon 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 / PvP | action'lar "ban"; nativeGuard.action="kick"; shieldExplosion="ban"; eşikleri sıkılaştır; premiumGuard "kick" |
| Düşük-RAM / VPS | deepScan=false; LiveWatch.interval 3000; ServerPerf değerlerini büyüt; BackdoorGuard.scanIntervalMs 3600000; keepDetectionsDays 30 |
| Maksimum güvenlik | launcherGate=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 giremiyor | launcherGate.enabled=false yap (launcher yoksa); firstHeartbeatDeadline'ı artır (ağır kaynaklı sunucu); VPN ise blockHosting=false |
| Lag / hitch | ServerPerf değerlerini büyüt; LiveWatch.interval artır; ResourceGuard.deepScan=false; BackdoorGuard.scanIntervalMs büyüt |
| Staff/VPS yanlış VPN-ban | bypassStaffIpCheck=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ı.