Inicio rápido
Tosun AntiCheat — Documentación
Todo lo que necesitas para proteger tu servidor FiveM de trampas. La hoja de ruta indica por dónde empezar según tu situación.
Inicio rápido — funcionando en 15 minutos
Si empiezas desde cero, sigue este orden:
| # | Paso | Tiempo | Guía |
|---|---|---|---|
| 1 | Prepara una base de datos ¿Ya usas QBCore/ESX? Tu base actual basta | ~5 min | Base de datos (MySQL) → |
| 2 | Abre tu cuenta del panel Aquí se genera tu clave de licencia | ~2 min | Panel y sitio → |
| 3 | Instala el anti-cheat Descarga, extrae, añade 3 líneas a server.cfg | ~5 min | Instalación → |
| 4 | Aplica el endurecimiento de plataforma El paso de mayor valor — bloquea la mayoría de trampas de una vez | ~3 min | Instalación § 7 → |
¿Qué necesitas?
| Tu situación | Ir a |
|---|---|
| Instalación nueva desde cero | Guía de instalación — paso a paso, con el motivo de cada paso |
| Sin base de datos / no conecta | Guía de base de datos — opciones, cadenas, solución de problemas |
| Quieres autoalojar el panel | Configuración del panel — Nginx, SSL, cron, seguridad |
| Compatibilidad QBCore / ESX | Framework — se detecta automáticamente |
| Baneos falsos | Ajustes y rendimiento — ventanas de confirmación, excepciones |
| Integrar con tus scripts | Exports — API de exención, ban y whitelist |
| ¿Dónde está mi clave? | Clave de licencia |
| Algo va mal | FAQ · Panel → Soporte |
Cómo funciona el sistema
Tres componentes trabajan juntos:
| Componente | Se ejecuta en | Función |
|---|---|---|
tosun-ac | Tu servidor FiveM | Detección, sanción, protección. El anti-cheat en sí. |
tosun-ac-guardian | Tu servidor FiveM | Restaura el anti-cheat en un segundo si se detiene. |
| Panel | Web | Bans, detecciones, monitoreo en vivo, ajustes. |
El panel y el servidor hablan en ambas direcciones automáticamente: las detecciones llegan al instante y los cambios de ajustes alcanzan el servidor en ~30 segundos. No necesitas reiniciar el servidor para cambiar ajustes.
Nuestro enfoque de protección
1. Capa de plataforma (no se puede evadir). Convars de enrutado de FiveM —
sv_entityLockdown, sv_stateBagStrictMode, sv_filterRequestControl. Con ellos, el servidor nunca retransmite el paquete malicioso.
2. Capa autoritativa del servidor. Armas, explosiones y daño pasan por eventos de red del servidor y se contrastan con la realidad del servidor.
3. Capa de cliente. Integridad de nativos, OCR, firmas de menú — un filtro rápido y barato.
Nota honesta: ningún anti-cheat puede prometer que «los cheats no pueden entrar». Por eso priorizamos las capas de servidor y plataforma. El endurecimiento de plataforma es lo más efectivo que puedes hacer.
Política de bans falsos
Evitamos ambos errores:
- Banear a un inocente. Las detecciones físicas requieren varias lecturas consecutivas y una duración mínima, y se omiten con lag/desync.
- Dejar pasar a un tramposo. Un cheater no puede inducir lag a propósito para resetear siempre la ventana de confirmación — si se supera el umbral total, la sanción se aplica.
Las detecciones con más riesgo de falso positivo usan bans temporales (p. ej. noclip 7 días); las definitivas siguen siendo permanentes. Configurable en Ajustes y rendimiento.