Config & Performance
Cette page explique les réglages de tosun-ac/configs/anticheat_config.lua. Pour chaque réglage : ce qu'il protège, l'impact sur les performances et la valeur recommandée.
Règle d'or : augmenter une valeur ms/sec = moins de charge CPU/DB (le panel se met à jour un peu plus tard). La baisser = réaction plus rapide mais plus de charge. Gardez chaque action sur "log" la première semaine pour régler les faux positifs, puis passez à "kick"/"ban".
Budget de performance — ce qui coûte quoi
| Fonction | Coût | Poids |
|---|
LiveWatch (écran/vidéo en direct) | Capture client + réseau + DB | 🔴 Élevé |
ResourceGuard.deepScan | CPU serveur (hash de chaque .lua/.js) | 🔴 Élevé |
BackdoorGuard / signatureScan | CPU périodique + disque | 🟠 Moyen |
| v12 VPN check | API externe à la connexion (en cache) | 🟡 Faible |
| Détections (boucle client) | CPU de la machine du joueur | 🟢 Très faible |
LiveWatch — la fonction la plus lourde
ts.LiveWatch.interval (1500ms ≈ 6,7 FPS) : valeur plus basse = beaucoup plus de réseau+CPU. Recommandé : 1500 avec tosun_render, 2500–3000 avec screenshot-basic. quality 0,7 idéal ; maxConcurrent 3 pour petits serveurs, 5–8 pour grands.
ServerPerf — réduction du lag / hitch
| Réglage | Déf. | Recommandé |
|---|
panelPlayerSyncIntervalMs | 12000 | 12000 (grand serveur 15–20k) |
liveWatchDbPollMs | 4500 | 4500 |
configSyncIntervalSec | 120 | 120 (jamais <60 — risque d'overflow) |
Guards (CPU serveur)
ResourceGuard.deepScan = false (si activé, chaque fichier est hashé ; lourd — activez uniquement lors d'un audit).BackdoorGuard.scanIntervalMs 1800000 (30 min) ; 3600000 sur grands serveurs, 0 = démarrage seulement.BackdoorGuard.autoQuarantine = false (un faux positif pourrait arrêter une ressource légitime ; vérifiez d'abord dans le panel).EventScanner.scanIntervalMs 3600000 (1h) — coût faible.
Détections
Les détections s'exécutent sur le client du joueur → presque aucune charge serveur, CPU client très faible. Gardez-les toutes activées ; le seul risque est les faux positifs. Utilisez ts.confirmHits pour confirmer une détection 2–3 fois avant de bannir (réduit fortement les FP, sans coût de performance).
v12 (VPN / nettoyage / heartbeat)
enableVpnCheck = true (détecte le contournement de ban ; API externe à la connexion, 3s timeout, 24h cache).blockHosting = false recommandé (faux positifs VPS/staff).keepDetectionsDays 90 — utilisez 30–60 sur serveurs chargés pour garder la table petite.
Recommandations rapides
- Lag ? → augmentez les valeurs ServerPerf, augmentez LiveWatch.interval, deepScan=false, augmentez l'intervalle BackdoorGuard.
- Sécurité maximale ? → toutes les actions kick/ban, autoBlockInfected/autoQuarantine en pilote, launcherGate (si vous fournissez un launcher).
- Toujours : "log" la première semaine, confirmHits activé, gérez blacklist/whitelist depuis le panel, Debug=false.
Presque chaque réglage est expliqué un par un ci-dessous.
A) Réglages de base
| Réglage | Déf. | Description / Recommandation |
|---|
Debug | false | Logs développeur — false en production |
Locale | "tr" | Langue (tr/en/de/fr/es/pt/ru/zh) |
punishType | BAN | Sanction par défaut : LOG / KICK / BAN |
banIDFormat | 1 | 1=ABCD-1234, 2=#1234 |
autoSQL | false | Créer les tables au 1er démarrage → puis false |
showReason | true | Montrer la raison du ban au joueur |
spoilerIP | true | Masquer l'IP dans les logs (confidentialité) |
needDiscord | false | Exiger la liaison Discord à la connexion |
txAdminAuth | true | Reconnaître les droits admin txAdmin |
NuiNeverBanUnauthorized | true | NUI non autorisé → log seulement (pas de ban) |
screenshotModule | screenshot-basic | Source des captures (tosun_render plus fluide) |
B) Détections — liste complète (toutes activées, ~aucune perf)
Toutes s'exécutent sur le client ; aucune charge serveur. Le risque est les faux positifs → première semaine punishType="LOG", confirmHits activé.
Aim / Combat
antiAimbot / antiSilentAim | Aim auto / silencieux |
antiInstantAim / antiMicroJitter / antiGimbalLook | Aim-snap / micro-jitter / regard 360° |
antiSpoofedShot / antiBulletTracer | Tir / origine de balle falsifiés |
antiNoRecoil / antiRapidFire / antiMagicBullet | Sans recul / tir rapide / wallbang |
antiInfiniteAmmo / antiExplosiveAmmo | Munitions infinies / explosives |
antiDamageBoost / antiWeaponDamageBoost / antiDamageMod | Multiplicateur de dégâts (limite weaponDamageMultMax 1.10) |
antiMeleeDamageBoost / antiMeleeDefenseBoost | Dégâts/défense au corps à corps (1.08/1.12) |
antiThermal / antiNightVision / antiRadar | Thermique/vision nocturne/radar (radar off par défaut) |
antiVDM / antiKill / antiTaze | VDM / kill non autorisé / taze grief |
Déplacement / Corps
antiGodMode / antiPlayerInvincible | Invincibilité |
antiNoClip / antiVehicleNoClip | No-clip (noclipHeightMin 3m, noclipFlatSpeedMin 3 m/s) |
antiTeleport / antiTeleportInVeh | Téléport (teleportDistance 0=auto, véhicule 90m) |
antiFastRun / antiOnFootSpeedHack / antiSprintHack | Vitesse (onFootSpeedMax 12 m/s, runSprintMultMax 1.15) |
antiSpeedHack | Vitesse + handling du véhicule |
antiSuperJump / antiInfiniteRoll | Super saut / roulade infinie |
antiInfiniteStamina / antiStaminaRecoveryHack / antiSwimMultHack | Multiplicateurs d'endurance/nage |
antiHealthRegenSpike / antiArmorRegenSpike | Pic PV/armure (55 / 65 par sec) |
antiIllegalExtraHealth / antiIllegalExtraArmor | Dépassement de limite (200 / 100) |
antiInvisible / antiSmallPed / antiPedSwap | Invisibilité / petit ped / changement de ped |
antiFreeCam / antiSpectate / antiBlips | Freecam/spectate/blip ESP (freecamMaxDistance 45m) |
Véhicule
antiVehicleGodmode / antiVehicleHealthHack | Invincibilité/PV du véhicule (vehHealthCapMax 1100) |
antiVehicleTopSpeedMod / antiVehCheatPower | Vitesse max/puissance moteur (1.10 / 1.12) |
antiVehiclePlayerDmgBoost / antiVehicleDefenseBoost | Multiplicateur dégâts/défense du véhicule |
antiVehicleGravityAbuse | Abus de gravité (0.35–16.0) |
antiBlacklistedVehicles / ...Spawn | Véhicule en liste noire / spawn |
antiBlacklistPlate / antiPlateChange | Plaque en liste noire / changement de plaque |
Spawn / Entité / Visuel
antiEntitySpawn / antiSpamPed / antiPeds / antiAIs | Spawn massif de véhicule/objet/ped |
antiBlacklistedWeapon / antiGiveWeapons / antiRemoveWeapons | Armes en liste noire/non autorisées |
antiObjectAttach / antiAttachChainAbuse | Abus d'attache d'objets (profondeur 4) |
antiExplosionBlacklist / antiExplosiveAmmo | Liste noire d'explosions |
antiOverlay / antiMenus / antiNUIDevTools | Overlay / mod menu / NUI DevTools |
antiPickups / antiClipboardPaste | Désactivé par défaut (confidentialité/FP) |
Système / Intégrité
antiResourceInjection / antiResourceClone / antiCustomNative | Injection runtime / clone de manifest / native hook |
antiFileTampering / antiCipherBypass / antiHWIDSpoof | Altération de fichiers / cipher spoof / changement HWID |
antiResourceStop / antiResourceStart / antiModuleStop | Arrêt/démarrage non autorisé de ressources/modules |
antiStatebagCrash / antiServerEventSpam / antiCommandSpam | Crash statebag / spam d'events-commandes |
antiClearTasks / BlacklistedTasks / antiFold | Abus de ClearTasks / task en liste noire |
fakeTriggers / messageBlacklist | Faux event honeypot / chat interdit+OCR |
antiLowFPSMacro | Macro bas FPS (lowFPSThreshold 6) |
C) Seuils / tolérances (réglage des faux positifs)
confirmHits (noclip 3, teleport 3, fastrun 2…) | Confirmer N fois avant de bannir — réduit fortement les FP |
spawnGraceSecondsMs 35000 | Fenêtre sans détection après le spawn |
noclipStrikeMax 3 / fakeTriggerStrikeMax 2 | Tolérance d'impacts consécutifs |
instantAimDegPerFrame 75 / gimbalLookDegPerFrame 270 | Seuils d'angle aim/regard (augmenter = moins de FP) |
maximumModifier 2.0 | Limite globale de multiplicateur |
D) Blocs système (action : log→kick→ban)
| Bloc | Rôle / Recommandation |
|---|
shield | Native hooks + NUI caché fingerprint/heartbeat + capture/vidéo WebGL comme preuve au ban. nuiHeartbeatAction "log" d'abord |
nativeGuard | Scan RAM/mémoire via tosun-guard.exe externe. action "log"→"kick", requireGuard true si vous fournissez le guard |
shieldAi | Limite de débit spawn AI objet/véhicule/ped (maxVehiclePerSec 4). action "cancel" |
shieldExplosion | Bloquer explosions invisibles/inaudibles (action "ban") |
premiumGuard | Guard particle/projectile/sound/ragdoll/requestControl + limite de débit. Tous "log" d'abord |
guard (watchdog) | Vivacité de la ressource tosun-guard séparée. action "log" (pas de FP si guard absent) |
v16 serverMovement | Téléport côté serveur (teleportSpeedFlag 150 m/s, action "log") |
cloudBridge | Threat-score + requête centrale de threat-intel (threatIntelMinScore 70, "log") |
launcherGate | Connexion launcher uniquement — laissez false sauf si vous fournissez un launcher |
licenseLock | Verrou de licence produit — "log" puis "reject" en production |
Framework.moneyCheck | Triche d'argent (moneyCheckThreshold 5M dur, moneySoftThreshold 75k souple) |
PhoneNotify / connectingCard / AdminMenu | Alertes téléphone / carte de connexion / menu admin |
E) Packs préconfigurés
| Scénario | Recommandé |
|---|
| Serveur RP (équilibré) | Toutes les action = "log" (1re semaine) → puis "kick" ; confirmHits on ; blockHosting=false ; LiveWatch on ; launcherGate=false |
| Hardcore / PvP | actions "ban" ; nativeGuard.action="kick" ; shieldExplosion="ban" ; durcir les seuils ; premiumGuard "kick" |
| Peu de RAM / VPS | deepScan=false ; LiveWatch.interval 3000 ; augmenter ServerPerf ; BackdoorGuard.scanIntervalMs 3600000 ; keepDetectionsDays 30 |
| Sécurité maximale | launcherGate=true (si launcher) ; requireGuard=true ; autoBlockInfected/autoQuarantine pilote ; toutes actions "ban" ; licenseLock "reject" |
F) Réduire les faux bans
- Première semaine
punishType="LOG" + chaque bloc action="log" — observez les vrais joueurs et ajustez.
- Utilisez
ts.confirmHits pour confirmer une détection 2–3 fois avant de bannir.
- Assouplissez les seuils : augmentez
instantAimDegPerFrame, maxVehicleTeleportDistance, onFootSpeedMax, etc.
- Exemption permanente : panel → AC → Whitelist. Pour une exemption temporaire/par activité, utilisez les exports :
exports['tosun-ac']:AddWhitelist("license:abc", 3600) -- exempté 1 heure
exports['tosun-ac']:WhitelistArea(src, "parkour", 120) -- pendant une activité
exports['tosun-ac']:BypassDetection(src, {"antiTeleport","antiFastRun"}, 8000)
exports['tosun-ac']:SetPlayerExempt(src, true, 60000, "vetements")
G) Dépannage
| Symptôme | Solution |
|---|
| L'AC ne se connecte pas (heartbeat rouge) | Le ac_api_key du panel = le webPanelKey de FiveM ? fivem_url est-il l'adresse du serveur de jeu (pas le panel web) ? tosun-ac est-il démarré ? |
| Les joueurs ne peuvent pas se connecter | launcherGate.enabled=false (sans launcher) ; augmentez firstHeartbeatDeadline (serveurs lourds) ; si VPN blockHosting=false |
| Lag / hitch | Augmentez ServerPerf ; augmentez LiveWatch.interval ; ResourceGuard.deepScan=false ; augmentez BackdoorGuard.scanIntervalMs |
| Faux ban VPN staff/VPS | bypassStaffIpCheck=true ; blockHosting=false ; ajoutez le staff à AdminBypassIdentifiers |
| Joueur légitime banni (FP) | Mettez cette action="log" ; augmentez confirmHits ; assouplissez le seuil ; exemptez via export |
| Erreur reliable network overflow | Ne baissez pas les valeurs NetworkJoin ; gardez configSyncIntervalSec ≥ 60 |
Liste complète de toutes les clés de détection et activation/désactivation au panel : panel → Paramètres AC.