Initial Setup
After the bot joins your server, configure it before using any features.
The /init Wizard
Run /init in any channel. You must have Administrator permission in Discord.
The wizard opens as a paginated embed with navigation buttons. It walks through:
- Role mappings — Assign your Discord roles to TrenchQuarters permission tiers (Command, S3, S4, S7, S8, Grunts)
- Channel selections — Map Discord channels to bot feature areas (operations, logistics, verification, etc.)
- Feature toggles — Enable or disable individual bot modules
The /init wizard is a Discord-native alternative to the Admin console. All the same settings are available through the web interface at Admin → Discord → Role Mappings, Admin → Discord → Channels, and Admin → Discord → Bot Features.
Syncing Members
The bot does not automatically import existing server members on join. Run /sync all (Administrator) immediately after setup to pull your current member list into the database.
/sync all
This creates user and member records for every non-bot account in the server. Subsequent syncs are run automatically every hour in the background.
To sync a single member on demand:
/sync member @username
Feature Toggles
In Admin → Discord → Bot Features, you can enable or disable each module independently:
| Feature | What it controls |
|---|---|
| Operations | Warning Orders and Full Orders posted from the web app |
| Training | Training event announcements |
| Logistics | /stockpile and /logirequest commands and the logi requests channel |
| Roster | Member sync and roster-related bot behaviour |
| Frontline Updates | Live war status published to the warUpdates channel |
All features are enabled by default.
Frontline Updates
When the Frontline Updates feature is enabled, the bot periodically publishes live war status (territory control, casualties, faction intel) to the channel mapped to warUpdates.
To test or force an immediate publish:
/sync frontline-updates
This command is for testing only and should not be used in normal operation.
Welcome Messages
In Admin → Discord → Bot Features, you can configure an automatic welcome embed that posts to the welcome channel whenever a new member joins the server:
- Enable/disable toggle
- Embed title and description (supports markdown)
- Thumbnail image URL
- Embed colour (colour picker)
The welcome message is posted by the bot and is separate from the persistent Bot Messages system.