Extension "SRS"
SimpleRadioStandalone (DCS-SRS) is an awesome tool built by CiriBob, who dedicates a lot of work and this
simulated real life radio experience to DCS. Many if not every server runs an SRS server too, to let their players have
a proper radio experience.
DCSServerBot integrates nicely with SRS. If you place your server.cfg in your Saved Games\DCS(...)\Config folder (and I
usually rename it to SRS.cfg, just to avoid confusions in there), the bot can auto-start and -stop your SRS server
alongside with your DCS server. It even monitors if SRS has crashed (that's a waste of code... I literally never saw
that crash) and start it again in such a case.
Configuration
To enable SRS, support, you need to add the following parts to your nodes.yaml:
# config/nodes.yaml
MyNode:
# [...]
extensions:
SRS:
installation: '%ProgramFiles%\DCS-SimpleRadio-Standalone'
beta: true # allow beta versions
autoupdate: true # auto update your DCS-SRS installation, if a new version is available online (default: false)
use_upnp: true # Do you want to use UPnP to auto-forward your SRS ports? If not set, the global setting will be used.
auto_affinity: # Optional: core affinity settings
min_cores: 1 # Min number of cores to be used (default: 1)
max_cores: 1 # Max number of cores to be used (default: 1)
quality: 0 # Quality (0 = low, 1 = normal, 2 = high, default: 0)
announce: # Optional: post a message to Discord after every update
channel: 1122334455667788
title: DCS-SRS has been updated to version {}!
description: 'The following servers have been updated:'
footer: Please make sure you update your DCS-SRS client also!
mention: # Optional mentioning
- DCS
# [...]
instances:
DCS.dcs_serverrelease:
# [...]
extensions:
SRS:
config: '{instance.home}\Config\SRS.cfg'
host: 127.0.0.1
port: 5002
http_server_enabled: true # Optional: Enable the HTTP server (default: false)
http_server_port: 8080 # Optional: HTTP server port (default: 8080)
gui_server: true # Optional: use the SRS-Server.exe (GUI server) instead of the command line one
minimized: true # Optional: start GUI server minimized (default: true)
autoconnect: true # install the appropriate DCS-SRS-AutoConnectGameGUI.lua, default: true
disconnect_grace_loops: 3 # Internal: number of loops until a client is considered disconnected
awacs: true # if you use LotAtc
lotatc_export_port: 10712
blue_password: blue
red_password: red
show_passwords: false # Optional: do not show red/blue passwords in the status embed (default: true)
radio_effect_override: false # optional: disable radio effects (LOS, etc)
global_lobby_frequencies: 248.22,30.0,127.0 # optional: set your music channels in here
autostart: true # optional: if you manage your SRS servers outside DCSSB, set that to false
always_on: true # start SRS as soon as possible (includes no_shutdown: true)
no_shutdown: true # optional: don't shut down SRS on mission end (default: false)
srs_nudge_message: 'Optional nudge message' # optional: overwrite the existing nudge message
instructor_mode: true # enable instructor mode (as of SRS 2.3.3.0)
Optional parameters (will change server.cfg if necessary): * autoupdate If true, SRS will check for updates and update itself. * host The hostname or IP to be used in your DCS-SRS-AutoConnectGameGUI.lua. The bot will replace it in there. * port SRS port (default: 5002) * awacs AWACS mode * blue_password AWACS mode, password blue. * red_password AWACS mode, password red. * autostart If true, the SRS server will be auto-started (default).
Important
You need to give the bot-user write permission on the SRS installation directory to use SRS-autoupdate.
Warning
The new REST service for SRS is not supported yet, as it needs administrative elevation. I am in contact with Ciribob already to remove this requirement.
Tip
You can rename the SRS extension in your server status embed by setting a "name" in the configuration like so:
extension:
SRS:
name: MyFancyName # Optional: default is "SRS
Configuration reference
| Key | Type | Description | Example |
|---|---|---|---|
enabled |
bool | Whether this extension is enabled on this node. | true |
name |
str | Name of the SRS extension in status embeds. (range: min 1) | SRS |
installation |
str | Directory where DCS-SRS is installed. (range: min 1) | %ProgramFiles%\DCS-SimpleRadio-Standalone |
autoupdate |
bool | Update DCS-SRS automatically on new releases. | true |
use_upnp |
bool | Use UPnP to forward the SRS ports automatically. | true |
auto_affinity |
map | Core affinity assigned to the SRS process. | min_cores: 1 |
announce |
map | Discord announcement posted after every SRS update. | channel: 1122334455667788 |
beta |
bool | Allow beta versions of DCS-SRS to be installed. | true |
autostart |
bool | Start the SRS server together with the DCS server. | true |
host |
str | Hostname or IP written into the SRS autoconnect script. (range: min 1) | 127.0.0.1 |
minimized |
bool | Start the SRS GUI server minimized. | true |
debug |
bool | Replicate the SRS console output into the bot log. | false |
gui_server |
bool | Use the SRS GUI server instead of the command line one. | true |
awacs |
bool | Enable the SRS external AWACS mode. | true |
blue_password |
str | External AWACS password for the blue coalition. (range: min 1) | blue |
red_password |
str | External AWACS password for the red coalition. (range: min 1) | red |
no_shutdown |
bool | Keep SRS running when the DCS server shuts down. | false |
srs_nudge_message |
str | Nudge message asking players to connect to SRS. (range: min 1) | Please connect to SRS! |
autoconnect |
bool | Install the SRS autoconnect script for the players. | true |
show_passwords |
bool | Show the AWACS passwords in the status embed. | false |
always_on |
bool | Start SRS as soon as possible, independently of DCS. | true |
radio_effect_override |
bool | Disable SRS radio effects such as line of sight. | false |
global_lobby_frequencies |
str | Music frequencies available to all SRS clients. (range: min 1) | 248.22,30.0,127.0 |
instructor_mode |
bool | Enable the SRS instructor mode. | true |
enabled |
bool | Enable the SRS extension for this instance. | true |
name |
str | Name of the SRS extension in status embeds. (range: min 1) | SRS |
config |
str | Path to the SRS server.cfg used by this instance. | {instance.home}\Config\SRS.cfg |
host |
str | Hostname or IP written into the SRS autoconnect script. (range: min 1) | 127.0.0.1 |
port |
int | Port the SRS server listens on. | 5002 |
auto_affinity |
map | Core affinity assigned to the SRS process. | min_cores: 1 |
gui_server |
bool | Use the SRS GUI server instead of the command line one. | true |
minimized |
bool | Start the SRS GUI server minimized. | true |
debug |
bool | Replicate the SRS console output into the bot log. | false |
awacs |
bool | Enable the SRS external AWACS mode. | true |
blue_password |
str | External AWACS password for the blue coalition. (range: min 1) | blue |
red_password |
str | External AWACS password for the red coalition. (range: min 1) | red |
autostart |
bool | Start the SRS server together with the DCS server. | true |
no_shutdown |
bool | Keep SRS running when the DCS server shuts down. | false |
srs_nudge_message |
str | Nudge message asking players to connect to SRS. (range: min 1) | Please connect to SRS! |
autoconnect |
bool | Install the SRS autoconnect script for the players. | true |
show_passwords |
bool | Show the AWACS passwords in the status embed. | false |
always_on |
bool | Start SRS as soon as possible, independently of DCS. | true |
radio_effect_override |
bool | Disable SRS radio effects such as line of sight. | false |
global_lobby_frequencies |
str | Music frequencies available to all SRS clients. (range: min 1) | 248.22,30.0,127.0 |
lotatc_export_port |
int | Port SRS exports LotAtc data on. | 10712 |
http_server_enabled |
bool | Enable the SRS HTTP server (SRS 2.3+). | true |
http_server_port |
int | Port the SRS HTTP server listens on. | 8080 |
node_srs
| Key | Type | Description | Example |
|---|---|---|---|
auto_affinity.min_cores |
int | Minimum number of CPU cores to assign. (range: min 1, max 1) | 1 |
auto_affinity.max_cores |
int | Maximum number of CPU cores to assign. (range: min 1, max 1) | 1 |
auto_affinity.quality |
int | Core quality to prefer (0=low, 1=normal). (range: min 0, max 1) | 0 |
announce.channel |
int (required) | Discord channel id the announcement is posted to. | 1122334455667788 |
announce.title |
str | Announcement title; {} is replaced by the version. (range: min 1) | DCS-SRS has been updated to version {}! |
announce.description |
str | Announcement body text. (range: min 1) | The following servers have been updated: |
announce.footer |
str | Text shown in the announcement footer. (range: min 1) | Please make sure you update your DCS-SRS client also! |
announce.mention |
list | Roles or users mentioned in the announcement. | - DCS |
instance_srs
| Key | Type | Description | Example |
|---|---|---|---|
auto_affinity.min_cores |
int | Minimum number of CPU cores to assign. (range: min 1, max 1) | 1 |
auto_affinity.max_cores |
int | Maximum number of CPU cores to assign. (range: min 1, max 1) | 1 |
auto_affinity.quality |
int | Core quality to prefer (0=low, 1=normal). (range: min 0, max 1) | 0 |