FAQ & Troubleshooting
Setup
The bot's slash commands don't appear
Commands are registered globally and can take up to an hour to propagate after the bot is added or updated. Also confirm the bot was invited with the applications.commands scope — without it, slash commands never show. Try fully reloading Discord (Ctrl/Cmd+R).
I didn't get a welcome DM when I added the bot
The bot DMs whoever invited it (or the server owner). If you have DMs from server members disabled, you won't receive it. You don't need the DM to get started — just run /setup-lfg-channel to set the bot up.
/setup-lfg-channel says a permission error while creating channels
The bot is missing a permission or its role is too low. See the two checks below.
Permissions
Voice channels aren't being created or members aren't moved
Almost always one of:
- Missing permission — the bot needs Manage Channels, Move Members, Connect, and Speak (Administrator covers all). See Permissions.
- Role too low — if the bot doesn't have Administrator, its role must be within the top 5 non-admin roles. Drag it up in Server Settings → Roles. This is the single most common cause, and it fails silently. See Role hierarchy.
The bot posts a warning in #lfg-reports when it detects a role-position problem.
A non-admin should be able to run /setup-lfg-channel
Go to Server Settings → Integrations → LFG Hub and grant that role/member access to the command, without giving full Administrator.
Features
Smart LFG Ping isn't pinging anyone
Check all of these:
- It's enabled for the server in the Groups Discovery step.
- Your server has fewer than 15,000 members (it's auto-disabled above that).
- The members you expect to be pinged are online, have opted into the game, played recently, and aren't muted.
- The 15-minute cooldown between pings hasn't just fired.
Smart DM Recommendations aren't sending
Recommendations rely on presence (seeing what members are playing), fire at most once every 8 hours per member, and skip anyone already in a voice channel. Members must also allow DMs from the server.
Scheduling a session is rejected
Sessions must be between now and 24 hours ahead. Past times and anything beyond a day out are rejected. Double-check the timezone you picked in the dropdown.
Empty voice channels are disappearing
That's intended — temporary squad channels are deleted once empty. If you want a channel that persists, use a permanent voice channel.
Still stuck?
Use /help or /feedback in Discord to reach the LFG Hub team — you can attach screenshots.