QBCore Integration
When QBCore is detected, Blaze Sites unlocks deep integration with your server's player data.
What's available with QBCore
| Feature | Description |
|---|---|
| Character names | Show character first/last name instead of Steam name |
| Job display | Show each player's current job and grade |
| Gang display | Show gang/faction membership |
| Character profiles | Public profile pages per character |
| Leaderboards | Richest players, job rankings, hours played |
| Whitelist check | Pre-join whitelist verification |
| Economy data | Total server money, job earnings |
Setup
No additional setup is required beyond the standard companion installation. The companion auto-detects QBCore at startup:
[blaze-companion] Framework detected: QBCore v1.2.x
[blaze-companion] Player data sync: enabled
[blaze-companion] Economy sync: disabled (enable in config.lua)
If detection fails, manually set:
Config.Framework = "qbcore"
Character profiles
When Character Profiles are enabled (Settings → FiveM Integration → Character Profiles), each character gets a public page at:
yourserver.blazesites.net/characters/firstname-lastname
The profile shows:
- Character name and photo (if set in-game)
- Current job and grade
- Gang/faction (if any)
- Total hours played
- Vehicle count
- Bio (if character has set one in-game)
Privacy controls: Players can hide their profile from their account page on your site. Staff can override this from the dashboard.
Whitelist integration
The companion exposes a whitelist check endpoint that your FiveM server queries before allowing a player to connect:
In your server's server.cfg:
set blaze_whitelist_check "true"
When a player attempts to join, the companion checks their Discord ID against approved whitelist applications on your Blaze Sites. If not whitelisted, they receive:
You are not whitelisted on this server.
Apply at: yourserver.blazesites.net/applications
Supported QBCore versions
The companion supports QBCore versions 1.1.0 and above. Check your version with:
/qb-core version
in your server console.