Skip to content

Plugin "SRS"

SimpleRadioStandalone (DCS-SRS) is a radio solution for DCS World.
If you want to use SRS in DCSServerBot, in most cases it is enough to activate the respective extension. When you are dealing with LotAtc, or if you want to display the SRS activity status for your players, or if you even want to use slot blocking based on SRS – then you want to install this plugin.

Configuration

As SRS is an optional plugin, you need to activate it in main.yaml first like so:

# config/main.yaml
opt_plugins:
  - srs

If you want to use the slot blocking feature, you need to create a config/plugins/srs.yaml file like so:

# config/plugins/srs.yaml
DEFAULT:
  message_no_srs: You need to use SRS to play on this server!
  enforce_srs: true   # Block slots until SRS is activated. People cannot use slots if not on SRS!
  move_to_spec: true  # Move people back to spectators if they leave SRS (only if enforce is true, default: false)
  enforce_atc: true   # Optional: Enforce ATC frequencies for SRS users (default: false)
  atc_frequencies:    # Optional: default is airbase frequencies, according to the mission
    blue:
      'Airbase': [30000FM, 252000AM]
      'Carrier': 251000AM
      'FARP': 250000AM
      '*': 253000AM
    red:
      'Airbase': 126000AM
      'Carrier': 125000AM
      'FARP': 125500AM
      '*': 124000AM
  atc_frequency_range: [118000, 137000]  # Optional: only when atc_frequencies is not set for the airbase type, keep the airbase frequencies in this range (kHz), here VHF AM; all of them if none is
  atc_exempt_unit_types: [P-51D, SpitfireLFMkIX, Bf-109K-4]  # Optional: no ATC popup nor takeoff check for these unit types, e.g. aircraft with preset-only radios

Note

The enforce_atc option will create a "punish" event "no_atc_usage" on takeoffs without the ATC frequency dialed in, which can then be used in the Punishment plugin to punish based on violations:

penalties:  
  - event: no_atc_usage
    reason: No ATC usage
    action: move_to_spec
There will be no automated punishement if not configured.

TextToSpeech (TTS)

You can use TextToSpeech either from your missions or from Discord. The bot supports two solutions:

1) SRS-TTS Using SRS-TTS in a mission can cause some trouble, as you usually need to desanitize os and call an external program. This is no longer necessary if you use DCSServerBot. DCSSB decouples the TTS functionality from the mission and provides a more reliable and efficient way to handle TextToSpeech. 2) HoundTTS HoundTTS is an addon developed by Uri. It supports different TTS providers and hooks nicely into DCS. To install HoundTTS with DCSServerBot, you can enable it with /extension enable <HoundTTS>.

If DCSServerBot finds HoundTTS installed, it will automatically use it instead of SRS-TTS. To make sure your mission always uses the best available TTS implementation, you can use TTS like so:

if dcsbot then
    -- function dcsbot.send_tts(<message>, <frequency>, <coalition>, [volume], [point])
    dcsbot.send_tts("Hello World", "251.0", 2, 1.0)
end

Discord Commands

The following Discord commands are available through the SRS plugin:

Command Parameter Channel Role Description
/srs list all DCS Shows active users on SRS with their connected radios.
/srs tts server text [player] [coalition] \<frequency> all DCS Admin Send a TTS message to a specific frequency. Chose coalition or player to limit the frequencies.
/srs update server all DCS Admin Updates SRS on the respective node.
/srs repair server all DCS Admin Repairs (re-installs) SRS on the respective node.

Mission-Scripting - Text To Speech

If you want to use TTS (text-to-speech) in your mission, you can do it like so:

if dcsbot then
    local message = "Test"
    local frequency = 243.0
    local coalition = 1 -- red
    local volume = 1.0
    local point = Airbase.getByName("Kutaisi"):getPoint()  -- if LOS is enabled
    dcsbot.send_tts(message, frequency, coalition, volume, point)
end    


Configuration reference

Key Type Description Example
DEFAULT map Applies to every instance.
commands
chat_commands

DEFAULT

Key Type Description Example
DEFAULT.message_no_srs str Message shown to players that do not use SRS. (range: min 1) You need to use SRS to play on this server!
DEFAULT.enforce_srs bool Block slots until the player has SRS activated. true
DEFAULT.move_to_spec bool Move players back to spectators when they leave SRS. true
DEFAULT.enforce_atc bool Enforce ATC frequencies and raise no_atc_usage events. true
DEFAULT.atc_frequencies map Per-coalition ATC frequencies used when enforce_atc is on. blue:
'Airbase': [30000FM, 252000AM]
'Carrier': 251000AM
'FARP': 250000AM
'*': 253000AM
DEFAULT.atc_frequencies.<(blue\|red)> map
DEFAULT.atc_frequencies.<(blue\|red)>.<(Airbase\|Carrier\|FARP\|\*)> any
DEFAULT.atc_frequency_range list Keep only the airbase frequencies in this range (kHz) when atc_frequencies has no entry for the airbase type. (range: min 2, max 2) [118000, 137000]
DEFAULT.atc_exempt_unit_types list Unit types with neither the ATC popup nor the takeoff check, e.g. aircraft with preset-only radios. [P-51D, SpitfireLFMkIX]

<(.+)>

Key Type Description Example
<(.+)> any (one of: element_schema, instance_schema)