Install & Configuration

📘 Overview

SwiftLink is an advanced FiveM speed camera and monitoring system. It automatically detects speeding vehicles, applies fines, and integrates with Discord for real-time law enforcement alerts. The system is fully configurable and built to work seamlessly with QB-Core and ox_lib.

---

🧰 Requirements

Before installation, make sure the following dependencies are installed and started before SwiftLink:

• QB-Core

• ox_lib

---

📦 Installation

1. Download SwiftLink

Download the latest release or clone the repository:

https://github.com/1SwiftStudios1/SwiftLink/releases

2. Drag & Drop

Place the SwiftLink folder into your server’s resource directory:

/resources/

3. Add to server.cfg

Add the following line to your server configuration file:

ensure SwiftLink

Make sure ox_lib and qb-core are ensured before SwiftLink:

ensure qb-core
ensure ox_lib
ensure SwiftLink

4. Restart Your Server

Restart the server or use: (It is recommended you restart the server)

/refresh
/start SwiftLink

---

⚙️ Configuration

All settings are located in:

SwiftLink/config.lua

---

🖥️ Computer Access Points

Define where players can access the traffic monitoring interface (e.g. police stations, HQs, or monitoring centers).

Config.ComputerLocations = {
    { coords = vector3(-449.04, 6012.6, 31.72), range = 1.0 },
}

Tip: Add more entries by duplicating the format and changing coordinates.

---

📸 Speed Camera Locations

Each camera detects and fines speeding vehicles automatically.

Field	Description
name	Unique camera identifier
coords	Zone detection center
width	Lateral detection width
rotation	Facing direction (degrees)
propCoords	Physical camera pole/object position
speedLimit	Enforced speed limit

Example:

{ name = "1001", coords = vector3(522.62, 6551.89, 27.44), width = 42.0, rotation = 257.01, propCoords = vector3(522.62, 6551.89, 27.44), speedLimit = 40 },

Use the in-game command *copycamcoords to easily copy and paste formatted entries.

---

💰 Speeding Fines Configuration

Define how much players are fined based on how far over the speed limit they are traveling.

Config.MinimumOverSpeedForFine = 5
Config.SpeedingFines = {
    { minOver = 20, fine = 200, label = "20+ MPH over limit" },
    { minOver = 15, fine = 150, label = "15–19 MPH over limit" },
    { minOver = 10, fine = 100, label = "10–14 MPH over limit" },
    { minOver = 5,  fine = 50,  label = "5–9 MPH over limit"  },
}

---

⚙️ System Behavior

Control how SwiftLink behaves globally.

Config.SpeedUnit = "MPH"
Config.ExemptEmergencyVehicles = true
Config.EnableFlashEffect = true

Option	Description
SpeedUnit	Use "MPH" or "KMH"
ExemptEmergencyVehicles	Prevents emergency vehicles from being fined
EnableFlashEffect	Enables a flash when a player is caught speeding

---

🛠️ Developer & Admin Commands

These commands assist with development, debugging, and testing camera placement.

Config.Commands = {
    CreateCam = "*copycamcoords",
    ToggleDisplayCams = "*togglecamdisplay"
}

Command	Function
*copycamcoords	Copies your current position as a camera entry
*togglecamdisplay	Toggles visibility of camera markers on the map

---

📡 Discord Webhook Integration

SwiftLink can automatically send alerts to a Discord channel whenever a speeding violation is detected.

Config.DiscordWebhookName = "Los Santos Government | Traffic Camera Network"
Config.Webhooks = {
    Speeding = "https://discord.com/api/webhooks/your-webhook-url"
}

Tip: Use a dedicated webhook channel for traffic alerts to keep logs clean and organized.

---

🧪 Testing & Verification

1. Start your server and ensure there are no console errors.

2. Drive through a camera zone above the speed limit.

3. Check for:

   • Flash effect (if enabled)

   • Fine applied via QB-Core bank system

   • Discord alert (if webhook configured)

If all three occur, SwiftLink is correctly installed and functioning.

---

🧩 Troubleshooting

Issue	Possible Cause	Solution
Cameras not triggering	ox_lib not running	Ensure ox_lib is started before SwiftLink
No fines applied	QB-Core integration issue	Verify player has valid PlayerData and a registered bank account
Discord alerts missing	Invalid or missing webhook URL	Double-check your webhook in config.lua
Commands not working	Typos or disabled admin permissions	Ensure commands match and you have permissions

---

📄 License & Credits

Developed by Swift Studios Built for QB-Core (More Frameworks To Come) © 2025 Swift Studios - All Rights Reserved