XenoX352/anticheat-hytam-legam

Hytam Legam Anti-Cheat

A comprehensive, open-source anti-cheat system designed for SA-MP and open.mp servers. Built with performance and precision in mind using modern libraries and packet analysis.

---

Features

• Player Integrity
  Speed hack, teleport, CJ run, airbreak (onfoot & vehicle), godmode, health/armour/ammo manipulation, invisibility, fake spawn, fake kill, animation sync data abuse.

• Weapon & Combat
  Invalid weapons, rapid fire, aimlock detection (angle snap + distance snap).

• Server & Network
  NoPS (packet flood), crash attempt (invalid RPC), chat spam.

• Vehicle Exploits
  Vehicle health hack, instant repair, airbreak while driving, /mcar (vehicle damage without collision).

• Stealer/Mod Loader Detection
  Moonloader and Monetloader blocking on connect.

• Mapping & TextDraw Stealer
  Object spam detection to prevent mass mapping rip.

• Webhook Integration
  Sends cheat detection alerts directly to a Discord channel via webhook.

• Admin Control Panel
  /acsettingslegam dialog to toggle each detection module on or off in real-time.

• Extensible
  Easily add new cheat checks by hooking into the existing framework.

---

Dependencies

All dependencies are free and widely used in the SA-MP/open.mp community.

---

Installation

1. Download or clone this repository into your pawno/include folder.

2. Ensure all required plugins and includes are loaded in your server.cfg:

   1. Add #include <anticheat_hytam_legam> to your gamemode or filterscript.

3. Set your Discord webhook URL in the script (define AC_WEBHOOK_URL).

4. Compile and run.

No additional database configuration is required; all detection data is stored per-player in memory.

---

Configuration

Edit the following defines at the top of the include to match your server’s needs:

You can toggle any check at runtime via the admin dialog, and changes are applied instantly without a server restart.

---

Usage

Admin Command

• /acsettingslegam - Opens a list dialog to enable/disable each cheat module.
  Only available to RCON admins.

Automatic Detection

All checks run automatically each OnPlayerUpdate, OnPlayerWeaponShot, OnPlayerDeath, and relevant packet hooks. When a cheat is detected:

1. The player receives a warning.
2. After AC_MAX_WARNINGS (default 5) warnings, the player is kicked.
3. Severe cheats (teleport, airbreak, etc.) result in an immediate ban.

A detailed log is written to anticheat.log and sent to Discord.

---

Detection Modules

---

Customization

To add a new cheat check:

1. Add a new constant in the enum list (e.g., AC_CHECK_CUSTOM).
2. Add its name to g_acCheckNames.
3. Place the detection logic inside the appropriate hook (e.g., hook OnPlayerUpdate).
4. Call AC_OnCheatDetected(playerid, AC_CHECK_CUSTOM, "details") when triggered.
5. The admin dialog and toggle system will automatically include your new module.

---

Logging & Discord Alerts

The system writes every detection to anticheat.log with timestamps. Additionally, a JSON payload is sent to the configured Discord webhook, allowing real-time monitoring by admins.

Example Discord message:

---

License

This anti-cheat is open source and available under the MIT License. You are free to use, modify, and distribute it in your own projects, commercial or otherwise. See the LICENSE file for more details.

---

Credits

• Developed by the Hytam Legam team.
• Uses: open.mp, PawnPlus, YSI, Pawn.RakNet, pawn-requests, vehicle-streamer.

Contributions, issues, and pull requests are welcome!