Skip to content

Plugin "Cloud"

With this plugin, the world of DCSServerBot gets even bigger!

When using DCSServerBot in your Discord and with your DCS servers, people gather lots of statistics. As people often not only fly in one community, they might want to see their statistics that they gathered in all communities in a single place.

That said, DCSServerBot offers the opportunity to use a cloud-based database system to upload aggregated statistics for every active user into the cloud. Users can use Discord commands to see their overall stats (/cloud statistics), like they are used to see with /statistics.

Note

I am happy to provide anybody that uses the bot access to the cloud service. The service comes free of charge, but without any liabilities or guarantees, you can use it or leave it. The system works most reliably with a token that you can get for free from me.

DGSA: Global Ban System

If you opt in to the cloud plugin and even have not opted in to the cloud statistics, you can still use the global ban system. We've put together a group consisting of the admins of the most popular DCS servers, and we monitor what's going on in the community. When we see someone crashing servers by hacking or any other really (really) bad stuff, we put them in the global banlist. Nobody that gets usually banned on a server for misbehavior will get onto the list. There are only the really bad guys on it.
If you opt in to this plugin, you already participate from that banlist. You can choose whether to ban DCS players and/or Discord users. Both are inactive as a default.

If you are a server admin of a large server and not part of DGSA, the "DCS Global Server Admins" yet, send me a DM.

Configuration

# config/plugins/cloud.yml
# ---------------------------------------
#   Cloud Plugin – configuration
# ---------------------------------------

# Use the minimal example as a starting point:
DEFAULT:
  banlist: both                     # Allowed: pvp | pve | both   (default: both)
  dcs-ban: true                     # Subscribe to global DCS bans   (default: false)
  discord-ban: true                 # Subscribe to global Discord bans  (default: false)
  watchlist_only: false             # Add to watchlist only (requires dcs-ban: true) (default: false)

  # Troubleshooter settings – can be omitted if you don't need them
  troublemakers:
    warn: true                      # Warn when a potential troublemaker joins (default: true)
    warn_threshold: 3               # Warn if banned on ≥3 other servers  (min: 3)
    kick: true                      # Kick if banned on ≥5 servers (default: false)
    kick_threshold: 5               # Kick if banned on ≥5 servers  (min: 3)
    message: "You are not welcome on this server."

  host: dcsserverbot-prod.herokuapp.com
  port: 443
  protocol: https
  use_proxy: true                   # Use the proxy from nodes.yaml if configured (default: true)

  register: true                    # Send anonymous stats to my cloud service (recommended)
  upload_errors: true               # Upload crash reports to the central DB (recommended)

  # OPTIONAL – Cloud token for telemetry
  # token: "<your-cloud-token>"
  #   Provide by me, please ask in a DM or on my Discord

The online registration helps me to better understand which installations are out there. There is no personal information sent to the cloud, and you can always see what is being sent (logs/dcssb-*.log) and disable it if you feel uncomfortable with it. I appreciate it if you send me that little bit of data, as it helps me (and you) in maintaining the solutions that are out in the wild.

Which data is being sent?

  • Number of bots (for general DCSSB stats)
  • Number of servers (for general DCSSB stats)
  • Names of your servers, privacy status (for /serverlist)
  • Number and name of your Discord Guild (for internal use, so that I can get hold of you if I see something happening)
  • DCSSB-Plugins in use (for general DCSSB stats)
  • DGSA-Status (for protection stats)
  • Node hardware (for general HW stats)
  • Bans (to see if people are banned across multiple servers, WIP)
  • Subscriptions only: Aggregated user statistics for your users (for /cloud statistics)

Also, DCSServerBot will send account mappings of users (Discord Account / DCS Account mapping) to the cloud. This will allow users to only link themselves once on all servers that are using a cloud token (limited due to security reasons).

Note

If you feel uncomfortable with any of the above information, please let me know. I am happy to explain all of them or discuss workarounds for you. There is nobody able to see this information in detail, only in an aggregated view without any link to you or your group in my Discord.

Discord Commands

Command Parameter Role Description
/cloud status Admin Status of the connection to the cloud service.
/cloud resync [@member / ucid] [linked_users] DCS Admin Resync all players (or this player / only linked users) with the cloud.
/cloud statistics [@member / ucid] DCS Display player cloud statistics (overall, per guild)
/serverlist name DCS Display the DCS server list.

Configuration reference

Key Type Description Example
DEFAULT map Section applied to all of your DCS servers. banlist: both
dcs-ban: true
host: dcsserverbot-prod.herokuapp.com
port: 443
protocol: https
commands
chat_commands

DEFAULT

Key Type Description Example
DEFAULT.banlist str Global ban list to subscribe to (PvP, PvE or both). (one of: pvp, pve, both) both
DEFAULT.dcs-ban bool Ban listed players from your DCS servers. true
DEFAULT.discord-ban bool Ban listed users from your Discord server. true
DEFAULT.watchlist_only bool Only put matching players on the watchlist. false
DEFAULT.host str Hostname of the cloud service. (range: min 1) dcsserverbot-prod.herokuapp.com
DEFAULT.port int Port of the cloud service. (range: min 80, max 65535) 443
DEFAULT.protocol str Protocol used to reach the cloud service. (one of: http, https) https
DEFAULT.use_proxy bool Route cloud traffic through the configured node proxy. true
DEFAULT.register bool Send anonymous usage statistics to the cloud service. true
DEFAULT.upload_errors bool Upload crash reports to the central database. true
DEFAULT.token str Cloud token for telemetry and statistics upload. (range: min 1) your-cloud-token
DEFAULT.troublemakers map Handling of players known from other servers. warn: true
warn_threshold: 3
kick: true
kick_threshold: 5
message: You are not welcome on this server.
DEFAULT.troublemakers.warn bool Warn when a known troublemaker joins the server. true
DEFAULT.troublemakers.warn_threshold int Other server bans needed to trigger a warning. (range: min 3) 3
DEFAULT.troublemakers.kick bool Kick players banned on too many other servers. false
DEFAULT.troublemakers.kick_threshold int Other server bans needed to trigger a kick. (range: min 3) 5
DEFAULT.troublemakers.message str Message shown to a joining troublemaker. (range: min 1) You are not welcome on this server.