Skip to content

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)
You need one entry in the node section, pointing to your DCS-SRS installation and one in every instance section, where you want to use SRS with. The next time the bot starts your server, it will auto-launch SRS and take care of it.

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
max_cores: 1
quality: 0
announce map Discord announcement posted after every SRS update. channel: 1122334455667788
title: DCS-SRS has been updated to version {}!
mention:
- DCS
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
max_cores: 1
quality: 0
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
- Admin

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