DrgxByteZone/drgxel-ac

DRGXEL-AC

DRGXEL-AC is an ultra-optimized, server-authoritative anti-cheat system built for SA-MP (San Andreas Multiplayer) and open.mp. Designed from the ground up to solve the infamous CPU overhead problem of legacy anti-cheats (reducing CPU load from 40%+ down to < 3-5%), DRGXEL-AC combines high-efficiency detection algorithms with zero-overhead scheduling.

---

⚡ Performance Architecture

---

🛡️ Protection Matrix (20 Core Detections)

🏃 Movement & Position

⚔️ Combat & Health

🚗 Vehicles & Modifications

🔒 Network & Server Security

---

🚀 Installation

1. Manual Installation

1. Download the repository.
2. Copy src/drgxel-ac.inc, src/drgxel-ac_opt.inc, and language files to your server's pawno/include/ directory.
3. Include it in your gamemode or filterscripts:

   #include <drgxel-ac>
   

4. Recompile your gamemode.

2. sampctl Installation

Add to your pawn.json:

{
    "dependencies": [
        "DrgxByteZone/drgxel-ac"
    ]
}

---

⚙️ Configuration

Pre-compiler Definitions

You can override performance settings before including the library:

#define DRGXEL_AC_TICK_THROTTLE_MS   40   // Dynamic micro-throttle interval (ms)
#define DRGXEL_AC_USE_FAST_MATH      1    // 1 = Enable fast squared distance math
#define DRGXEL_AC_USE_CENTRAL_TIMER  1    // 1 = Central master timer, 0 = Per-player timers
#define DRGXEL_AC_MAX_PING          500  // Maximum ping threshold
#define DRGXEL_AC_MAX_CONNECTS_FROM_IP 3 // Maximum connections per IP
#include <drgxel-ac>

Configuration File (drgxel-ac_settings.cfg)

Place drgxel-ac_settings.cfg in your server's root or scriptfiles/ directory to manage toggles at runtime.

---

📖 Developer API & Callbacks

Callbacks

// Called when a cheat violation is confirmed
public OnCheatDetected(playerid, const ip_address[], type, code)
{
    printf("[DRGXEL-AC] Player %d (%s) triggered anti-cheat code #%03d", playerid, ip_address, code);
    return 1;
}

// Called on warning thresholds before kick
public OnCheatWarning(playerid, const ip_address[], type, code, code2, count)
{
    // Custom warning/logging logic
    return 1;
}

// Called on NOP detection
public OnNOPWarning(playerid, nopid, count)
{
    return 1;
}

Functions

EnableAntiCheat(code, bool:enable);                     // Toggle specific detection globally
EnableAntiCheatForPlayer(playerid, code, bool:enable);  // Toggle detection for specific player
IsAntiCheatEnabled(code);                               // Check global detection state
IsAntiCheatEnabledForPlayer(playerid, code);            // Check player detection state

AntiCheatGetHealth(playerid, &Float:health);            // Get authoritative health
AntiCheatGetArmour(playerid, &Float:armour);            // Get authoritative armour
AntiCheatGetPos(playerid, &Float:x, &Float:y, &Float:z);// Get authoritative position
AntiCheatGetSpeed(playerid);                            // Get authoritative speed
AntiCheatGetWeapon(playerid);                           // Get active held weapon ID
AntiCheatIsConnected(playerid);                         // Check connection state

// Performance Monitoring APIs
new total = drgxel_ac_GetTotalChecks();
new throttled = drgxel_ac_GetThrottledFrames();
new lastDuration = drgxel_ac_GetLastTickDuration();

---

📄 License

This project is licensed under the MIT License.