Skip to content

hazteunsitio/Hz-Anticheat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

🛡️ Hz-Anticheat - Sistema de Protección Avanzado para FiveM

Version FiveM License Status

Desarrollado por HZ - FivemSoluciones - Codigosparajuegos

Sistema de anticheat profesional y completo para servidores FiveM


📋 Tabla de Contenidos


🔍 Descripción

Hz-Anticheat es un sistema de protección avanzado diseñado específicamente para servidores FiveM. Ofrece una protección integral contra múltiples tipos de cheats, hacks y exploits, manteniendo la integridad y seguridad de tu servidor.

Este anticheat incluye un Panel de Administración In-Game moderno y completo que permite gestionar todas las funcionalidades desde dentro del juego, proporcionando una experiencia de administración fluida y profesional.


✨ Características Principales

🚀 Protección Avanzada

  • 35+ Protecciones Activas contra diferentes tipos de cheats
  • Detección en Tiempo Real de actividades sospechosas
  • Sistema de Baneos Inteligente con múltiples niveles de acción
  • Protección OCR contra menús de mod detectados en pantalla
  • Seguridad de Entidades con control de spawning

🎛️ Panel de Administración Integrado

  • Interfaz Web Moderna con diseño responsivo
  • Dashboard en Tiempo Real con estadísticas del servidor
  • Gestión Completa de Jugadores y sistema de baneos
  • Sistema de Logs Avanzado con filtros y búsqueda
  • Configuración en Vivo sin necesidad de reiniciar

🔧 Configuración Flexible

  • Auto-Configuración Inteligente para eventos seguros
  • Whitelist Personalizable para recursos y eventos
  • Múltiples Niveles de Seguridad ajustables
  • Integración con FiveM Security nativa

📊 Monitoreo y Logs

  • Sistema de Webhooks Discord para notificaciones
  • Logs Detallados de todas las actividades
  • Estadísticas en Tiempo Real del servidor
  • Historial Completo de baneos y acciones

🛡️ Protecciones Incluidas

Protecciones de Jugador

  • Anti God Mode - Detecta y previene modo dios
  • Anti Invisible - Detecta jugadores invisibles
  • Anti Teleport - Controla teletransportación no autorizada
  • Anti Noclip - Detecta atravesar objetos sólidos
  • Anti Speed Hack - Controla velocidad anormal de jugadores
  • Anti Super Jump - Detecta saltos sobrehumanos
  • Anti Infinite Stamina - Controla resistencia infinita
  • Anti No Ragdoll - Detecta desactivación de ragdoll
  • Anti Spectate - Detecta modo espectador no autorizado
  • Anti Freecam - Detecta cámara libre

Protecciones de Armas

  • Anti Give Weapon - Previene spawning de armas
  • Anti Damage Modifier - Detecta modificación de daño
  • Anti Explosion Bullet - Detecta balas explosivas
  • Anti Magic Bullet - Detecta disparos imposibles
  • Anti No Reload - Detecta recarga infinita
  • Anti No Recoil - Detecta ausencia de retroceso
  • Anti Rapid Fire - Detecta disparo rápido modificado
  • Anti Aim Assist - Desactiva asistencia de puntería
  • Anti Infinite Ammo - Controla munición infinita
  • Anti Bigger Hitbox - Detecta hitboxes modificados

Protecciones de Vehículos

  • Anti Car Fly - Detecta vehículos voladores
  • Anti Vehicle God Mode - Detecta vehículos indestructibles
  • Anti Vehicle Power Increase - Detecta modificación de potencia
  • Anti Plate Changer - Detecta cambio de matrícula
  • Anti Car Ram - Detecta embestidas con mod menu

Protecciones del Sistema

  • Anti Resource Stopper/Starter - Protege recursos del servidor
  • Anti Execution - Previene ejecución de código malicioso
  • Anti Entity Spam - Controla spam de entidades
  • Anti Particle Effects - Controla efectos de partículas
  • Anti State Bag Overflow - Protege contra overflow
  • Anti AFK Injection - Detecta inyección durante AFK
  • Anti Extended NUI Devtools - Detecta herramientas de desarrollo

Protecciones Visuales

  • Anti Night Vision - Detecta visión nocturna
  • Anti Thermal Vision - Detecta visión térmica
  • Anti Player Blips - Detecta blips de jugadores
  • Anti OCR - Detecta menús de mod en pantalla

🎛️ Panel de Administración

Dashboard Principal

  • 📊 Estadísticas en Tiempo Real
    • Jugadores en línea
    • Total de baneos
    • Errores del sistema
    • Estado de protecciones

