Lunamys Anti-Cheat : Vue d’ensemble

Lunamys Anti-Cheat est un système d’anti-cheat Lua + API Node.js conçu pour les serveurs Garry’s Mod. Il collecte des détections côté serveur/clients, les envoie à une API, puis les affiche dans un panel web moderne.

L’architecture repose sur :

• Une API Express sur https://anticheat.lunamys.fr.
• Des modules Lua bhop / anti-aim / cvar côté GMod.
• Un panel web pour visualiser les joueurs, détections et statistiques.

Installation côté serveur GMod

1. Fichiers à placer

Place les fichiers Lua Lunamys dans ton dossier lua/lunamys/ :

• sv_lunamysac_bhop.lua
• sv_lunamysac_antiaim.lua
• sv_lunamysac_cvar.lua
• sv_lunamysac_config.lua
• sh_lunamysac_common.lua
• cl_lunamysac_cvar.lua

2. Chargement automatique

Dans ton core serveur (par exemple lua/autorun/server/sv_core.lua), assure-toi d’inclure :

• include("lunamys/modules/sv_lunamysac_config.lua")
• include("lunamys/modules/sv_lunamysac_bhop.lua")
• include("lunamys/modules/sv_lunamysac_antiaim.lua")
• include("lunamys/modules/sv_lunamysac_cvar.lua")
• AddCSLuaFile("lunamys/modules/cl_lunamysac_cvar.lua")

Côté client, ajoute un include("lunamys/modules/cl_lunamysac_cvar.lua") dans un fichier autorun client.

Heartbeats & communication API

Lunamys utilise plusieurs appels réguliers entre GMod et l’API pour tenir le panel à jour :

• /api/status_heartbeat : indique que le serveur est en ligne.
• /api/update_players : envoie la liste des joueurs connectés.
• /api/actions/poll : récupère les kicks / bans en attente depuis le panel.

Les intervalles de ces heartbeats sont configurables dans Paramètres → Fréquences & Heartbeats dans le panel.

Module Bhop Serveur

Le module bhop détecte les bunnyhops automatisés en surveillant la cadence des sauts et la vitesse horizontale du joueur.

Paramètres principaux

• enabled : active/désactive le module.
• speedThreshold : vitesse minimale suspecte.
• jumpInterval : temps max entre deux sauts consécutifs.
• jumpCountMax : nombre de sauts rapides avant flag.
• cooldown : temps avant de pouvoir re-flag le même joueur.

Ces valeurs sont éditables dans le panel (onglet Paramètres), section Modules Lunamys.

Module Anti-Aim Serveur

Le module Anti-Aim surveille les EyeAngles pour détecter des angles impossibles (pitch extrême) ou des changements de yaw très brutaux typiques des anti-aim / spinbots.

Paramètres principaux

• enabled : active/désactive l’anti-aim.
• yawDelta : delta de yaw considéré comme suspect.
• pitchHigh : bornes hautes/basses du pitch autorisé.
• suspicionAdd : score ajouté par tick suspect.
• suspicionDecay : score retiré par tick normal.
• suspicionThreshold : score à partir duquel on déclenche une détection.
• cooldown : cooldown entre deux flags pour un même joueur.

Module Anti-CVar Client + Serveur

Le module Anti-CVar vérifie régulièrement les valeurs de cvars sensibles côté client (comme sv_allowcslua ou mat_wireframe) et signale toute différence avec la valeur attendue côté serveur.

Principe

• Le client lit les cvars via GetConVar.
• Il envoie un rapport périodique au serveur via un net message.
• Le serveur compare avec EXPECTED_CVARS et crée une détection cvar_tamper en cas de mismatch.

Paramètres principaux

• enabled : active le module côté client.
• reportInterval : secondes entre deux reports cvars.

Paramètres & Settings du panel Panel

L’onglet Paramètres centralise la configuration de l’anti-cheat :

• Activation des bans automatiques.
• Sensibilité globale des détections.
• Politique par défaut sur les flags critiques (log / kick / ban).
• Fréquences des heartbeats et des polls d’actions.
• Configuration des modules (bhop / anti-aim / cvar).

Toute modification est envoyée à l’API via POST /api/settings et récupérée côté GMod par /api/modules pour les modules Lua.

Détections & types d’événements

Les détections apparaissent dans l’onglet Détections du panel. Chaque entrée contient le serveur, le joueur, le type de détection et une description.

Tu peux ajouter de nouveaux types en envoyant d’autres valeurs dans payload.type depuis tes modules Lua, et les afficher de la même manière dans le panel.