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

Konfiguruj kanały, twórz hunty, zarządzaj slotami i przypisaniami.

Team Hunt — Konfiguracja i zarządzanie

/th_setup

Server admin

Skonfiguruj ustawienia TH: kanały, role, świat, przypomnienia.

/th_setup [organizer_channel] [changelog_channel] [archive_channel] [dashboard_channel] [runs_forum_channel] [moderator_role] [default_world] [allow_custom_world] [enforce_world] [enforce_vocation_match] [default_reminders] [clear_*]

Uruchom raz per serwer. Użyj clear_ żeby zresetować ustawienia.

/setup_server

Server admin

Stwórz pełną strukturę kanałów gildii Tibia (kategorie + kanały).

/setup_server [preset]

Jednorazowa konfiguracja. Tworzy ~15 kanałów w kategoriach.

/createteamhunt

Server adminOrganizer

Utwórz nowy Team Hunt z miejscem, czasem i opcjonalnymi przypomnieniami.

/createteamhunt [spot_name] [start_day] [start_time] [end_time] [note] [reminders]

Format przypomnień: 120,30,15 (minuty przed startem).

/th_list

Everyone

Lista ostatnich Team Huntów ze statusem, slotami i linkami.

/th_list [status]

Filtruj po statusie: open, closed, archived.

/th_edit

Server adminOrganizer

Edytuj szczegóły hunta: miejsce, czas start/koniec, przypomnienia.

/th_edit [hunt_id] [spot] [start] [end] [reminders] [clear_reminder_override]

Format daty: DD.MM.RRRR HH:MM.

/th_note

Server adminOrganizer

Zaktualizuj lub wyczyść notatkę organizatora dla hunta.

/th_note [hunt_id] [note] [clear]

/th_assign

Server adminOrganizer

Przypisz użytkownika Discord do slotu wokacji.

/th_assign [hunt_id] [slot] [user]

Sloty: Knight, Druid, Sorcerer, Paladin, Monk.

/th_assign_guest

Server adminOrganizer

Przypisz gościa (spoza Discorda) do slotu po nicku.

/th_assign_guest [hunt_id] [profession] [nickname] [level] [level_plus]

Gość wyświetla się w dashboardzie z oznaczeniem.

/th_convert_guest

Server adminOrganizer

Zamień slot gościa na użytkownika Discord.

/th_convert_guest [hunt_id] [profession] [user]

/th_dashboard_refresh

Server admin

Wymuś odświeżenie wiadomości dashboard.

/th_dashboard_refresh

/th_rules

Everyone

Wyświetl zasady Team Hunt na czacie.

/th_rules

/th_stats

Everyone

Statystyki społeczności: ile huntów, popularne spoty, aktywni gracze.

/th_stats [range]

Zakresy: 7d, 30d, all.

/th_register_character

Everyone

Zarejestruj swoją postać Tibia i połącz z Discordem.

/th_register_character [character]

Podkomendy: set (główna), link, remove.

Śledź postacie, monitoruj status online, levele, śmierci i oś czasu.

Postacie i śledzenie

/track

Everyone

Zarządzaj śledzeniem postaci na serwerze.

/track <subcommand>

Podkomendy: add, remove, whois, online, list.

/online

Everyone

Pokaż kto z gildii jest teraz online w Tibii.

/online

/levels

Everyone

Historia level upów na serwerze lub konkretnej postaci.

/levels <subcommand>

Podkomendy: serwer (ostatnie 15), postac (historia postaci).

/deaths_ext

Everyone

Rozszerzone statystyki śmierci: po potworze, graczu, zbiorcze.

/deaths_ext <subcommand>

Podkomendy: monster, stats, user.

/timeline

Everyone

Oś czasu wydarzeń: level-upy i śmierci.

/timeline <subcommand>

Podkomendy: all (serwer), character, user.

/search_team

Everyone

Znajdź graczy w share range do wspólnego polowania.

/search_team <subcommand>

Podkomendy: by_level, by_range, by_character.

/search_world

Everyone

Szukaj online graczy na świecie Tibia po poziomie.

/search_world <subcommand>

Podkomendy: by_level, by_range.

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.