Ahriman: Tacticus Guild Raid Bot Help & Setup

Warhammer 40,000: Tacticus guilds have up to 30 players and fight cooperative Guild Raid bosses during each two-week season. Common through Epic tiers are the warm-up; Ahriman focuses on the Legendary and Mythic rotation where notifications matter most.

Each rotation set has one main boss and two flanking primes, which the game calls adjutants. Primes grant powerful buffs to the boss, so guilds strip those buffs by killing primes or pushing them down to strategy thresholds before committing tokens to the boss.

In Ahriman docs, Captain means the in-game Officer role. Captain+ means Leader, Co-Leader, or Captain.

Feature map: start with setup, tune boss notifications, add leaderboards, enable token alerts, browse Black Library replays, or jump to the command reference.

Code terms you may see in diagnostics: main, prime_left,prime_right, Legendary tier 4, and Mythic tier 5.

Notifications can be automatic or manual. /auto_setup creates or reuses Ahriman | … Discord roles, creates wildcard notification config, and lets members self-assign roles with /role. Manage Server and Manage Roles are only needed when roles must be created or repaired; reusable Ahriman roles skip that requirement.

Manual setup uses /set_notification to choose roles per target, toggle prime tracking, set HP kill thresholds, attach Discord message links, and enable custom-message-only mode. Custom-message-only means Ahriman sends only the linked custom message; without a linked message, that event is silent.

Event order is: prime available → prime defeated or threshold reached → boss available when tracked primes are cleared → boss defeated. The monitor runs roughly every five minutes, so notifications can arrive a few minutes after the in-game event.

• /notifications viewing is open to all linked members; editing requires Captain+.
• /cleanup_roles preserves shared roles used by other guilds on the same Discord server and requires Manage Server.
• combined_prime_notifications is on by default, sending one message when both primes die together.
• Use /preview season:N with pings suppressed and /test before a season starts.
• Wildcard config applies to every map/tier; map-and-tier-specific dashboard rows win when present.
• The dashboard prime-buff slider snaps thresholds to crystal modifier checkpoints.

Captain+ users can run /leaderboard to post one auto-updated embed per boss slot. Ahriman edits those messages only when content changes, keeping channels readable while preserving live damage rankings.

• Modes: best, all, avg_player, and avg_team.
• Partial kills are excluded from averages so failed cleanup hits do not skew results.
• Options include unique-team display, guild caps, boss entry counts from 1–10, prime entry counts from 1–5, guild name/tag display, and player exclusions.
• Multi-guild boards send join requests; the target guild's Captain+ users approve or reject with Accept / Decline buttons.

/token_alert configures personal DM reminders for Tacticus token pools. It uses your personal API key, not the guild API key. The key is encrypted at rest and can be removed any time from the command panel or dashboard.

• Pools: raid, bomb, arena, onslaught, and salvage run.
• Alerts can fire when a pool is capped, when it will cap in N minutes, or for each regenerated token where supported.
• Per-token regeneration alerts are available for raid, onslaught, and salvage run tokens.
• If Discord DMs fail repeatedly, Ahriman auto-disables delivery; re-enable it from the panel or dashboard after opening DMs.

The dashboard lives at ahriman.app/dashboard and uses Discord OAuth. Captain+ users can edit guild settings; linked members can view guild data and manage their own player/token settings.

• Onboarding — recommended setup path with guided steps.
• Rotation — current rotation plus four-season lookahead.
• Boss Tracking — wildcard rows, map/tier-specific rows, custom messages, and the prime-buff threshold slider.
• Token Alerts — personal key and DM alert configuration.
• Black Library — Replays, Compositions, Boss Matrix, Tags, and Server Setup.
• Guild Settings, Player, Help — server controls, player link, and this documentation.

Captain+ means in-game Leader, Co-Leader, or Captain. Beta replay browsing is global; strategy-library commands are enabled per server by the Ahriman team.

Beta — video strategy library features are enabled per server by the Ahriman team; ask in the Pants of Horus Discord.

• Seasons use one of five rotating configs; Ahriman can show up to four seasons of lookahead.
• The waiting phase covers Common through Epic; the rotation phase starts after the Epic gate and tracks Legendary and Mythic tiers only.
• Each set contains a main boss plus left and right primes. Primes grant buffs, so thresholds help guilds strip buffs without always killing the prime.
• Kill-threshold checkpoints are HP values where crystal modifier buffs change; the dashboard slider snaps to those meaningful points.
• The monitor polls about every five minutes, so expected notification latency is a few minutes.
• Event order: prime available → prime defeated/threshold reached → boss available → boss defeated.
• Specific map/tier notification config wins; wildcard rows are the fallback.
• Custom-message-only sends only the linked custom message; no link means no message for that event.

Permissions recap: in-game roles control Ahriman settings and edits; Discord Manage Server or Manage Roles is only needed for Discord role creation, repair, or cleanup.

Ask questions, share feedback, or request Black Library beta access in the Pants of Horus Discord.

If Ahriman saves your guild time, you can support development on Ko-Fi.