Settings & Configuration
This page explains every setting on the plugin's Discord Triggers tab in ACT — what it does, what the defaults are, and when you'd want to change it. If you haven't set the bot up yet, start with the First-Time Setup Guide; come back here once the bot is online.
The settings are split across three pages, chosen from the list on the left of the plugin tab:
- General — connect the bot and put it in a voice channel.
- Sound — text-to-speech voice, volume, effects, and audio quality.
- Information — version, links, and the diagnostics log.
A Diagnostics panel sits across the bottom on every page (see The Diagnostics panel).
💾 When are settings saved? Your settings are written when you close ACT, and loaded again on the next start — so you only configure them once. The one exception is noted below: the Server / Channel you join is not remembered between sessions.
This page has two boxes: Discord Connection (logging the bot in) and Voice Channel (sending it into a channel).
The secret token that logs your bot in. You get this from the Discord Developer Portal — see Setup Step 4. The field is masked (shown as dots) and is saved between sessions, so you only paste it once.
🔒 Treat the token like a password. Anyone who has it controls your bot. Never share it or post it in screenshots. If it leaks, reset it in the Developer Portal and paste the new one here.
Connect logs the bot in with the token above. The bot should come online in your server within a few seconds. Once it's connected, the Server and Channel dropdowns fill in. You only need to click this once per ACT session.
A small status dot above the button reads Disconnected (red) or Connected (green) so you can tell the bot's state at a glance. Once the bot is online the button turns into Disconnect, which logs the bot out and takes it offline. (If it's in a voice channel, disconnecting also pulls it out.) Click Connect again whenever you want it back.
When ticked, the plugin logs the bot in automatically every time ACT starts, so you don't have to click Connect yourself. This setting is remembered. (It only logs the bot in — it does not auto-join a voice channel; you still press Join Channel when you're ready.)
The "Playing …" activity text shown under the bot's name in Discord's member list. Defaults to Playing with ACT Triggers. Purely cosmetic — set it to whatever you like, or clear it. Changes are pushed to Discord a few seconds after you stop typing, and the text is remembered between sessions.
The Discord server (guild) the bot should operate in. The dropdown lists every server the bot has been invited to. If it's empty, the bot either isn't connected yet or hasn't been invited to any server — see Common Questions & Issues.
The voice channel the bot will join. Only channels the bot has permission to View and Connect to are listed, so if a channel is missing, check the bot's role permissions on that server.
ℹ️ The Server and Channel you pick are not saved between sessions — you choose them each time you start ACT. Everything else on this page is remembered.
Join Channel sends the bot into the selected voice channel and starts routing your triggers to Discord. From that moment, any trigger that plays text-to-speech or a sound is played through the bot so everyone in the channel hears it.
Leave Channel pulls the bot out and stops routing triggers to Discord — TTS and sounds go back to playing only on your own PC, as they normally would. Leaving the channel does not log the bot out; you can re-join without reconnecting.
🎚️ Want some triggers to stay private (only you hear them) while others go to the party? That's controlled per-trigger in Triggernometry, not here — see How do I choose which triggers go to Discord?
This page controls how your triggers sound when the bot plays them. It has two boxes: Text-to-Speech and Effects & Leveling. All of these settings are remembered between sessions.
These settings apply to triggers that speak text (callouts read aloud). They do not affect triggers that play a .wav sound file.
The voice used to read out spoken triggers. The dropdown lists the text-to-speech voices installed on your Windows PC — the same voices ACT itself uses. To add more voices, install them through Windows Settings → Time & Language → Speech; they'll appear here after you restart ACT.
💾 The selected voice is remembered between sessions. If that voice is ever uninstalled (so it's no longer in the list), the plugin falls back to the first available voice.
How loud the spoken voice is, on a scale from 0 (silent) to the maximum, with the default sitting in the middle. Slide right for louder, left for quieter. This adjusts only the voice — sound-file triggers are unaffected.
How fast the voice talks. The middle is normal speed; slide left to slow it down and right to speed it up. Useful if callouts feel rushed or too sluggish during a fight.
These settings shape all trigger audio — both spoken text and sound files.
When ticked, the plugin randomly applies an audio effect to triggers as they play — things like echo, reverb, distortion, a pitch shift (chipmunk or demon voice), a muffled/"behind a wall" filter, and similar. The effect (and its exact strength) is chosen at random each time, so the same trigger won't sound identical twice. It's a fun, chaotic option for casual play — off by default. Not every trigger is affected; how often it happens is set by FX Chance below.
The probability that any given trigger gets a random effect, from 0% to 100% (default 25%). For example, at 25% roughly one in four triggers comes out with an effect and the rest play clean. This slider only matters when Random Sound FX is ticked.
On by default. Trigger sounds come from all over — some are recorded loud, others are very quiet — which normally means constantly reaching for the volume knob. With this on, the plugin adjusts each clip toward one consistent loudness, so spoken callouts and sound files all land at a similar level. It can quiet down sounds that are too loud and boost quiet ones (up to a safe limit), without letting anything distort. Leaving this on is recommended for most users.
Sets how loud that consistent level is. The slider runs from a louder target on the left to a quieter target on the right, with the default in between (shown as a value like -20 dBFS; a smaller number such as -12 is louder, a larger number such as -30 is quieter). Turn it up (left) if triggers feel too soft over voice chat, or down (right) if they're overpowering. This only has an effect while Auto-level Volume is on.
The audio bitrate the bot streams at — higher is clearer but uses more bandwidth:
| Option | Bitrate | Notes |
|---|---|---|
| Low | 48 kbps | Smallest bandwidth; fine for plain voice callouts. |
| Medium ⭐ | 96 kbps | Default. Good balance of clarity and bandwidth; works in any voice channel. |
| High | 128 kbps | Clearest, but needs a voice channel that supports 128 kbps. |
⚠️ High requires a boosted server. A normal Discord voice channel caps out around 96 kbps. If you pick High in a channel that doesn't support it, the plugin shows a red warning — it's harmless (Discord just delivers what the channel allows), but you won't actually get the higher quality unless the server is boosted to raise the channel's bitrate limit. Medium is the safe choice for everyone.
A reference page — nothing to configure here. It shows:
- The plugin name and version (handy when reporting a bug).
- Quick links to the project on GitHub, the issue tracker, and the First-Time Setup Guide.
- An Open log folder button that jumps straight to the diagnostics log (see below).
- A short legal disclaimer and credits.
The panel along the bottom of the plugin tab shows a live, timestamped log of what the plugin and bot are doing — connecting, joining channels, playing triggers, and any errors. You can select lines and press Ctrl+C to copy them.
For bug reports, though, the diagnostics log file is far more useful than copying from this panel. It's always on (nothing to enable) and merges the plugin and bot logs into one file:
-
ACT_DiscordTriggers-diagnostics.login your ACT data folder (%AppData%\Advanced Combat Tracker\). - The fastest way to find it: Information page → Open log folder.
Attach that file when you open an issue — it's the single most helpful thing you can include. More detail in Where are the logs?
| Setting | Page | Default | Saved between sessions? |
|---|---|---|---|
| Discord Bot Token | General | (empty) | ✅ |
| Auto Connect | General | Off | ✅ |
| Bot Status | General | Playing with ACT Triggers |
✅ |
| Server | General | — | ❌ pick each session |
| Channel | General | — | ❌ pick each session |
| TTS Voice | Sound | First installed voice | ✅ |
| TTS Volume | Sound | Middle | ✅ |
| TTS Speed | Sound | Normal | ✅ |
| Random Sound FX | Sound | Off | ✅ |
| FX Chance | Sound | 25% | ✅ |
| Auto-level Volume | Sound | On | ✅ |
| Auto-level Target | Sound | -20 dBFS | ✅ |
| Audio Quality | Sound | Medium (96 kbps) | ✅ |
- First-Time Setup Guide — create the bot, install the plugin, connect it.
- Common Questions & Issues — troubleshooting and FAQ.