Skip to main content

Configuration Overview

The tracker system is configured through platform/cfg/game.cfg and platform/r5rdev_config.json. Some legacy settings may also be found in playlists_r5_patch.txt.

Game Config (game.cfg)

Add these ConVars to your platform/cfg/game.cfg file to configure the WebSocket interface and tracker behavior.

WebSocket Settings

ConVarDefaultDescription
tracker_ws_enable1Enable WebSocket remote command interface (0 = disabled, 1 = enabled).
tracker_ws_port9705WebSocket server port.
tracker_ws_debug0Enable WebSocket debug logging.
tracker_ws_use_ssl1Use SSL for WebSocket connection.
tracker_ws_lax_ssl0Lax SSL certificate validation (0 = strict, 1 = lax). See Getting Started.
tracker_ws_buffer_size261120WebSocket buffer size in bytes (Startup only).
tracker_ws_max_retries3Maximum number of connection retries.
tracker_ws_retry_time5.0Time in seconds between retries.
tracker_ws_time_out125Connection timeout in seconds.
tracker_ws_keep_alive60Keep-alive interval in seconds.
tracker_ws_throttle_rate0.10Message processing throttle rate (seconds).
tracker_ws_hostnamer5r.devWebSocket server hostname.
tracker_ws_tls_version3TLS Version (0: 1.0, 1: 1.1, 2: 1.2, 3: 1.3).
tracker_ws_relay_chat0Relays chat messages to qualified clients via web panel.
tracker_ws_reconnect_on_change1Reconnect to remote socket when qualified convars change.
tracker_ws_ca_bundle_fileSectigobundle.pemCertificate bundle file name.

Playlist Patch (playlists_r5_patch.txt)

These settings control the core stats tracking behavior.
See CC Commands for instructions on enabling and using Client Commands via cc_administration.
tracker_enabled                         1       // Run the tracker system (plugin required)
tracker_encryption                      1       // Will be deprecated
tracker_shipstats                       1       // Transfer data at end of match
use_global_stats                        1       // Use API data (transfers at start/end or when non-batched player connects)
tracker_max_wait                        7.0     // Max wait for batch load (seconds)
stats_discord_webhook_player_count      0       // Sends player join/disconnect data to Discord webhook
stats_discord_webhook_matches_enabled   0       // Sends recap data to Discord webhook

Config JSON (r5rdev_config.json)

Most modern configuration should be done in platform/r5rdev_config.json. This file is where you place your Host API Key generated from the control panel.
Ensure stats_discord_webhook_player_count and stats_discord_webhook_matches_enabled are configured here or in playlists_r5_patch.txt to enable Discord integrations.