Gestión de Jugadores

  • 👥 Lista de Jugadores Online
    • Información detallada de cada jugador
    • Acciones rápidas (ban, kick, etc.)
  • 🚫 Sistema de Baneos
    • Baneos temporales y permanentes
    • Razones predefinidas y personalizadas
    • Historial completo con timestamps
  • 🔓 Gestión de Desbaneos
    • Desbanear por identificador
    • Historial de desbaneos

Lista Blanca (Whitelist)

  • 📋 Gestión de Eventos permitidos
  • 🔧 Gestión de Recursos en whitelist
  • Añadir/Eliminar elementos fácilmente

Configuración del Sistema

  • 🐛 Toggle Debug Mode - Activar/desactivar modo debug
  • 👨‍💻 Toggle Dev Mode - Activar/desactivar modo desarrollador
  • 🔄 Recargar Configuración sin reiniciar

Sistema de Logs

  • 📝 Logs de Administración - Acciones de admins
  • 🚫 Logs de Baneos - Historial de sanciones
  • Logs de Errores - Errores del sistema
  • 🔍 Filtros Avanzados por tipo, fecha y administrador
  • 📤 Exportación de Logs

⚙️ Instalación

Requisitos Previos

  • FiveM Server versión 5181 o superior
  • Recurso screenshot-basic
  • Recurso HzKeepAlive (incluido)
  • txAdmin (opcional, para integración completa)

Pasos de Instalación

  1. Descarga y Extracción

    # Extrae el archivo en tu carpeta de recursos
    resources/Hz-Anticheat/
  2. Configuración del server.cfg

    # Añade al server.cfg
    ensure screenshot-basic
    ensure HzKeepAlive
    ensure HzAnticheat
  3. Configuración de Permisos ACE

    # Añade permisos de administrador
    add_ace group.admin hzanticheat.admin allow
    add_ace group.moderator hzanticheat.moderator allow
  4. Instalación Automática

    # En la consola del servidor
    /hzinstall
    /hzverify
    

Verificación de Instalación

# Comandos de verificación
/hzstatus    # Estado del sistema
/hztest      # Probar funcionalidad
/hzhelp      # Ayuda y comandos

🔧 Configuración

Archivo Principal: config.lua

-- Configuración General
HzAnticheat.ServerName = "Tu Servidor"        -- Nombre del servidor
HzAnticheat.DiscordLink = "#"                 -- Link de Discord
HzAnticheat.RequireSteam = false              -- Requerir Steam
HzAnticheat.IdentifierCheck = true            -- Verificar identificadores
HzAnticheat.Debug = false                     -- Modo debug

Configuración de Seguridad del Servidor

HzAnticheat.ServerSecurity = {
    Enabled = true,
    Connection = {
        KickTimeout = 600,              -- Timeout de conexión
        UpdateRate = 60,                -- Frecuencia de verificación
        ConsecutiveFailures = 2,        -- Fallos consecutivos
    },
    NetworkEvents = {
        FilterRequestControl = 2,       -- Filtrar eventos de control
        DisableNetworkedSounds = true,  -- Desactivar sonidos de red
    },
    ClientProtection = {
        PureLevel = 0,                  -- Nivel de pureza del cliente
        DisableClientReplays = true,    -- Desactivar replays
    }
}

Configuración de Protecciones

HzAnticheat.Protection.Simple = {
    { protection = "Anti God Mode",     time = "Ban", enabled = true },
    { protection = "Anti Teleport",     time = "Ban", enabled = true },
    { protection = "Anti Speed Hack",   time = "Ban", enabled = true },
    -- ... más protecciones
}

Configuración del Panel: admin_panel_config.lua

-- Configuración del Panel de Administración
AdminPanelConfig = {
    Theme = "dark",                    -- Tema: "dark" o "light"
    Language = "es",                   -- Idioma: "es" o "en"
    OpenKey = "F6",                    -- Tecla para abrir panel
    Commands = {
        main = "hzadmin",               -- Comando principal
        alternative = "adminpanel"       -- Comando alternativo
    }
}

📊 Sistema de Logs

Tipos de Logs Disponibles

  • 🔧 System Logs - Eventos del sistema
  • 🚨 Detection Logs - Detecciones de cheats
  • 🚫 Ban Logs - Baneos realizados
  • 👢 Kick Logs - Kicks realizados
  • 📸 Screenshot Logs - Capturas de pantalla
  • 👨‍💼 Admin Logs - Acciones administrativas
  • 🐛 Debug Logs - Información de depuración
  • 🚪 Join/Leave Logs - Conexiones y desconexiones

