Setup & Configuration
How do I find Role IDs and Channel IDs for the config?
How do I find Role IDs and Channel IDs for the config?
You need to enable Developer Mode in Discord.
- Go to Discord Settings > Advanced > Toggle Developer Mode on.
- Right-click any role, channel, or user, and click Copy Channel ID or Copy Role ID at the bottom of the menu.
I invited the bot, but I don't see /ticketpanel or /stats?
I invited the bot, but I don't see /ticketpanel or /stats?
Slash commands require specific scopes to register.
- Ensure you invited the bot with the
applications.commandsscope checked in the OAuth2 URL generator. - Kick the bot and re-invite it with the correct URL. Note: You can try pressing F5 but global slash commands can sometimes take up to an hour to sync across all Discord servers natively, though they usually appear instantly.
Functionality & Errors
The bot throws a MongoTimeoutException in the console and crashes.
The bot throws a MongoTimeoutException in the console and crashes.
This means the bot cannot reach your MongoDB database.
- Check your
config.ymlto ensure thedatabase.uriis formatted correctly. - If you are using MongoDB Atlas (Cloud), ensure you have whitelisted your server’s IP address (or set it to
0.0.0.0/0to allow all IPs) in the Network Access tab.
When a staff member claims a ticket, the channel doesn't lock down!
When a staff member claims a ticket, the channel doesn't lock down!
This is almost always a Discord role hierarchy or permission issue.
- Ensure
enableClaimRemoval: trueis set in your configuration for that category. - Ensure the Bot’s highest role is placed above the staff roles in your Discord Server Settings. The bot cannot remove permissions from roles that are higher than itself.
- Ensure the bot has the
Manage ChannelsandManage Rolespermissions butAdministratorpermission is recommended.
Why aren't the HTML transcripts generating a link?
Why aren't the HTML transcripts generating a link?
The bot uploads the generated HTML file directly to Discord’s CDN via the
logsChannelId specified in your config. If the bot does not have permission to Attach Files or Send Messages in that specific hidden log channel, the upload will fail, and no link can be generated. Check the channel permissions!