Documentation

Getting Started

Veil Management is a server management platform built specifically for FiveM. It gives server owners real-time visibility into everything happening on their server β€” from CPU usage and player activity to resource performance and cheat detections β€” all from a single web dashboard.

How it works

1

Veil Agent (Rust binary)

Runs on your game server host. Handles process monitoring, WebSocket connections, console streaming, and performance profiling. Auto-updates itself.

2

veil-monitor (Lua resource)

Runs inside FiveM. Handles in-game data: anti-cheat, player sessions, economy events, and live spectate. Distributed via Tebex with FiveM escrow encryption.

3

Dashboard (veilmgmt.com)

The web interface you're using now. All data flows securely from your server to here. Nothing is stored beyond what you configure.

βœ… Works out of the box

  • β€’ CPU, RAM, uptime monitoring
  • β€’ Live console + server controls
  • β€’ Performance profiling
  • β€’ Ban management
  • β€’ Database backups

⚑ Requires veil-monitor

  • β€’ Anti-cheat detection
  • β€’ Player sessions & profiles
  • β€’ Economy monitoring
  • β€’ Live spectate
  • β€’ In-game admin menu

System requirements

  • β€’ FiveM server (latest recommended artifact)
  • β€’ Windows Server or Linux (Ubuntu 20.04+) on the game server host
  • β€’ Active Veil account with a subscription plan
  • β€’ Outbound internet access from the game server host (port 443)

Installation

Step 1 β€” Create a Server Key

Go to the Server Keys tab in your dashboard (or click Add Server from the Servers tab). Generate a new key β€” this opens the setup guide which contains your download links and the exact server.cfg snippet to copy.

πŸ’‘ The guide has everything

The setup guide in the dashboard shows your pre-filled server.cfg configuration. Copy and paste it directly β€” no manual editing needed.

Step 2 β€” Download & run the Veil Agent

The agent is a single binary that runs on your game server host (not inside FiveM). The download link for your OS is in the setup guide. Place it anywhere on your host and run it.

Windows

.\veil-agent.exe

Linux

chmod +x veil-agent && ./veil-agent

The agent reads its configuration from the set vm_* values in your server.cfg β€” no separate config file to fill in. It auto-updates itself on startup so you never need to re-download it.

Step 3 β€” Install veil-monitor (Lua resource)

This is the in-game FiveM resource that enables anti-cheat, player sessions, economy monitoring, and live spectate. Download it free from our Tebex store. It comes pre-encrypted via FiveM escrow.

  1. 1

    Extract to your resources folder

    resources/[veil]/veil-monitor
  2. 2

    Add to server.cfg β€” copy from the setup guide

    ensure veil-monitor

The setup guide provides the full server.cfg block

It includes set vm_server_key, set rcon_password, set vm_agent_socket_port, and the ensure line β€” all pre-filled with your server key. Just copy the whole block.

Step 4 β€” Restart & verify

Restart your FiveM server. Watch the console for these lines:

[veil-monitor] Server linked successfully.
[veil-monitor] Heartbeat sent successfully.
[veil-monitor] Anti-cheat initialized.

If you don't see these, check the Troubleshooting section.

Dashboard

Adding your first server

  1. 1 Go to the Servers tab and click Add Server, or go directly to Server Keys.
  2. 2 Give the server a name and generate a Server Key. This opens the setup guide.
  3. 3 Follow the setup guide β€” it gives you the download link for the agent and the exact server.cfg block to copy.
  4. 4 Add the cfg block to your server.cfg, place the agent binary on your host, and start both.
  5. 5 Once veil-monitor sends its first heartbeat, your server's IP and port are registered automatically. No manual entry needed.

Server settings

Alert thresholds

Set CPU/RAM/response time thresholds. When exceeded, alerts appear in the dashboard and optionally fire a Discord webhook.

Framework

Set ESX, QBCore, QBox, or Custom so economy monitoring uses the right data structures. Custom provides boilerplate files you can fill in for any other framework.

Analytics

Control how often metrics are collected (default every 5 minutes).

Discord webhook

Add a webhook URL to receive alert notifications directly in your Discord server.

Team members

You can invite staff to your server under Settings β†’ Team. Each member can be assigned a role:

Server Owner

Full access to all settings and billing.

Server Admin

Can manage players, bans, and view all data.

Server Developer

Can view performance and resource data.

Live Console

The live console streams your FiveM server's output directly to your browser in real time via a secure WebSocket connection through the Veil relay. No port forwarding required on your end.

Sending commands

Type any command in the input bar at the bottom and press Enter or click Send. Commands are sent via RCON to your server. Examples:

❯restart veil-monitor
❯kick 1 "You have been kicked"
❯resmon 1

Server controls

Start

Starts the FXServer process via the agent.

