Config & Performance
Diese Seite erklärt die Einstellungen in tosun-ac/configs/anticheat_config.lua. Für jede Einstellung: was sie schützt, Performance-Auswirkung und empfohlener Wert.
Faustregel: einen ms/Sek-Wert erhöhen = weniger CPU/DB-Last (Panel aktualisiert etwas später). Verringern = schnellere Reaktion, aber mehr Last. Halten Sie jede action in der ersten Woche auf "log", um Falsch-Positive abzustimmen, dann auf "kick"/"ban".
Performance-Budget — was kostet was
| Funktion | Kosten | Gewicht |
|---|
LiveWatch (Live-Bild/Video) | Client-Capture + Netzwerk + DB | 🔴 Hoch |
ResourceGuard.deepScan | Server-CPU (jede .lua/.js hashen) | 🔴 Hoch |
BackdoorGuard / signatureScan | Periodische CPU + Disk | 🟠 Mittel |
| v12 VPN-Check | Externe API beim Connect (gecacht) | 🟡 Niedrig |
| Erkennungen (Client-Loop) | Spieler-CPU | 🟢 Sehr niedrig |
LiveWatch — die schwerste Funktion
ts.LiveWatch.interval (1500ms ≈ 6,7 FPS): niedriger Wert = viel mehr Netzwerk+CPU. Empfohlen: 1500 mit tosun_render, 2500–3000 mit screenshot-basic. quality 0,7 ideal; maxConcurrent 3 für kleine, 5–8 für große Server.
ServerPerf — Lag-/Hitch-Reduzierung
| Einstellung | Std. | Empfohlen |
|---|
panelPlayerSyncIntervalMs | 12000 | 12000 (großer Server 15–20k) |
liveWatchDbPollMs | 4500 | 4500 |
configSyncIntervalSec | 120 | 120 (nie <60 — Overflow-Risiko) |
Guards (Server-CPU)
ResourceGuard.deepScan = false lassen (wenn an, wird jede Datei gehasht; schwer — nur bei Audit aktivieren).BackdoorGuard.scanIntervalMs 1800000 (30m); auf großen Servern 3600000, 0 = nur Start.BackdoorGuard.autoQuarantine = false (ein Falsch-Positiv könnte eine legitime Ressource stoppen; zuerst im Panel prüfen).EventScanner.scanIntervalMs 3600000 (1h) — geringe Last.
Erkennungen
Erkennungen laufen auf dem Client des Spielers → fast keine Serverlast, sehr niedrige Client-CPU. Lassen Sie alle an; einziges Risiko sind Falsch-Positive. Mit ts.confirmHits eine Erkennung 2–3 Mal bestätigen, bevor gebannt wird (reduziert FP stark, keine Perf-Kosten).
v12 (VPN / Cleanup / Heartbeat)
enableVpnCheck = true (fängt Ban-Evasion; externe API beim Connect, 3s Timeout, 24h Cache).blockHosting = false empfohlen (VPS/Staff-Falsch-Positive).keepDetectionsDays 90 — auf vollen Servern 30–60, um die Tabelle klein zu halten.
Schnellempfehlungen
- Lag? → ServerPerf-Werte erhöhen, LiveWatch.interval erhöhen, deepScan=false, BackdoorGuard-Intervall erhöhen.
- Maximale Sicherheit? → alle Aktionen kick/ban, autoBlockInfected/autoQuarantine als Pilot, launcherGate (falls Launcher).
- Immer: erste Woche "log", confirmHits an, Blacklist/Whitelist im Panel verwalten, Debug=false.
Nahezu jede Einstellung wird unten einzeln erklärt.
A) Grundeinstellungen
| Einstellung | Std. | Beschreibung / Empfehlung |
|---|
Debug | false | Entwickler-Logs — in Produktion false |
Locale | "tr" | Sprache (tr/en/de/fr/es/pt/ru/zh) |
punishType | BAN | Standardstrafe: LOG / KICK / BAN |
banIDFormat | 1 | 1=ABCD-1234, 2=#1234 |
autoSQL | false | Beim ersten Start Tabellen anlegen → dann false |
showReason | true | Bann-Grund dem Spieler zeigen |
spoilerIP | true | IP in Logs verbergen (Datenschutz) |
needDiscord | false | Discord-Verknüpfung beim Beitritt erforderlich |
txAdminAuth | true | txAdmin-Adminrechte anerkennen |
NuiNeverBanUnauthorized | true | Unautorisiertes NUI → nur Log (kein Bann) |
screenshotModule | screenshot-basic | Screenshot-Quelle (tosun_render flüssiger) |
B) Erkennungen — vollständige Liste (alle an lassen, ~keine Perf)
Alle laufen auf dem Client; keine Serverlast. Risiko sind Falsch-Positive → erste Woche punishType="LOG", confirmHits an.
Aim / Kampf
antiAimbot / antiSilentAim | Auto-/Silent-Aim |
antiInstantAim / antiMicroJitter / antiGimbalLook | Aim-Snap / Mikro-Jitter / 360°-Blick |
antiSpoofedShot / antiBulletTracer | Gefälschter Schuss / Kugel-Ursprung |
antiNoRecoil / antiRapidFire / antiMagicBullet | Kein Rückstoß / Schnellfeuer / Wallbang |
antiInfiniteAmmo / antiExplosiveAmmo | Unendliche / explosive Munition |
antiDamageBoost / antiWeaponDamageBoost / antiDamageMod | Schadensmultiplikator (Limit weaponDamageMultMax 1.10) |
antiMeleeDamageBoost / antiMeleeDefenseBoost | Nahkampf Schaden/Verteidigung (1.08/1.12) |
antiThermal / antiNightVision / antiRadar | Thermal/NV/Radar (Radar standardmäßig aus) |
antiVDM / antiKill / antiTaze | VDM / unautorisierter Kill / Taze-Grief |
Bewegung / Körper
antiGodMode / antiPlayerInvincible | Unverwundbarkeit |
antiNoClip / antiVehicleNoClip | No-Clip (noclipHeightMin 3m, noclipFlatSpeedMin 3 m/s) |
antiTeleport / antiTeleportInVeh | Teleport (teleportDistance 0=auto, Fahrzeug 90m) |
antiFastRun / antiOnFootSpeedHack / antiSprintHack | Tempo (onFootSpeedMax 12 m/s, runSprintMultMax 1.15) |
antiSpeedHack | Fahrzeugtempo + Handling |
antiSuperJump / antiInfiniteRoll | Supersprung / endlose Rolle |
antiInfiniteStamina / antiStaminaRecoveryHack / antiSwimMultHack | Ausdauer-/Schwimm-Multiplikatoren |
antiHealthRegenSpike / antiArmorRegenSpike | HP/Rüstung-Spike (55 / 65 pro Sek) |
antiIllegalExtraHealth / antiIllegalExtraArmor | Limit-Überschreitung (200 / 100) |
antiInvisible / antiSmallPed / antiPedSwap | Unsichtbarkeit / kleiner Ped / Ped-Swap |
antiFreeCam / antiSpectate / antiBlips | Freecam/Spectate/Blip-ESP (freecamMaxDistance 45m) |
Fahrzeug
antiVehicleGodmode / antiVehicleHealthHack | Fahrzeug-Unverwundbarkeit/HP (vehHealthCapMax 1100) |
antiVehicleTopSpeedMod / antiVehCheatPower | Top-Speed/Motorleistung (1.10 / 1.12) |
antiVehiclePlayerDmgBoost / antiVehicleDefenseBoost | Fahrzeug Schaden/Verteidigung |
antiVehicleGravityAbuse | Schwerkraft-Missbrauch (0.35–16.0) |
antiBlacklistedVehicles / ...Spawn | Blacklist-Fahrzeug / Spawn |
antiBlacklistPlate / antiPlateChange | Blacklist-Kennzeichen / Kennzeichenwechsel |
Spawn / Entity / Visuell
antiEntitySpawn / antiSpamPed / antiPeds / antiAIs | Massen-Fahrzeug/Objekt/Ped-Spawn |
antiBlacklistedWeapon / antiGiveWeapons / antiRemoveWeapons | Blacklist/unautorisierte Waffen |
antiObjectAttach / antiAttachChainAbuse | Objekt-Attach-Missbrauch (Kettentiefe 4) |
antiExplosionBlacklist / antiExplosiveAmmo | Explosions-Blacklist |
antiOverlay / antiMenus / antiNUIDevTools | Overlay / Mod-Menü / NUI-DevTools |
antiPickups / antiClipboardPaste | Standardmäßig AUS (Datenschutz/FP) |
System / Integrität
antiResourceInjection / antiResourceClone / antiCustomNative | Runtime-Injektion / Manifest-Klon / Native-Hook |
antiFileTampering / antiCipherBypass / antiHWIDSpoof | Datei-Manipulation / Cipher-Spoof / HWID-Wechsel |
antiResourceStop / antiResourceStart / antiModuleStop | Unautorisiertes Stoppen/Starten von Ressourcen/Modulen |
antiStatebagCrash / antiServerEventSpam / antiCommandSpam | Statebag-Crash / Event-Befehl-Spam |
antiClearTasks / BlacklistedTasks / antiFold | ClearTasks-Missbrauch / verbotene Task |
fakeTriggers / messageBlacklist | Honeypot-Fake-Event / verbotener Chat+OCR |
antiLowFPSMacro | Low-FPS-Makro (lowFPSThreshold 6) |
C) Schwellen / Toleranzen (FP-Abstimmung)
confirmHits (noclip 3, teleport 3, fastrun 2…) | N-mal bestätigen vor Bann — reduziert FP stark |
spawnGraceSecondsMs 35000 | Erkennungsfreies Fenster nach Spawn |
noclipStrikeMax 3 / fakeTriggerStrikeMax 2 | Toleranz aufeinanderfolgender Treffer |
instantAimDegPerFrame 75 / gimbalLookDegPerFrame 270 | Aim/Blick-Winkelschwellen (erhöhen = weniger FP) |
maximumModifier 2.0 | Globales Multiplikator-Limit |
D) Systemblöcke (action: log→kick→ban)
| Block | Funktion / Empfehlung |
|---|
shield | Native Hooks + verstecktes NUI Fingerprint/Heartbeat + WebGL-Screenshot/Video als Beweis beim Bann. nuiHeartbeatAction zuerst "log" |
nativeGuard | Externer tosun-guard.exe RAM/Speicher-Scan. action "log"→"kick", requireGuard true wenn Guard ausgeliefert |
shieldAi | Objekt/Fahrzeug/Ped-AI-Spawn-Ratenlimit (maxVehiclePerSec 4). action "cancel" |
shieldExplosion | Unsichtbare/lautlose Explosionen blocken (action "ban") |
premiumGuard | Particle/Projectile/Sound/Ragdoll/requestControl-Guard + Ratenlimit. Alle zuerst "log" |
guard (Watchdog) | Separate tosun-guard-Ressource Lebenszeichen. action "log" (kein FP wenn Guard fehlt) |
v16 serverMovement | Serverseitiger Teleport (teleportSpeedFlag 150 m/s, action "log") |
cloudBridge | Threat-Score + zentrale Threat-Intel-Abfrage (threatIntelMinScore 70, "log") |
launcherGate | Nur-Launcher-Beitritt — false lassen, außer Sie liefern einen Launcher |
licenseLock | Produkt-Lizenzsperre — in Produktion "log", dann "reject" |
Framework.moneyCheck | Geld-Cheat (moneyCheckThreshold 5M hart, moneySoftThreshold 75k weich) |
PhoneNotify / connectingCard / AdminMenu | Telefon-Benachrichtigungen / Connect-Karte / Admin-Menü |
E) Preset-Pakete
| Szenario | Empfohlen |
|---|
| RP-Server (ausgewogen) | Alle action = "log" (erste Woche) → dann "kick"; confirmHits an; blockHosting=false; LiveWatch an; launcherGate=false |
| Hardcore / PvP | Aktionen "ban"; nativeGuard.action="kick"; shieldExplosion="ban"; Schwellen verschärfen; premiumGuard "kick" |
| Wenig RAM / VPS | deepScan=false; LiveWatch.interval 3000; ServerPerf-Werte erhöhen; BackdoorGuard.scanIntervalMs 3600000; keepDetectionsDays 30 |
| Maximale Sicherheit | launcherGate=true (falls Launcher); requireGuard=true; autoBlockInfected/autoQuarantine Pilot; alle Aktionen "ban"; licenseLock "reject" |
F) Falsch-Banns reduzieren
- Erste Woche
punishType="LOG" + jeder Block action="log" — echte Spieler beobachten und abstimmen.
- Mit
ts.confirmHits eine Erkennung 2–3 Mal bestätigen vor Bann.
- Schwellen lockern:
instantAimDegPerFrame, maxVehicleTeleportDistance, onFootSpeedMax erhöhen.
- Dauerhafte Ausnahme: Panel → AC → Whitelist. Für temporäre/aktivitätsbasierte Ausnahmen Exports:
exports['tosun-ac']:AddWhitelist("license:abc", 3600) -- 1 Stunde befreit
exports['tosun-ac']:WhitelistArea(src, "parkour", 120) -- während einer Aktivität
exports['tosun-ac']:BypassDetection(src, {"antiTeleport","antiFastRun"}, 8000)
exports['tosun-ac']:SetPlayerExempt(src, true, 60000, "kleidung")
G) Fehlerbehebung
| Symptom | Lösung |
|---|
| AC verbindet nicht (roter Heartbeat) | Ist Panel-ac_api_key = FiveM-webPanelKey? Ist fivem_url die Spielserver-Adresse (nicht das Web-Panel)? Ist tosun-ac gestartet? |
| Spieler können nicht beitreten | launcherGate.enabled=false (ohne Launcher); firstHeartbeatDeadline erhöhen (schwere Server); bei VPN blockHosting=false |
| Lag / Hitch | ServerPerf-Werte erhöhen; LiveWatch.interval erhöhen; ResourceGuard.deepScan=false; BackdoorGuard.scanIntervalMs erhöhen |
| Staff/VPS falscher VPN-Bann | bypassStaffIpCheck=true; blockHosting=false; Staff zu AdminBypassIdentifiers hinzufügen |
| Legitimer Spieler gebannt (FP) | Diese action="log"; confirmHits erhöhen; Schwelle lockern; per Export ausnehmen |
| Reliable-Network-Overflow-Fehler | NetworkJoin-Werte nicht verringern; configSyncIntervalSec ≥ 60 halten |
Vollständige Liste aller Erkennungsschlüssel und Panel-An/Aus: Panel → AC-Einstellungen.