Operator handbook

Everything you need to run HuntMaster with confidence.

Slash command reference, launch checklist, permissions, billing, and production runbooks—kept in sync with the live bot.

Use these docs when inviting the bot, running your first hunt, or troubleshooting intents. Every section mirrors what ships to Discord today.

01 · 🚀

Quick start

Invite the bot, configure channels, and create your first hunt in under ten minutes.

Full checklist
  1. Step 01

    Invite HuntMaster with full intents

    Use the dashboard invite link with Manage Server, Manage Roles, Manage Channels, and Read Message History.

    Requires Discord admin rights.

  2. Step 02/th_setup

    Run /th_setup in your organizer channel

    Pick the command channel, set the optional moderator role, and confirm timezone + language.

  3. Step 03

    Verify permissions

    Ensure the bot rank sits above target roles, and that the organizer channel allows View + Send Messages.

    Match Discord channel overrides with the plan in /th_setup.

  4. Step 04

    Start the dashboard trial

    Visit app.huntmasterbot.com, authenticate with Discord, and launch the 7-day premium trial.

    One trial per guild.

  5. Step 05/createteamhunt

    Create the first hunt

    Use /createteamhunt, announce slots, and monitor assignments via /th_list or the dashboard.

02 · ⌨️

Command reference

Every slash command with syntax, permissions, and real-world tips.

View all commands

Confirm the bot is configured correctly before a raid or event.

Provisioning & health

/th_setup

Server admin

Configure organizer, changelog/archive/dashboard channels and optional moderator role.

/th_setup organizer_channel:<channel> [changelog_channel:<channel>] [archive_channel:<channel>] [dashboard_channel:<channel>] [moderator_role:<role>] [clear_*:<true|false>]

Run once per guild or whenever your channel plan changes.

/th_dashboard_refresh

Server admin

Force-sync hunts and billing state to the web dashboard.

/th_dashboard_refresh

Use after Discord outages or Stripe updates.

Create, list, and update hunts without leaving Discord.

Hunt lifecycle

/createteamhunt

Server adminOrganizer

Create a Team Hunt in the configured organizer channel.

/createteamhunt spot_name:<text> start_day:<day> start_time:<HH:MM> end_time:<HH:MM> [note:<text>]

Uses the same lifecycle shown in the dashboard.

/th_list

Everyone

Display active hunts along with slot status and notes.

/th_list

Use in a read-only channel for transparency.

/th_edit

Server adminOrganizer

Edit Team Hunt details (spot, note, start, end).

/th_edit hunt_id:<uuid> [spot:<text>] [note:<text>] [start:<DD.MM.YYYY HH:MM>] [end:<DD.MM.YYYY HH:MM>]

Supports quick production updates without recreating the hunt.

/th_note

Server adminOrganizer

Update or clear organizer note for a Team Hunt.

/th_note hunt_id:<uuid> [note:<text>] [clear:<true|false>]

Notes sync back to the dashboard instantly.

03 · 🛡️

Roles & permissions

See what admins, organizers, and members can do inside the bot.

Open matrix

Capabilities by role

CapabilityAdminOrganizerMember
Run /th_setup and update core settingsFull accessView-only confirmationNot available
Refresh dashboard data (/th_dashboard_refresh)Full accessNot availableNot available
Create or edit huntsFull accessFull accessView-only
Assign players or guestsFull accessFull access when role was granted in /th_setupCannot assign
Post /th_rules and list huntsFull accessFull accessAllowed in approved channels
Billing portal + overridesRequires dashboard login + billing owner rightsNeed explicit billing overrideNot available
  • Admin = Discord server owner or user with Manage Server.
  • Organizer = role selected during /th_setup.
  • Member = any guild member with slash command access.

FAQ · 🩺

Troubleshooting & FAQ

Resolve stuck commands, permission gaps, or stale dashboards.

Troubleshooting playbook

Does the bot need message content intent?

+
No. HuntMaster runs entirely on slash commands plus scheduled webhooks. You only need the standard default intents shown during the invite flow.

Where do I download invoices?

+
Head to app.huntmasterbot.com, open the billing tab, and use the Stripe customer portal link to download PDF invoices or update payment methods.