A Discord bot for FiveM servers on ESX, QBCore, Qbox, ox_core and vRP
By Termi5 min read
FiveBot is a Discord bot for tickets, moderation and AI answers from your own rules. It also comes with a FiveM resource, fivebot_bridge, that connects your game server to the same dashboard. The Discord side works without it. With it, tickets, reports and bans know who the player is in the city.
What works without the game server
Everything on Discord runs on any server, FiveM or not. You get ticket panels with free claiming and permanent transcripts, anti-spam, anti-raid and anti-nuke, applications on web forms, reaction roles and custom commands on every plan. From Starter, tickets also get AI answers cited from your rules, two-way translation and Hollo, a chat bubble for your website.
Plenty of FiveM communities start there and install the bridge once the Discord side is settled.
What the bridge adds
The bridge works on every plan. It is one resource with no required dependencies, and it adds the parts that need the game. The player card needs Starter, and the AI developer and AI NPCs need Pro.
- A live player count on a Discord channel, sent every two minutes.
- Bans, warnings, kicks and lifted bans from txAdmin, each with the admin who gave it and the reason. Nine anticheats, WaveShield, Fiveguard and ElectronAC among them, report theirs too, each ban with what the server saw the player do before it. Any other admin menu or anticheat can report through one export. How txAdmin actions reach FiveBot.
- In-game reports. A player types
/report 12 shot me at the bankand your staff get the same report card as a Discord report, with both characters and the distance between them. More on in-game reports. - Store payments. When a player says a purchase never arrived, FiveBot asks the bridge, and the bridge asks the store. Tebex works on its own, Skalp plugs itself in, and any other store can plug in with one export. Handling "I paid and got nothing".
- Script errors from the server console, collected in the dashboard with passwords, tokens, IP addresses and emails removed. You get an email when they spike and a short summary once a day. Script error alerts.
- A player card in the dashboard with money, items, job and cars, and changes like giving money or setting a job with one button. Checking a player.
- Config and script changes from a plain request, shown before they are saved and rolled back if the script fails. The AI developer.
- Every command your staff run on the game server, per admin. The admin command log.
- AI NPCs that stand in your city and talk to players. How they work.
Frameworks it reads
On start the bridge looks for a framework and reads a character's name, job, grade and gang. That is how an NPC greets a police officer by rank and how a report card names the characters involved.
| Framework | Resource | What it reads |
|---|---|---|
| ESX Legacy and older ESX | es_extended | Name, job, grade label, and the hidden job as a gang on forks that have one |
ESX forks with GetPlayerFromIdClass | es_extended | First and last name, job, grade label, hidden job |
| Qbox | qbx_core | Character info, job, grade, gang |
| QBCore | qb-core | Character info, job, grade, gang |
| ox_core | ox_core | Character name, active group and its grade |
| vRP (vRPex builds) | vrp | Identity and the group of type job |
Without a framework the bridge runs on player identifiers alone, and that is a supported setup. A framework that starts after the bridge is picked up when it starts. To force one, set fivebot_framework to esx, qbcore, qbox, ox, vrp or none. A renamed core is found by its exports, and so are the inventory and the medical script. Supported frameworks and inventories.
Installing it
- In the dashboard, open Settings, Game Server Bridge, download
fivebot_bridgeand create a server token. The shared secret is shown once, so copy it straight away. - Drop
fivebot_bridgeintoresources/. - Add the lines below to
server.cfgand restart. If a line is missing, the server console says which one.
set fivebot_api_url "https://api.fivebot.ai"
set fivebot_server_token "srv_..."
set fivebot_shared_secret "..."
ensure fivebot_bridge
The token and the secret live in server.cfg, outside the resource folder. Resources get copied, zipped and shared, and a token inside the folder would travel with every copy.
AI characters are spawned by the server and need OneSync, which txAdmin turns on by default. Everything else works without it. ox_lib, oxmysql and a framework are all optional.
What it leaves alone
FiveM reports an ip: identifier with the others, and the bridge drops it before anything is stored or sent. It keeps no ban list on your server either: bans are checked against FiveBot when they matter.
The bridge's logic files are obfuscated. Two files stay readable and are yours to edit: config.lua for timings and client/chat.lua for how FiveBot's lines reach the player. An update replaces everything else, so keep your changes in those two.
How much traffic it makes
Joins and leaves go out in batches every two seconds, never one request per event. The player count goes every two minutes. The bridge checks for actions from the dashboard every three to four and a half seconds. When the API cannot be reached, each failing route is logged once, and once more when it recovers, so a wrong token does not flood the console.
Questions people ask
Do I need Pro for the Discord bot?
No. Entry and Starter run tickets, moderation, security and, on Starter, AI answers and Hollo. The bridge works on every plan and reads character data from ESX, QBCore, Qbox, ox_core or vRP. AI NPCs and Bodycam start at Pro. Current prices are on fivebot.ai/pricing.
Does it work with txAdmin out of the box?
Yes. The bridge listens to txAdmin's own events, so bans, warnings and kicks arrive without any setup in txAdmin.
Can I run it next to my other bots?
Yes. FiveBot does not need to be the only bot on the server, so you can keep your old ticket bot while you compare.
Is FiveBot affiliated with Cfx.re?
No. FiveBot is not affiliated with Cfx.re, Rockstar Games or Take-Two Interactive.