Skip to content

Extension "DCS-gRPC"

DCS-gRPC is a communication library, that is somehow similar to what DCSServerBot does already. It has some differences though and comes with some other tools. This said, you can use it alongside DCSServerBot without issues.

Configuration

You can use /extension enable <gRPC> to enable the extension. This will add an entry in your nodes.yaml like so:

# config/nodes.yaml
MyNode:
  # [...]
  instances:
    DCS.dcs_serverrelease:
      # [...]
      extensions:
        gRPC:
          enabled: true
          autoupdate: true      # auto-update DCS-gRPC to the latest version from GitHub
          port: 50051           # you can set any configuration parameter here, that will be replaced in your dcs-grpc.lua file.
          eval: false           # set this to true if you want to use the eval() function in your lua files. Default is false.

Tip

You can rename the gRPC extension in your server status embed by setting a "name" in the configuration like so:

extension:
  gRPC:
    name: MyFancyName  # Optional: default is "DCS-gRPC"


Configuration reference

Key Type Description Example
enabled bool Whether the DCS-gRPC extension is enabled. true
autoupdate bool Auto-update DCS-gRPC to the latest version from GitHub. true
name str Extension name shown in the server status embed. (range: min 1) DCS-gRPC
port int TCP port the DCS-gRPC server listens on. 50051
evalEnabled bool Allow the eval() function in mission scripts. Default is false. false
host str Host address the DCS-gRPC server binds to. (range: min 1) 127.0.0.1
debug bool Write DCS-gRPC debug output to the bot log. false
throughputLimit int Maximum gRPC throughput in bytes per second. 1048576
integrityCheckDisabled bool Disable the DCS-gRPC integrity check of mission files. false

tts.defaultProvider

Key Type Description Example
tts.defaultProvider str Default text-to-speech provider used by DCS-gRPC. (range: min 1) win

tts.provider.azure.key

Key Type Description Example
tts.provider.azure.key str Azure Speech subscription key for text-to-speech. (range: min 1) ***

tts.provider.azure.region

Key Type Description Example
tts.provider.azure.region str Azure region that hosts the Speech service. (range: min 1) westeurope

tts.provider.azure.defaultVoice

Key Type Description Example
tts.provider.azure.defaultVoice str Default Azure voice used for text-to-speech. (range: min 1) en-US-JennyNeural

tts.provider.aws.key

Key Type Description Example
tts.provider.aws.key str AWS access key for Amazon Polly text-to-speech. (range: min 1) ***

tts.provider.aws.region

Key Type Description Example
tts.provider.aws.region str AWS region that hosts the Polly service. (range: min 1) eu-west-1

tts.provider.aws.defaultVoice

Key Type Description Example
tts.provider.aws.defaultVoice str Default AWS Polly voice used for text-to-speech. (range: min 1) Joanna

tts.provider.gcloud.key

Key Type Description Example
tts.provider.gcloud.key str Google Cloud API key for text-to-speech. (range: min 1) ***

tts.provider.gcloud.defaultVoice

Key Type Description Example
tts.provider.gcloud.defaultVoice str Default Google Cloud voice used for text-to-speech. (range: min 1) en-US-Wavenet-D

tts.provider.win.defaultVoice

Key Type Description Example
tts.provider.win.defaultVoice str Default Windows SAPI voice used for text-to-speech. (range: min 1) Microsoft Hedda