AhrimanSign in to Dashboard

Ahriman — Setup Guide

Ahriman monitors your guild's raid bosses, tracks rotation cycles, and sends notifications to Discord when bosses become available or are defeated.

Prerequisites

  • The Ahriman bot must be invited to your Discord server. Invite Ahriman
  • You'll need your User ID from the Tacticus app (found at the bottom of the Settings screen).
  • A guild Leader, Co-Leader, or Captain will need a Guild API key from api.tacticusgame.com with Guild and Guild Raids access.
  • For automatic setup: the bot needs the Manage Roles permission, and the person running it needs Manage Server.

Quick Setup (4 Steps)

Step 1 — Register Your Player

Run /register in any channel and provide your in-game User ID. This is shown at the bottom of the Settings screen in Tacticus.

If your guild is already registered with Ahriman, you'll be linked automatically.

Step 2 — Register Your Guild

This only needs to happen once per guild. A guild Leader, Co-Leader, or Captain runs /register_guild with the guild's API key:

/register_guild api_key:YOUR_KEY_HERE

This fetches your guild data from the Tacticus API and links it to your Discord server. You can get an API key from api.tacticusgame.com with Guild and Guild Raids access enabled. After the guild is registered, new members only need to run /register — the bot checks which guild they belong to in-game and links them automatically.

Step 3 — Configure Guild Settings

Changing guild settings is restricted to in-game guild Leaders, Co-Leaders, and Captains.

Run /guild_settings to view your current settings. To update them, provide any combination of options:

/guild_settings channel:#raids send_message:True notify:True
  • channel — the Discord channel where notifications are sent.
  • send_message — enables or disables raid monitor messages entirely.
  • notify — enables or disables role mentions within those messages.

Alternatively, use /set_notification_channel in any channel or thread to quickly set it as the notification destination. This is the only way to target a thread, since /guild_settings only accepts standard text channels.

Step 4 — Set Up Boss Notifications

You have two options — pick whichever fits your Discord server better.

Automatic Setup

Run /auto_setup. This will:

  • Create Discord roles for every boss and both primes (named Ahriman | Boss Name).
  • Fill out the notification config with all primes tracked.
  • Register everything in the database so the bot starts sending notifications immediately.

Once set up, guild members can run /role to subscribe or unsubscribe from individual boss notification roles through a simple select menu.

If you ever want to remove your guild's setup, /cleanup_roles unlinks the managed roles from your guild's notification config. If other guilds on the same Discord server share those roles, the Discord roles themselves are preserved.

Requirements: You need the Discord Manage Server permission, and the bot needs Manage Roles.

Manual Setup

Run /set_notification followed by a boss name (autocomplete will help you find it). This opens an interactive editor where you can:

  • Assign roles to the main boss, left prime, and right prime individually.
  • Toggle tracking for each prime (tracked primes send defeated/available notifications).
  • Set HP thresholds for primes (notification fires when HP drops to or below this value).
  • Link custom messages by pasting a Discord message link (https://discord.com/channels/...). The message content will be displayed in the notification.

This approach gives you full control but requires configuring each boss separately. Only guild Leaders, Co-Leaders, and Captains can edit notification settings.

All Commands

/help

Show the setup guide and command list

/register

Register your in-game player with your User ID

/register_guild

Register your guild with an API key (once per guild)

Leader / Co-Leader / Captain

/guild_settings

View or update guild settings — notification channel, raid messages, role mentions

Leader / Co-Leader / Captain

/set_notification_channel

Set the current channel or thread as the notification target

Leader / Co-Leader / Captain

/auto_setup

Create notification roles for all bosses and enable tracking automatically

Manage Server (Discord)

/role

Subscribe or unsubscribe from boss notification roles

/cleanup_roles

Unlink Ahriman-managed roles from your guild. Shared Discord roles are only deleted if no other guild on the server uses them

Manage Server (Discord)

/set_notification

Open the interactive notification editor for a specific boss

Leader / Co-Leader / Captain

/notifications

Browse all configured boss notifications with pagination. Editing requires elevated role

Leader / Co-Leader / Captain to edit

/rotation

Show the current boss rotation. Use season (1–4) to preview upcoming rotations, and rarity to filter by tier

Web Dashboard

Everything above can also be configured through the web dashboard at ahriman.fly.dev/dashboard. Sign in with your Discord account.

  • Player — register or update your User ID, manage notification opt-in.
  • Setup — view guild info, update API key, toggle raid messages and role mentions.
  • Notifications — configure roles, tracking, thresholds, and custom messages for every boss. Switch between the current rotation view and all bosses.
  • Rotation — view the current season's boss rotation and preview up to 4 seasons ahead.

Guild Leaders, Co-Leaders, and Captains can edit settings. Other members can view them.

How Notifications Work

Ahriman's raid monitor runs on a regular cycle, checking each registered guild's raid state via the Tacticus API. When it detects a state change, it sends a notification to your configured channel:

  • Boss available — a new boss in the rotation becomes active.
  • Prime available — a tracked prime's HP drops to or below your configured threshold (or becomes available if threshold is 0).
  • Prime defeated — a tracked prime is killed (always sent, regardless of role configuration).
  • Boss defeated — the main boss is killed.

Role mentions are included only if notify is enabled in guild settings and roles are assigned to that boss/prime via /set_notification or /auto_setup.

Questions / Feedback / Feature Requests

Join the Pants of Horus Discord to ask questions, share feedback, or request new features.

Tips

  • Auto setup gets you going quickly — /auto_setup once and members self-manage with /role. Manual setup with /set_notification gives you full control over which bosses have roles and how each prime is tracked.
  • Custom messages: Create a message in any channel with your raid strategy, then right-click → Copy Message Link. Paste that link into the notification editor (via /set_notification or the dashboard). The bot will display the message content in its notification.
  • Threads: Use /set_notification_channel from within the thread. The /guild_settings channel: option only supports standard text channels.
  • Rotation preview: Use /rotation season:1 to see next season's expected bosses. Up to 4 seasons ahead. Add rarity:mythic or rarity:epic to filter.
  • Cleaning up: /cleanup_roles unlinks managed roles from your guild. If other guilds on the same server share those roles, the Discord roles are kept. Boss tracking config and custom notification roles are always preserved.
  • Multiple guilds, one server: Each guild runs /auto_setup separately. The second guild reuses existing Discord roles. Each guild keeps independent notification config.
  • Permissions: Configuring guild settings, registering your guild, and editing notifications requires an in-game leadership role (Leader, Co-Leader, or Captain). /auto_setup and /cleanup_roles require the Discord Manage Server permission instead, and the bot needs Manage Roles.