Installation
Complete step-by-step guide to installing the Finals Web Panel bridge on your FiveM server.
1. Prerequisites
Before installing the bridge resource, ensure your FiveM server meets the following requirements:
| Requirement | Supported Versions | Notes |
|---|---|---|
| FXServer Artifact | 7290 or newer | Recommended Cerulean build. |
| ox_lib | Latest Release | Core utility dependency for safe data handling and exports. |
| Framework | QBCore, Qbox, ESX (Legacy/v1), ox_core | Auto-detected on startup via built-in adapters. |
| Network Outbound | HTTPS / WSS | Zero open ports required. All communication is initiated outbound by your server to our secure cloud API. |
| Live Spectating | Built-In | No external capture resources required. Direct 720p 30 FPS video stream with 0.00ms server overhead. |
[!NOTE] No Firewall / Port Forwarding Needed: Unlike legacy RCON panels, the Finals Web Panel does not require opening custom ports on your VPS/dedicated server. The bridge maintains an outbound secure connection to our cloud backend.
2. Download and Place the Resource
- Obtain the
finals_webpanelresource folder from your Project Finals client dashboard or Discord purchase confirmation. - Place the folder into your server's resources directory (recommended:
resources/[finals]/finals_webpanel).
3. Configure Your Bridge Token
Open your server.cfg file and add the following lines at the bottom (or above your resource start order):
# ==========================================
# Finals Web Panel Configuration
# ==========================================
setr finals_webpanel_token "br_YOUR_SERVER_TOKEN_HERE"[!IMPORTANT] Replace
br_YOUR_SERVER_TOKEN_HEREwith the Bridge Token generated when adding your server in the Finals Web Panel dashboard. Never share this token publicly.
4. Optional Configuration Overrides
You can optionally configure the following ConVars in your server.cfg to override auto-detection:
| ConVar | Options / Default | Description |
|---|---|---|
finals_webpanel_framework | qbcore / qbox / auto | Force a specific framework adapter if running a hybrid setup. |
finals_webpanel_token | br_xxx | Your server bridge authentication secret. |
5. Start Order in server.cfg
Ensure the resource is started after your core framework and utilities:
# 1. Base dependencies
ensure ox_lib
# 2. Framework (e.g. QBCore or Qbox or ESX)
ensure qb-core
# 3. Finals Web Panel Bridge
ensure finals_webpanel[!TIP] You do not need to install
screencaptureorscreenshot-basic. Live Spectate is handled entirely byfinals_webpanelnatively.
When the bridge successfully authenticates, you will see the following output in your server console:
[finals_webpanel] Initializing Project Finals Bridge v2.8.0...
[finals_webpanel] Framework detected: QBCore (auto-detect)
[finals_webpanel] Authenticated successfully with Project Finals Cloud.
[finals_webpanel] Live synchronization active.Your server in the Web Panel will instantly change status to ONLINE (Green), and live player data will begin streaming.
6. Live Player Spectating (Zero Server Overhead)
The Finals Web Panel features a high-performance Live Spectate Engine. GTA V gameplay is streamed directly to authorized staff in the Web Panel with smooth 30 FPS video and zero server lag.
Key Highlights:
- 0.00ms FXServer Tick Overhead: Zero screenshots captured via FXServer, zero DirectX pipeline stalls for the player, and zero CPU usage on the game server.
- Zero Server Bandwidth: Real-time 720p 30 FPS video travels directly from the player's screen to the web panel. Video data never touches your server or backend API.
- No External Resources Required: You do not need
screencaptureorscreenshot-basic. Everything is built directly intofinals_webpanel. - Instant Start & Stop: Start viewing any online player instantly by clicking Spectate in the Web Panel.