Restart

Gracefully restarts FXServer.

Stop

Stops the FXServer process.

⚠️ These controls work only if the Veil Agent is managing your FXServer process. If you start FXServer yourself independently, Start/Stop/Restart will not work.

Filtering & search

  • β€’ Use the filter bar to filter by severity: Info, Warning, Error, Success.
  • β€’ Use the component dropdown to filter by resource name (e.g. only show script:veil-monitor).
  • β€’ Use the search box to full-text search across all visible lines.
  • β€’ Ctrl+K clears the console. ↑↓ arrows cycle command history.

Performance Monitoring

System metrics

Collected every 5 minutes (configurable) and displayed as real-time charts on the server dashboard. Includes CPU usage, RAM usage/total, player count, and uptime.

Per-resource performance breakdown

Found under the Performance tab. The agent profiles FXServer every few minutes and breaks down exactly how long each Lua resource is taking per tick.

Avg duration

Average tick execution time for each resource in milliseconds.

Min / Max

Best and worst case tick times in the profiling window.

Frame share

What percentage of the server frame this resource consumes.

Thread breakdown

Which script threads (server, client, shared) are contributing to the duration.

Alerts

When a resource exceeds the configured duration threshold (default: 2ms), an alert is recorded and appears in the Performance tab sidebar. You can acknowledge alerts directly from the dashboard. Configure thresholds under Settings β†’ Alerts β†’ Resource.

Player Management

Online players

The Players tab shows all currently connected players with their name, license identifier, IP, job, gang, and current coordinates. Click any player to open their full profile.

Player profile

Each player has a profile page showing their history, identifiers, and current status. From here you can:

Ban

Permanently ban by license. Applies across all sessions.

Kick

Kick from the server with a reason message.

Warn

Issue a formal warning that goes on their record.

View history

See all past bans, kicks, and warnings for this player.

Ban management

All bans are listed under the Bans tab. You can search by name, license, or IP. To unban a player, click their entry and select Unban. Bans are enforced by the veil-monitor resource on connect.

Offline player lookup

Can't find a player because they're not online? Use the search on the Players page β€” it searches the database for players who have connected before, even if they're currently offline.

Anti-Cheat System

The anti-cheat runs inside veil-monitor entirely server-side. It monitors player behavior using FiveM natives β€” no client-side injection required.

Detection types

πŸ›‘οΈ

Aimbot / Silent aim

Detects abnormal heading-to-target angles and instant snap targeting patterns that don't match normal player input.

πŸ›‘οΈ

Speed hacks

Monitors vehicle and player movement speed against expected maximums for each vehicle class.

πŸ›‘οΈ

God mode / invincibility

Detects players taking damage events that should be lethal but surviving with full health.

πŸ›‘οΈ

Weapon spawning

Detects weapons that weren't granted through normal server-side means.

πŸ›‘οΈ

Cheat menu strings

Scans for known cheat menu identifiers in player NUI events (Kiddion, Stand, Cherax, etc.).

Auto-ban

When a detection fires, the player is immediately kicked and the event is logged to the dashboard. If the same player triggers multiple detections, they are automatically banned. All detections appear in the Activity feed on the server dashboard.

Dealing with false positives

  1. 1. Open the detection in the Activity feed to see exactly what triggered it.
  2. 2. If it's a script conflict (e.g. a custom vehicle with unrealistic speeds), disable that specific detection type in Settings.
  3. 3. If a player was wrongly banned, unban them from the Bans tab.
  4. 4. If you're getting repeated false positives for a specific pattern, contact support with the detection logs.

Live Spectate

Live Spectate lets you watch any online player's screen in real time directly in the dashboard. The video is streamed as VP9 over a secure WebSocket via the Veil relay β€” no port forwarding needed on the game server.

Starting a spectate session

  1. 1 Go to Players and find the player you want to spectate.
  2. 2 Click their name to open their profile, then click Spectate.
  3. 3 The spectate page opens. The stream initializes automatically β€” wait a moment for the first keyframe to arrive.
  4. 4 Use Reconnect if the stream drops, or Stop to end the session.

Requirements

  • β€’ veil-monitor must be running on the server (it handles the capture side)
  • β€’ The player must be currently online
  • β€’ Your browser must support WebCodecs (Chrome 94+, Edge 94+) β€” Firefox is not supported
  • β€’ Professional or Enterprise plan required

Authorized use only

Live spectate should only be used for anti-cheat review, moderation, and authorized server administration. Misuse may violate your server's community guidelines.

Economy Monitoring

The Economy tab shows player balances, cash, bank totals, and transaction activity across your server. This helps you spot money exploits, duping, and economic imbalances before they affect your community.

Framework support

ESX

Reads from the ESX accounts table (bank, money, black_money).

