Skip to content

Main reference

Main DCSServerBot configuration file. Defines Discord guild settings, validation mode, database connection, logging, filters, and enabled plugins.

Key Type Description Example
guild_id int (required) Discord guild/server ID where the bot is installed. 112233445566778899
guild_name str Human-readable Discord guild/server name. (range: min 1) My DCS Community
autoupdate bool Enables or disables automatic bot updates. false
use_dashboard bool Enables or disables dashboard support. true
chat_command_prefix str Single-character prefix used for legacy chat commands. (range: min 1, max 1) -
language str Default bot language. (one of: en, de, es, ru, cn) en
validation str Configuration validation mode. Use strict to fail on validation errors, lazy to warn, or none to disable validation. (one of: none, strict, lazy) lazy
database map Database connection and pooling configuration. url: postgresql://dcssb:SECRET@localhost:5432/dcssb?sslmode=prefer
pool_min: 2
pool_max: 10
max_reties: 3
max_idle: 300
logging map Logging configuration for the bot. loglevel: DEBUG
logrotate_count: 5
logrotate_size: 10485760
utc: true
filter map Optional default filters used to match servers, missions, or tags. server_name: Training
mission_name: Caucasus
tag: PvE
plugins list Required plugins loaded by the bot. - admin
- mission
- scheduler
opt_plugins list Optional plugins loaded when available. - music
- tacview

database

Key Type Description Example
database.url str (required) PostgreSQL connection URL. The password may be replaced with SECRET after being stored securely. (range: min 1) postgresql://dcssb:SECRET@localhost:5432/dcssb?sslmode=prefer
database.pool_min int Minimum number of database connections kept in the pool. (range: min 2) 2
database.pool_max int Maximum number of database connections allowed in the pool. (range: min 5) 10
database.max_reties int Maximum number of retry attempts for database operations. (range: min 1) 3
database.max_idle int Maximum idle time for database connections. (range: min 0) 300

logging

Key Type Description Example
logging.loglevel str Minimum log level written by the bot. (one of: DEBUG, INFO, WARNING, ERROR, FATAL) DEBUG
logging.logrotate_count int Number of rotated log files to keep. 5
logging.logrotate_size int Maximum log file size in bytes before rotation. 10485760
logging.utc bool Whether log timestamps should be written in UTC. true

filter

Key Type Description Example
filter.server_name str Server name filter. (range: min 1) Training
filter.mission_name str Mission name filter. (range: min 1) Caucasus
filter.tag str Server or mission tag filter. (range: min 1) PvE