05 · 🩺

Troubleshooting & FAQ

Resolve stuck commands, permission gaps, or stale dashboards.

A production readiness checklist covering intents, roles, billing sync, and Discord quirks.

Issue

Slash commands never show up

Signal: Discord reports "The application did not respond" or the command list is empty.

Fix: Re-run /th_setup, ensure the bot is invited to the target server, and confirm command scopes include applications.commands. Re-register via the dashboard if needed.

Issue

Assignments fail with missing permissions

Signal: You see "I am missing Send Messages" or similar errors.

Fix: Move the bot role above the organizer role, and check that the channel overrides allow Send Messages, Manage Messages, and Embed Links.

Issue

Dashboard shows stale hunts

Signal: Web app still lists old hunts or billing state after changes.

Fix: Use /th_dashboard_refresh, then reload the dashboard. If the issue persists, verify the billing token environment variable on the bot host.

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.

What languages are supported in the UI?

+
Docs ship in English and Polish. The bot responses respect the locale you select inside /th_setup.