MXI Sentinel Documentation

Complete setup instructions and technical reference for deploying MXI Sentinel anti-cheat engine on FiveM and connecting to MXI Nexus Cloud.

1. Installation Guide

MXI Sentinel is a hybrid C# (.NET Assembly) and Lua resource. Follow these steps to install it on your FiveM dedicated server or RDP.

Extract the resource folder to your FiveM server resources directory:

resources/[vip]/[mxi]/mxi_sentinental/

Structure check:

  • fxmanifest.lua — Resource manifest
  • client_cs/bin/Debug/MXISentinentalClient.net.dll — Compiled C# assembly module
  • gatekeeper.key — Encryption secret file
  • install.sql — oxmysql database schema

2. Database Setup

Import the install.sql file into your MySQL / MariaDB database using HeidiSQL, phpMyAdmin, or Navicat.

The database script creates 8 essential tables for trust scores, bans, and audit logs:

mxi_whitelist — Dynamic event whitelist rules
mxi_trust — Multi-category trust scores (combat/movement)
sentinental_bans — Permanent HWID token & IP ban records
sentinental_detections — Detailed cheat incident log

3. server.cfg Configuration

Add your MXI Nexus License Key and environment convars to your FiveM server.cfg file:

server.cfgRequired
# === MXI SENTINEL CONFIGURATION ===
set mxi_sentinental_license "MXI-YOUR-GENERATED-LICENSE-KEY"
set mxi_nexus_api "https://mxi-nexus.vercel.app/api/log"
set mxi_server_id "mxi-rp-1"

# Webhooks (Discord Alerts)
set mxi_webhook_bans "https://discord.com/api/webhooks/YOUR_BAN_WEBHOOK"
set mxi_webhook_admin "https://discord.com/api/webhooks/YOUR_ADMIN_WEBHOOK"

# Integrity & DRM Secrets
set mxi_gatekeeper_key "MXI_GK_7f3a9c2e4b1d8f5a6e0c3b9d"
set mxi_allowed_hostname "Your FiveM Server Name"

# Ensure Load Order
ensure oxmysql
ensure mxi_sentinental

4. C# Assembly Scanner & Modules

MXI Sentinel uses a low-level C# module (MXISentinentalClient.net.dll) executing native tick routines:

⚡ Low-Level Native Hook Detection

Detects native execution delays >50ms caused by active external menu hooks or memory patches.

🔍 AppDomain Assembly Reflection

Scans active .NET AppDomain assemblies for blacklisted injectors (Eulen, RedEngine, Menyoo, Kiddion).

5. Routing Bucket 99 ("The Backrooms")

When a player triggers a medium/high severity detection (e.g. speedhack, freecam), Sentinel automatically isolates the player into SetPlayerRoutingBucket(src, 99). The player becomes invisible to others without crashing your main server tick!

6. Troubleshooting & FAQ

Q: License Validation Failed on Server Startup?

Ensure you added set mxi_sentinental_license in server.cfg before ensure mxi_sentinental, and verify that the license is marked Active in MXI Nexus.

Q: How to fix False Positive Event Blocks?

Enable Learning Mode (Config.LearningEnabled = true) in config.lua for 1 hour to auto-whitelist valid framework events, or add events manually in MXI Nexus Whitelist.

Q: Does C# Client Module impact FPS?

No. The C# client assembly uses async tick intervals (1000ms / 3000ms) with zero impact on client FPS.