QBCore

Reads from QB player metadata (cash, bank, crypto).

QBox

Reads from QBox player data structures.

Custom

Boilerplate Lua files are provided β€” fill in the data access functions for any other framework.

Set your framework under Settings β†’ General β†’ Framework. Data is collected passively as players log in and out β€” no script modifications required for ESX, QBCore, or QBox.

Discord Bot

The Veil Discord bot lets your staff manage the server directly from Discord using slash commands. Permissions are configured per-command so only the right roles have access.

Setup

  1. 1 Go to Dashboard β†’ your server β†’ Discord.
  2. 2 Click Link Guild and authenticate with your Discord account.
  3. 3 Select the Discord server (guild) to link.
  4. 4 Optionally set an alert channel for performance/cheat notifications.
  5. 5 Configure command permissions β€” assign which Discord roles can run each command.

Available commands

/status Shows server status, player count, CPU, and RAM.
/players Lists all currently online players.
/ban Bans a player by license identifier.
/unban Removes a ban for the given license.
/check-ban Checks if a license is currently banned.
/economy Shows a snapshot of the server economy (top balances, totals).
/alerts Lists recent performance and anti-cheat alerts.

Player Map

The Map tab shows a live GTA V map with every online player's current position as a pin. Positions update periodically as the server sends location data through veil-monitor.

Click any pin to see the player's name and identifier. The map uses the standard GTA V coordinate system centered on 0,0,0 (Spanish Avenue). Positions are approximate and update every few seconds.

Database Backups

The agent can backup your FiveM server's MySQL/MariaDB database directly to your server host's disk. Backups are initiated from the dashboard.

Creating a backup

Go to your server β†’ Backups β†’ Create Backup. The agent connects to your database using the credentials in its config and creates a compressed SQL dump. The backup file is stored on your game server host.

Restoring a backup

Select a backup from the list and click Restore. The agent will apply the SQL dump to your database. ⚠️ This overwrites current data β€” make sure you have a recent backup before restoring.

Troubleshooting

Server shows as Offline in the dashboard
  1. 1. Check that the Veil Agent binary is actually running on the game server host.
  2. 2. Verify the server key in your server.cfg matches the one in your dashboard under Settings.
  3. 3. Check that the agent's socket port (default 8080) is open inbound on your firewall.
  4. 4. Look at the agent's terminal output for connection errors.
Live console says "Not connected" or shows a WebSocket error
  1. 1. The console connects through the Veil relay β€” check your internet connection first.
  2. 2. Check that your server is Online in the dashboard (console requires the agent to be connected).
  3. 3. Hard-refresh the page (Ctrl+Shift+R) to clear any stale session.
  4. 4. If the error says "Unauthorized", your session expired β€” refresh the page to get a new one.
veil-monitor is not appearing in server console on startup
  1. 1. Check that ensure veil-monitor is in your server.cfg.
  2. 2. Check that set vm_server_key is set correctly β€” the key must match your dashboard.
  3. 3. Make sure the resource is in the correct path: resources/[veil]/veil-monitor or similar.
  4. 4. Check the FXServer console for Lua errors from veil-monitor on startup.
Anti-cheat false positives β€” legitimate players getting kicked
  1. 1. Open the detection in the Activity feed to see the exact detection type and values.
  2. 2. For speed-related false positives: check if you have custom vehicles with high top speeds β€” adjust the speed threshold in Settings.
  3. 3. For aimbot false positives: this sometimes triggers on certain NPC targeting scripts β€” disable the specific detection type if needed.
  4. 4. Unban any wrongly banned players from the Bans tab.
  5. 5. If false positives persist, open a support ticket with the detection log.
Performance data is not updating
  1. 1. Performance profiling requires the agent to be online and the FXServer to be running.
  2. 2. The profiler runs on an interval β€” wait a few minutes after server start for the first data to appear.
  3. 3. Check that your analytics settings are enabled under Settings β†’ Analytics.
Spectate stream not starting / stays on "Connecting"
  1. 1. Make sure veil-monitor is running β€” spectate capture happens inside FiveM.
  2. 2. The player must still be online when the stream initializes.
  3. 3. Use Chrome or Edge (94+) β€” Firefox does not support WebCodecs which spectate requires.
  4. 4. Try clicking Reconnect on the spectate page.
Discord bot commands not working
  1. 1. Make sure your Discord guild is linked under Dashboard β†’ your server β†’ Discord.
  2. 2. Check that the bot has the correct permissions in your Discord server (slash commands require Applications.Commands scope).
  3. 3. Verify the role permissions for each command are configured correctly.
  4. 4. Re-link the guild if you recently changed Discord server permissions.

Still stuck?

If you can't resolve the issue with the steps above, reach out to us directly: