Home/Docs/Install

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.

New to this? You don't need to be technical. This is a copy-paste install — download two folders, drop them in, paste four lines, restart. The pictures below show exactly where everything goes.

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, no ox_lib — zero hard dependencies.
  • No client-side files, no kernel access, no false-kick tuning period.
BlackGuard Dashboard — Licenses OverviewServers Licenses DownloadBillingSessionsBans LICENSE KEY BKGD-A7K3-9F21-2026 Copy Active Server binding:not bound yet 1 Copy your key
Dashboard → Licenses. Your key lives here. Keep this tab open.
The resource only needs outbound HTTPS to blackguardac.com. (ox_lib/oxmysql appear only inside Config.AllowedResources — a known-safe allowlist, not a dependency.)

Install in 4 steps

1

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).
BlackGuard Dashboard — Download blackguard Core anti-cheat · Required ⤓ Download blackguard blackguard_watchdog Anti-tamper · Recommended ⤓ Download watchdog 1 Download both files
2

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.

myserver › server-data › resources NAME TYPE 📁 [gamemodes]File folder 📁 [maps]File folder 📁 [system]File folder 📁 blackguard 📁 blackguard_watchdog File folderFile folder ⠿ 2 folders 2 Drop both folders into resources/
Drop both folders straight into resources/ — not inside another folder.
Installing on a remote host? Upload the zip and extract it on the server (use binary mode over FTP) — don't extract locally and upload loose files.
3

Configure server.cfg

Open your server.cfg and add this block. The key line goes before the ensure lines:

server.cfg 212223242526 # your other resources… # ── BlackGuard Anti-Cheat ── set bg_license_key "BKGD-A7K3-9F21-2026" ensure blackguard ensure blackguard_watchdog 3 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.)

4

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:

Server Console [BlackGuard] Validating license BKGD-A7K*** on 51.x.x.x:30120 [BlackGuard] License validated. Detection active. [BlackGuard Watchdog] Active. Monitoring blackguard on 51.x.x.x:30120 Server: Online See this line? You're protected.
Your server also shows Online in the dashboard within a minute or two (heartbeat).

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.

server.cfg — Vision add-onCopy
# ── 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 typeHow it's handled
Speed hacksAuto-ban
TeleportAuto-ban
Impossible weapon-damageAuto-ban
Resource injection (unknown resources)Flagged for review
Economy / money exploitsFlagged for review
Aimbot / ESPOptional Vision add-on
No-clip · super-jump · god-modeRoadmap — 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

?"Validation failed: bound to a different server."
Your key binds to the first server that validates it (by IP:port). Move it in Licenses → Reset Server Binding (up to 3 resets per 24h), then restart.
?Server never shows Online.
Confirm the console shows License validated. Detection active, and make sure outbound HTTPS (port 443) to blackguardac.com isn't firewalled (only outbound access is needed).
?Logs say watchdog_present:false.
You started blackguard without blackguard_watchdog — add ensure blackguard_watchdog and restart.
?A trusted admin got banned for teleporting.
There's no staff-whitelist yet, so a large instant /tp can read as a teleport cheat. Clear it with one-click Revoke on the Bans page. (Staff-whitelist is on the roadmap.)
?Resource is corrupt after upload.
Files were transferred in text mode over FTP — re-upload in binary mode, or upload the zip and extract on the server.

Protected in under five minutes.

Start free — no charge today, cancel anytime.

$0 today · then $20/mo · cancel anytime

Next steps

We Value Your Privacy 🍪

We use cookies to improve your experience on our website.