Config & Performance
Esta página explica los ajustes de tosun-ac/configs/anticheat_config.lua. Para cada ajuste: qué protege, impacto en el rendimiento y valor recomendado.
Regla general: subir un valor ms/seg = menos carga de CPU/DB (el panel se actualiza un poco más tarde). Bajarlo = reacción más rápida pero más carga. Mantenga cada action en "log" la primera semana para ajustar falsos positivos, luego pase a "kick"/"ban".
Presupuesto de rendimiento — qué cuesta qué
| Función | Coste | Peso |
|---|
LiveWatch (pantalla/vídeo en vivo) | Captura cliente + red + DB | 🔴 Alto |
ResourceGuard.deepScan | CPU servidor (hash de cada .lua/.js) | 🔴 Alto |
BackdoorGuard / signatureScan | CPU periódica + disco | 🟠 Medio |
| v12 VPN check | API externa al conectar (en caché) | 🟡 Bajo |
| Detecciones (bucle cliente) | CPU de la máquina del jugador | 🟢 Muy bajo |
LiveWatch — la función más pesada
ts.LiveWatch.interval (1500ms ≈ 6,7 FPS): valor más bajo = mucha más red+CPU. Recomendado: 1500 con tosun_render, 2500–3000 con screenshot-basic. quality 0,7 ideal; maxConcurrent 3 para servidores pequeños, 5–8 para grandes.
ServerPerf — reducción de lag / hitch
| Ajuste | Pred. | Recomendado |
|---|
panelPlayerSyncIntervalMs | 12000 | 12000 (servidor grande 15–20k) |
liveWatchDbPollMs | 4500 | 4500 |
configSyncIntervalSec | 120 | 120 (nunca <60 — riesgo de overflow) |
Guards (CPU del servidor)
ResourceGuard.deepScan = false (si está activo, se hashea cada archivo; pesado — actívalo solo en auditoría).BackdoorGuard.scanIntervalMs 1800000 (30m); usa 3600000 en servidores grandes, 0 = solo arranque.BackdoorGuard.autoQuarantine = false (un falso positivo podría detener un recurso legítimo; revisa primero en el panel).EventScanner.scanIntervalMs 3600000 (1h) — coste bajo.
Detecciones
Las detecciones se ejecutan en el cliente del jugador → casi sin carga del servidor, CPU del cliente muy baja. Mantenlas todas activas; el único riesgo son los falsos positivos. Usa ts.confirmHits para confirmar una detección 2–3 veces antes de banear (reduce mucho los FP, sin coste de rendimiento).
v12 (VPN / limpieza / heartbeat)
enableVpnCheck = true (detecta evasión de baneo; API externa al conectar, 3s timeout, 24h caché).blockHosting = false recomendado (falsos positivos VPS/staff).keepDetectionsDays 90 — usa 30–60 en servidores con mucho tráfico para mantener la tabla pequeña.
Recomendaciones rápidas
- ¿Lag? → sube los valores de ServerPerf, sube LiveWatch.interval, deepScan=false, sube el intervalo de BackdoorGuard.
- ¿Máxima seguridad? → todas las acciones kick/ban, autoBlockInfected/autoQuarantine como piloto, launcherGate (si distribuyes un launcher).
- Siempre: "log" la primera semana, confirmHits activo, gestiona blacklist/whitelist desde el panel, Debug=false.
Casi todos los ajustes se explican uno por uno a continuación.
A) Ajustes básicos
| Ajuste | Pred. | Descripción / Recomendación |
|---|
Debug | false | Logs de desarrollo — false en producción |
Locale | "tr" | Idioma (tr/en/de/fr/es/pt/ru/zh) |
punishType | BAN | Castigo por defecto: LOG / KICK / BAN |
banIDFormat | 1 | 1=ABCD-1234, 2=#1234 |
autoSQL | false | Crear tablas en el primer arranque → luego false |
showReason | true | Mostrar el motivo del baneo al jugador |
spoilerIP | true | Ocultar IP en los logs (privacidad) |
needDiscord | false | Requerir vincular Discord al entrar |
txAdminAuth | true | Reconocer permisos de admin de txAdmin |
NuiNeverBanUnauthorized | true | NUI no autorizado → solo log (sin baneo) |
screenshotModule | screenshot-basic | Fuente de capturas (tosun_render más fluido) |
B) Detecciones — lista completa (mantener todas, ~sin perf)
Todas se ejecutan en el cliente; sin carga del servidor. El riesgo son los falsos positivos → primera semana punishType="LOG", confirmHits activo.
Aim / Combate
antiAimbot / antiSilentAim | Aim automático / silencioso |
antiInstantAim / antiMicroJitter / antiGimbalLook | Aim-snap / micro-jitter / giro 360° |
antiSpoofedShot / antiBulletTracer | Disparo / origen de bala falso |
antiNoRecoil / antiRapidFire / antiMagicBullet | Sin retroceso / disparo rápido / wallbang |
antiInfiniteAmmo / antiExplosiveAmmo | Munición infinita / explosiva |
antiDamageBoost / antiWeaponDamageBoost / antiDamageMod | Multiplicador de daño (límite weaponDamageMultMax 1.10) |
antiMeleeDamageBoost / antiMeleeDefenseBoost | Daño/defensa cuerpo a cuerpo (1.08/1.12) |
antiThermal / antiNightVision / antiRadar | Térmica/visión nocturna/radar (radar off por defecto) |
antiVDM / antiKill / antiTaze | VDM / kill no autorizado / taze grief |
Movimiento / Cuerpo
antiGodMode / antiPlayerInvincible | Invulnerabilidad |
antiNoClip / antiVehicleNoClip | No-clip (noclipHeightMin 3m, noclipFlatSpeedMin 3 m/s) |
antiTeleport / antiTeleportInVeh | Teleport (teleportDistance 0=auto, vehículo 90m) |
antiFastRun / antiOnFootSpeedHack / antiSprintHack | Velocidad (onFootSpeedMax 12 m/s, runSprintMultMax 1.15) |
antiSpeedHack | Velocidad + handling del vehículo |
antiSuperJump / antiInfiniteRoll | Súper salto / voltereta infinita |
antiInfiniteStamina / antiStaminaRecoveryHack / antiSwimMultHack | Multiplicadores de estamina/natación |
antiHealthRegenSpike / antiArmorRegenSpike | Pico HP/armadura (55 / 65 por seg) |
antiIllegalExtraHealth / antiIllegalExtraArmor | Exceso de límite (200 / 100) |
antiInvisible / antiSmallPed / antiPedSwap | Invisibilidad / ped pequeño / cambio de ped |
antiFreeCam / antiSpectate / antiBlips | Freecam/spectate/blip ESP (freecamMaxDistance 45m) |
Vehículo
antiVehicleGodmode / antiVehicleHealthHack | Invulnerabilidad/HP del vehículo (vehHealthCapMax 1100) |
antiVehicleTopSpeedMod / antiVehCheatPower | Vel. máx./potencia del motor (1.10 / 1.12) |
antiVehiclePlayerDmgBoost / antiVehicleDefenseBoost | Multiplicador daño/defensa del vehículo |
antiVehicleGravityAbuse | Abuso de gravedad (0.35–16.0) |
antiBlacklistedVehicles / ...Spawn | Vehículo en lista negra / spawn |
antiBlacklistPlate / antiPlateChange | Matrícula en lista negra / cambio de matrícula |
Spawn / Entidad / Visual
antiEntitySpawn / antiSpamPed / antiPeds / antiAIs | Spawn masivo de vehículo/objeto/ped |
antiBlacklistedWeapon / antiGiveWeapons / antiRemoveWeapons | Armas en lista negra/no autorizadas |
antiObjectAttach / antiAttachChainAbuse | Abuso de attach de objetos (profundidad 4) |
antiExplosionBlacklist / antiExplosiveAmmo | Lista negra de explosiones |
antiOverlay / antiMenus / antiNUIDevTools | Overlay / mod menu / NUI DevTools |
antiPickups / antiClipboardPaste | Desactivado por defecto (privacidad/FP) |
Sistema / Integridad
antiResourceInjection / antiResourceClone / antiCustomNative | Inyección runtime / clon de manifest / native hook |
antiFileTampering / antiCipherBypass / antiHWIDSpoof | Manipulación de archivos / cipher spoof / cambio de HWID |
antiResourceStop / antiResourceStart / antiModuleStop | Parada/inicio no autorizado de recursos/módulos |
antiStatebagCrash / antiServerEventSpam / antiCommandSpam | Crash de statebag / spam de eventos-comandos |
antiClearTasks / BlacklistedTasks / antiFold | Abuso de ClearTasks / task en lista negra |
fakeTriggers / messageBlacklist | Evento falso honeypot / chat prohibido+OCR |
antiLowFPSMacro | Macro de bajos FPS (lowFPSThreshold 6) |
C) Umbrales / tolerancias (ajuste de falsos positivos)
confirmHits (noclip 3, teleport 3, fastrun 2…) | Confirmar N veces antes de banear — reduce mucho los FP |
spawnGraceSecondsMs 35000 | Ventana sin detección tras spawn |
noclipStrikeMax 3 / fakeTriggerStrikeMax 2 | Tolerancia de impactos consecutivos |
instantAimDegPerFrame 75 / gimbalLookDegPerFrame 270 | Umbrales de ángulo de aim/giro (subir = menos FP) |
maximumModifier 2.0 | Límite global de multiplicador |
D) Bloques del sistema (action: log→kick→ban)
| Bloque | Qué hace / Recomendación |
|---|
shield | Native hooks + NUI oculto fingerprint/heartbeat + captura/vídeo WebGL como prueba al banear. nuiHeartbeatAction "log" primero |
nativeGuard | Escaneo de RAM/memoria con tosun-guard.exe externo. action "log"→"kick", requireGuard true si distribuyes guard |
shieldAi | Límite de tasa de spawn AI objeto/vehículo/ped (maxVehiclePerSec 4). action "cancel" |
shieldExplosion | Bloquear explosiones invisibles/inaudibles (action "ban") |
premiumGuard | Guard de particle/projectile/sound/ragdoll/requestControl + límite de tasa. Todos "log" primero |
guard (watchdog) | Vitalidad del recurso tosun-guard separado. action "log" (sin FP si falta el guard) |
v16 serverMovement | Teleport del lado servidor (teleportSpeedFlag 150 m/s, action "log") |
cloudBridge | Threat-score + consulta central de threat-intel (threatIntelMinScore 70, "log") |
launcherGate | Entrada solo con launcher — déjalo en false salvo que distribuyas un launcher |
licenseLock | Bloqueo de licencia del producto — "log" y luego "reject" en producción |
Framework.moneyCheck | Cheat de dinero (moneyCheckThreshold 5M duro, moneySoftThreshold 75k suave) |
PhoneNotify / connectingCard / AdminMenu | Alertas de teléfono / tarjeta de conexión / menú admin |
E) Paquetes preset
| Escenario | Recomendado |
|---|
| Servidor RP (equilibrado) | Todas las action = "log" (primera semana) → luego "kick"; confirmHits on; blockHosting=false; LiveWatch on; launcherGate=false |
| Hardcore / PvP | acciones "ban"; nativeGuard.action="kick"; shieldExplosion="ban"; endurecer umbrales; premiumGuard "kick" |
| Poca RAM / VPS | deepScan=false; LiveWatch.interval 3000; subir valores de ServerPerf; BackdoorGuard.scanIntervalMs 3600000; keepDetectionsDays 30 |
| Máxima seguridad | launcherGate=true (si distribuyes launcher); requireGuard=true; autoBlockInfected/autoQuarantine piloto; todas las acciones "ban"; licenseLock "reject" |
F) Reducir baneos falsos
- Primera semana
punishType="LOG" + cada bloque action="log" — observa a jugadores reales y ajusta.
- Usa
ts.confirmHits para confirmar una detección 2–3 veces antes de banear.
- Afloja umbrales: sube
instantAimDegPerFrame, maxVehicleTeleportDistance, onFootSpeedMax, etc.
- Exención permanente: panel → AC → Whitelist. Para exención temporal/por actividad usa exports:
exports['tosun-ac']:AddWhitelist("license:abc", 3600) -- exento 1 hora
exports['tosun-ac']:WhitelistArea(src, "parkour", 120) -- durante una actividad
exports['tosun-ac']:BypassDetection(src, {"antiTeleport","antiFastRun"}, 8000)
exports['tosun-ac']:SetPlayerExempt(src, true, 60000, "ropa")
G) Solución de problemas
| Síntoma | Solución |
|---|
| AC no conecta (heartbeat rojo) | ¿Coincide el ac_api_key del panel con el webPanelKey de FiveM? ¿Es fivem_url la dirección del servidor de juego (no el panel web)? ¿Está tosun-ac iniciado? |
| Los jugadores no pueden entrar | launcherGate.enabled=false (sin launcher); sube firstHeartbeatDeadline (servidores pesados); si es VPN blockHosting=false |
| Lag / hitch | Sube valores de ServerPerf; sube LiveWatch.interval; ResourceGuard.deepScan=false; sube BackdoorGuard.scanIntervalMs |
| Falso baneo VPN de staff/VPS | bypassStaffIpCheck=true; blockHosting=false; añade staff a AdminBypassIdentifiers |
| Jugador legítimo baneado (FP) | Pon esa action="log"; sube confirmHits; afloja el umbral; exime vía export |
| Error de reliable network overflow | No bajes los valores de NetworkJoin; mantén configSyncIntervalSec ≥ 60 |
Lista completa de todas las claves de detección y on/off del panel: panel → Ajustes de AC.