There are two ways to configure where battle results get posted — pick one.
One slash command that does everything:
- Creates a War-Helper Channels role (if missing)
- Creates the categories/channels for hero and titan results (reuses existing ones with matching names — safe to re-run)
- Locks those categories so only that role can see them
- Auto-wires all 6 routing types to the new channels
Requires Administrator. Asks for confirmation before making changes. There's a matching /teardownchannels to remove everything it created, if you ever need to reset and re-test.
/setupchannels createsPoint specific existing channels at specific outcomes yourself:
%setchannel <type> #channelChannel types:
| Type | Meaning |
|---|---|
hero_offence_win | Guild attacked & won |
hero_offence_loss | Guild attacked & lost |
hero_defence_win | Guild defended & won |
hero_defence_loss | Guild defended & lost |
titan_offence_win | Guild attacked (titan) — wins & losses |
titan_defence_win | Guild defended (titan) — wins & losses |
archive | Catch-all — anything without a specific channel set falls back here |
%setchannel hero_offence_win #hero-attack-winsRun %setchannel with no arguments to see everything currently configured. Requires Manage Channels permission.
Once channels are set (either way), submit battles by replying to a screenshot message and mentioning the bot with process/tprocess + offence/defence:
@WarHelperBot process offence Family vs XXX Feb 27
@WarHelperBot tprocess defence XXX vs Family Feb 27
Both Manual and Auto processing accept the same battle-report screenshots — this is what to capture.
%process
%tprocess- Checks your server's subscription is active first
- Downloads every image you attached — maximum 10 images per message, a Discord attachment limit
- Catches the wrong command — warns and skips if a hero screenshot is sent to
%tprocess(or a titan screenshot to%process) %processonly: counts detected heroes and requires a multiple of 5 (up to 30) — posts a debug overlay if that check fails
- Runs the classifier on every battle line found in the image
- Low-confidence or unrecognised heroes aren't saved to the archive automatically — instead the bot posts permanently to the archive channel with a ❌ reaction and tracks it as an Unsaved Battle. React ♻️ on that message any time to retry classification (e.g. after a retrain) — success swaps the ❌ for a ✅ and saves it; a failed retry just leaves it for another attempt later
- Clean results save to the archive and post right there in the channel you ran the command in
- More than one image → a summary embed at the end; your command message is deleted afterward
- Reply to someone else's message that has images attached, mentioning the bot:
@WarHelperBot process offence(ordefence, plus an optional note) — maximum 10 images per message, a Discord attachment limit - Needs at least one archive channel already configured (via
/setupchannels) - Posts a "⚙️ Processing" acknowledgment straight away
- Same wrong-command and hero-count checks as the prefix version
- Same classifier pipeline runs on every battle line
- Key difference: results are routed automatically to the correct hero/titan × offence/defence archive channel — not posted in the channel you replied in
- Same skip / unrecognised-hero / clean-result handling and saving as the prefix version
- Same multi-image summary embed; the message you replied to is left untouched
Quick personal processing in any channel — use %process/%tprocess. Building the guild's shared archive from screenshots posted anywhere — reply-and-mention with @WarHelperBot process/tprocess so results land straight in the right archive channel.
Tired of manually replying to images just to get results? Register your auto-channels once, and every screenshot posted there gets picked up and processed automatically — no command, no reply, no thinking about it.
Run /auto_channel once, admin-only.
Right in the registered channel — that's it, pure auto-magic from here.
Delivered straight to your output channels — zero effort after setup.
Lets an admin register up to 4 channels by type:
hero_offence_channelhero_defence_channeltitan_offence_channeltitan_defence_channel
Requires an active guild subscription and at least one output channel already configured via the legacy %setchannel. Once setup it shows a confirmation prompt, then saves the channel assignments (AutoChannel DB rows).
To remove these settings use:
/auto_channel clear=TrueWipes all auto-channel registrations for the server. Admin-only, hidden from non-admins in the picker.
Auto-channel processing needs somewhere to send its results — /auto_channel only works after your output channels are already configured with %setchannel. Get that sorted first, then run /auto_channel with all 4 channel types. Once both are in place, it just works.
If your guild's screenshots get relayed through another bot instead of posted by a human, that bot needs to be allowlisted before its posts will be picked up in auto-channels. Contact BigBoy (bot owner) directly and we'll whitelist it for you.
The actual detection/processing logic that watches these channels lives in battle_processing_cog.py (process_battle_images), which checks the AutoChannel and AutoChannelAllowedBot tables whenever a message with an image lands in a registered channel.
If anything isn't behaving as expected, reach out in our Discord support server and we'll help you sort it out.