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 |