Documentation

Everything you need to get started with Valor Shield

Introduction

Valor Shield is a comprehensive cloud-based anti-cheat solution designed specifically for FiveM servers. It provides real-time protection against cheaters, exploiters, and malicious players while maintaining optimal server performance.

Cloud-Based Protection

All detection logic runs on our secure cloud servers, making it impossible for cheaters to bypass or reverse-engineer the anti-cheat.

Requirements

  • FiveM Server (latest recommended)
  • Valid Valor Shield License
  • Server with outbound HTTPS access
  • OneSync enabled (recommended)

Supported Frameworks: ESX, QBCore, QBox, vRP, Standalone

Quick Start Guide

1

Purchase & Redeem License

Purchase a license from our pricing page, then redeem it in your dashboard.

2

Download the Resource

Download the Valor Shield resource from your dashboard and extract it to your server's resources folder.

3

Add the .api File

Download your .api file from the dashboard and place it in the valorshield resource folder.

4

Start the Resource

Add ensure valorshield to your server.cfg and restart your server.

Server Setup

File Structure

resources/
└── [valorshield]/
    └── valorshield/
        ├── client/
        ├── server/
        ├── config.lua
        ├── fxmanifest.lua
        └── valorshield.api    ← Your license file

server.cfg

# Add this BEFORE your framework
ensure valorshield

# Then your framework
ensure es_extended # or qb-core, etc.

Important

Valor Shield must be started before your framework to ensure all players are protected from the moment they connect.

Configuration File

Config = {}

-- General Settings
Config.Debug = false
Config.Framework = "auto"  -- auto, esx, qbcore, qbox, vrp, standalone

-- Detection Settings
Config.Detections = {
    SpeedHack = true,
    GodMode = true,
    Noclip = true,
    Teleport = true,
    WeaponModifier = true,
    VehicleSpawn = true,
    ResourceInjection = true,
    MenuDetection = true
}

-- Action Settings
Config.Actions = {
    AutoBan = true,
    BanDuration = 0,  -- 0 = permanent
    Screenshot = true,
    Webhook = true
}

-- Discord Webhook
Config.Webhook = ""  -- Set in dashboard

Detection Modules

Speed Hack Detection

Detects players moving faster than physically possible, including vehicle speed modifications.

God Mode Detection

Identifies players with abnormal health values or damage immunity.

Noclip Detection

Detects players clipping through walls, terrain, or other solid objects.

Teleport Detection

Catches unauthorized teleportation attempts with configurable distance thresholds.

Resource Injection

Detects unauthorized Lua executors and injected resources.

Cross-Server Ban Sync

Valor Shield can sync bans across all servers using the same license, or opt-in to the global ban network.

Local Ban Sync

Bans are shared across all servers under your license. Enabled by default.

Global Ban Network

Opt-in to receive bans from other Valor Shield servers. Configure in dashboard.

-- Exclude specific licenses from your ban sync
Config.BanSync = {
    Enabled = true,
    GlobalNetwork = false,
    ExcludedLicenses = {
        "VSLD-XXXX-XXXX-XXXX-XXXX"  -- Partner server
    }
}

API Authentication

All API requests require authentication using your license key.

curl -X GET https://api.valorshield.net/v1/status \
  -H "Authorization: Bearer YOUR_LICENSE_KEY" \
  -H "Content-Type: application/json"

API Endpoints

GET /v1/status

Check license status and server connection

POST /v1/bans

Create a new ban entry

GET /v1/bans/:identifier

Check if a player is banned

DELETE /v1/bans/:id

Remove a ban entry

GET /v1/reputation/:identifier

Get player reputation score

Frequently Asked Questions

Does Valor Shield affect server performance?
No, Valor Shield is designed to have minimal impact on server performance. All heavy processing is done on our cloud servers, not yours.
Can I use one license on multiple servers?
Each license is tied to one server (Guild ID). You'll need separate licenses for additional servers.
What happens if I get a false positive?
Players can submit ban appeals through your dashboard. You can also configure detection sensitivity and whitelist specific actions.
How do I transfer my license to a new server?
You can reset your Guild ID lock up to 3 times per month from your dashboard settings.
Do you offer support?
Yes! Join our Discord server for support, or email us at support@valorshield.net.

Still need help?

Our support team is here to assist you