Documentation

Permissions Guide

Understanding Discord permissions for HawkWatch - the minimal permissions needed for Roblox game tracking.

Last updated:

HawkWatch’s Minimal Permission Philosophy

HawkWatch is designed with peace of mind - it only requests the bare minimum permissions needed to track Roblox games and send notifications. No admin powers, no unnecessary access.

Required Permissions

Based on the official Discord invite, HawkWatch needs exactly these permissions:

✅ Essential Permissions

  • View Channels - See notification channels where updates are sent
  • Send Messages - Post Roblox game update notifications
  • Send Messages in Threads - Send notifications in thread discussions
  • Embed Links - Display rich game update embeds with thumbnails
  • Use Slash Commands - Execute commands like /watch, /list, /help

❌ What HawkWatch Does NOT Need

  • Read Message History - Doesn’t monitor Discord chat
  • Manage Messages - Doesn’t edit or delete messages
  • Administrator - Never needs full server access
  • Manage Channels/Roles - Only sends notifications

Automatic Setup

✅ Recommended: Use the official HawkWatch invite link

  • All permissions are pre-configured
  • No manual setup required
  • Just authorize and you’re done!

🧪 Test it works: After setup, try /list watched post: True in your notification channel - this posts a test embed message to confirm permissions are working.

Why Users Sometimes Have Permission Issues

Since HawkWatch uses minimal permissions, users sometimes accidentally revoke a permission the bot actually needs:

Common Accidents

  • ❌ Disabling “Send Messages” in notification channels
  • ❌ Removing “Embed Links” (breaks rich notifications)
  • ❌ Blocking “View Channels” (bot can’t see where to send updates)
  • ❌ Turning off “Use Slash Commands” (commands disappear)

Quick Fix

If something stops working, check that HawkWatch still has all 5 essential permissions listed above.

Who Can Use HawkWatch Commands

✅ Can use commands:

  • Server Owner
  • Users with Administrator permission
  • Users with roles named “admin” or “mod”

❌ Cannot use commands:

  • Regular server members

This restriction prevents unauthorized users from adding game tracking that affects the whole server.

Need Help?

If you’re having permission issues:

  1. Check: Permission Error Troubleshooting
  2. Test: Try /help to see if basic functionality works
  3. Contact: Get Support if problems persist

Remember: HawkWatch’s minimal permissions keep your server secure while still providing powerful Roblox game tracking! 🎮