How to Install BlackGuard on Your FiveM Server
BlackGuard is a server-side anti-cheat for FiveM. It installs as standard server-side resources, validates your license against our cloud, and starts detecting cheats in real time — no client mods, no kernel driver, and nothing for your players to install. Most servers are fully protected in under five minutes.
Before you start
You'll need
- ✓A FiveM server (FXServer) you control.
- ✓Your BlackGuard license key — format
BKGD-XXXXXXXX-2026, in your dashboard under Licenses.
You won't need
- ✕No MySQL or database.
- ✕No
oxmysql, noox_lib— zero hard dependencies. - ✕No client-side files, no kernel access, no false-kick tuning period.
blackguardac.com. (ox_lib/oxmysql appear only inside Config.AllowedResources — a known-safe allowlist, not a dependency.)Install in 4 steps
Download— from your dashboard
On the Download page, grab both files:
- ›blackguard — the core anti-cheat resource (required).
- ›blackguard_watchdog — anti-tamper companion (strongly recommended — an attacker would have to stop two resources to disable protection).
Place the resources
Unzip both folders into your server's resources/ directory (e.g. resources/[blackguard]/). That's the whole step — just drop them in.
resources/ — not inside another folder.Configure server.cfg
Open your server.cfg and add this block. The key line goes before the ensure lines:
set bg_license_key is the primary method — it survives update zips. (Fallback: set Config.LicenseKey in blackguard/shared/config.lua; the convar wins if both are present.)
Start
Restart your server — or run ensure blackguard from the live console. That's it. You're protected.
Confirm it's working
On a clean boot you'll see these lines in your console:
If validation fails you'll see [BlackGuard] VALIDATION FAILED: <reason> — detection disabled. instead — see Common setup issues below.
Optional: Vision add-on (aimbot / ESP detection)
Vision takes secure screenshots and analyzes the rendered game image for visual cheat indicators — aim overlays, ESP, and wallhack visuals. It's two resources: bg_vision_capture (needs screenshot-basic) + screenshot-basic.
# ── BlackGuard Vision (optional add-on) ── set bg_license_key "BKGD-XXXXXXXX-2026" # same key as core set bg_api_url "https://blackguardac.com" ensure screenshot-basic ensure bg_vision_capture
Clean-boot line: [bg_vision] Ready. Waiting for capture requests.
Scope (honest)
- •Vision targets visual cheat overlays. Cheats that don't render anything on-screen may not be caught by Vision alone.
Privacy
- •Capture & image use are disclosed in our Terms of Service; images are stored securely and auto-deleted after 14 days. Make sure your players know your server's ToS.
Framework compatibility
BlackGuard's core detection is framework-agnostic — it runs on ESX, QBCore, QBox, vRP, and standalone FiveM servers. Economy / money-exploit detection currently supports ESX and QBCore only (the two with money event hooks).
What BlackGuard detects
| Cheat type | How it's handled |
|---|---|
| Speed hacks | Auto-ban |
| Teleport | Auto-ban |
| Impossible weapon-damage | Auto-ban |
| Resource injection (unknown resources) | Flagged for review |
| Economy / money exploits | Flagged for review |
| Aimbot / ESP | Optional Vision add-on |
| No-clip · super-jump · god-mode | Roadmap — not yet detected |
Detection rules update automatically on our backend — you don't patch the resource when we improve a detection. Your installed resource is a sensor.
Common setup issues
License validated. Detection active, and make sure outbound HTTPS (port 443) to blackguardac.com isn't firewalled (only outbound access is needed).watchdog_present:false.blackguard without blackguard_watchdog — add ensure blackguard_watchdog and restart./tp can read as a teleport cheat. Clear it with one-click Revoke on the Bans page. (Staff-whitelist is on the roadmap.)Protected in under five minutes.
Start free — no charge today, cancel anytime.