Configuración de Webhooks Discord

HzAnticheat.Logs = {
    Enabled = true,
    system = "https://discord.com/api/webhooks/...",
    detection = "https://discord.com/api/webhooks/...",
    ban = "https://discord.com/api/webhooks/...",
    -- ... más webhooks
}

🔐 Sistema de Permisos

Métodos de Autenticación

  1. ACE Permissions (Recomendado)

    add_ace group.admin hzanticheat.admin allow
  2. txAdmin Integration

    • Automático para usuarios con permisos de txAdmin
  3. Lista Manual

    AdminPanelConfig.ManualAdmins = {
        "steam:110000100000000",
        "license:1234567890abcdef"
    }

Niveles de Permisos

  • 👑 Admin - Acceso completo
  • 🛡️ Moderator - Acceso limitado
  • 👮 Staff - Acceso básico

Permisos de Bypass

-- Permisos para saltarse protecciones específicas
secure.bypass.teleport      -- Bypass detección de teleport
secure.bypass.godmode       -- Bypass detección de god mode
secure.bypass.all           -- Bypass todas las protecciones

📱 Comandos

Comandos del Panel de Administración

/hzadmin          # Abrir panel de administración
/adminpanel       # Comando alternativo

Comandos de Instalación y Verificación

/hzinstall        # Información de instalación
/hzverify         # Verificar instalación
/hztest           # Probar funcionalidad
/hzstatus         # Estado del sistema
/hzhelp           # Ayuda y comandos

Comandos de Configuración

/securenewkey     # Generar nueva clave de seguridad
/hzreload         # Recargar configuración
/hzdebug          # Toggle modo debug

Teclas por Defecto

  • F6 - Abrir/Cerrar Panel de Administración
  • ESC - Cerrar Panel

🔄 Compatibilidad

Requisitos del Sistema

  • FiveM Server: Versión 5181 o superior
  • Lua Version: Lua 5.4
  • Dependencies: screenshot-basic, HzKeepAlive

Frameworks Compatibles

  • ESX Legacy
  • QBCore
  • Standalone
  • Custom Frameworks

Recursos Compatibles

  • txAdmin - Integración completa
  • vMenu - Sin conflictos
  • EUP - Totalmente compatible
  • Custom Resources - Whitelist configurable

Navegadores Soportados

  • CEF (Chromium Embedded Framework)
  • Todas las resoluciones (Responsive Design)

🆘 Soporte

Documentación Adicional

  • 📖 ADMIN_PANEL_README.md - Documentación completa del panel
  • 📋 CHANGELOG.md - Registro de cambios y versiones

Comandos de Diagnóstico

/hzverify         # Verificar instalación
/hzstatus         # Estado del sistema
/hzdebug          # Información de depuración

Resolución de Problemas Comunes

Panel no abre:

  1. Verificar permisos ACE
  2. Comprobar que el recurso esté iniciado
  3. Revisar logs del servidor

Falsos positivos:

  1. Añadir eventos a la whitelist
  2. Ajustar configuración de protecciones
  3. Usar modo AutoConfig temporalmente

Problemas de rendimiento:

  1. Ajustar frecuencia de verificaciones
  2. Desactivar protecciones innecesarias
  3. Optimizar configuración de servidor

Contacto y Soporte

  • 🌐 Desarrollador: HZ - FivemSoluciones - Codigosparajuegos
  • 📧 Soporte: Contacta al equipo de desarrollo
  • 🐛 Reportar Bugs: Incluye logs y configuración

📄 Licencia

© 2025 HZ - FivemSoluciones - Codigosparajuegos

Este software es propiedad de HZ - FivemSoluciones - Codigosparajuegos. Todos los derechos reservados.

Términos de Uso

  • ✅ Uso permitido en servidores FiveM
  • ❌ Redistribución no autorizada
  • ❌ Modificación del código sin permiso
  • ❌ Uso comercial sin licencia

Créditos

  • Desarrollo Principal: HZ Team
  • Framework Base: SecureServe (Inspiración)
  • UI/UX Design: Paneles administrativos modernos
  • Testing: Comunidad FiveM

🚀 Hz-Anticheat v1.2.1

La protección más avanzada para tu servidor FiveM

Desarrollado con ❤️ por HZ - FivemSoluciones - Codigosparajuegos


Footer FiveM Security

About

es un sistema de protección avanzado diseñado específicamente para servidores FiveM. Ofrece una protección integral contra múltiples tipos de cheats, hacks y exploits, manteniendo la integridad y seguridad de tu servidor

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors