Common issues
Infusion is not responding to commands
If Infusion isn’t responding to your commands, try these solutions:
Check bot status
- Verify that Infusion is online in your server’s member list.
- Check if Infusion’s status shows as “Online” (green indicator).
Verify permissions
- Ensure Infusion has the “View Channels” permission in the channel you’re using.
- Check that Infusion has “Send Messages” and “Use Application Commands” permissions.
Check command syntax
- Make sure you’re using slash commands (start with
/).
- Verify the command name is spelled correctly.
- Ensure all required parameters are provided.
Server issues
- Discord may be experiencing outages. Check Discord’s status page.
- Try using the command in a different channel.
- Wait a few minutes and try again.
Commands are showing errors
“Missing permissions” error
This means either you or Infusion lacks the required permissions.
Solution:
- Check if you have the necessary permissions for the command.
- Verify Infusion has the required permissions (e.g., “Kick Members” for
/kick).
- Ensure Infusion’s role is positioned above the roles it needs to manage.
“Invalid user” or “User not found” error
Solution:
- Make sure you’re mentioning the user correctly using
@username.
- Verify the user is still in the server.
- Try using the user’s ID instead of mentioning them.
“Invalid duration” error
Solution:
- Use proper duration format:
10s, 5m, 2h, 1d.
- Ensure the duration is within acceptable limits.
Moderation actions not working
Kicks or bans failing
Solution:
- Verify Infusion has “Kick Members” or “Ban Members” permissions.
- Check that Infusion’s role is higher than the target user’s highest role.
- Ensure you’re not trying to moderate a server owner or administrator.
Timeouts not applying
Solution:
- Confirm Infusion has “Timeout Members” permission.
- Verify the timeout duration is valid (maximum 28 days).
- Check that the user doesn’t have “Administrator” permission.
Messages not being deleted
Solution:
- Ensure Infusion has “Manage Messages” permission.
- Verify Infusion can access the channel where messages should be deleted.
- Note that messages older than 14 days cannot be bulk deleted due to Discord limitations.
Auto-moderation not working
Spam or links not being filtered
Solution:
- Verify auto-moderation is enabled:
/config automod <setting> enabled.
- Check that Infusion has “Manage Messages” permission.
- Ensure the channel isn’t excluded from auto-moderation.
- Verify moderators aren’t exempt from auto-moderation rules.
False positives
If auto-moderation is too aggressive:
Solution:
- Adjust sensitivity settings in the configuration.
- Add trusted roles to the exemption list.
- Whitelist specific channels where rules should be more lenient.
Logging issues
Logs not appearing
Solution:
- Verify the log channel is set:
/config modlog #channel.
- Ensure Infusion has “Send Messages” and “Embed Links” permissions in the log channel.
- Check that logging is enabled for the specific event type.
Incomplete log information
Solution:
- Grant Infusion “View Audit Log” permission for more detailed logs.
- Ensure Infusion has been in the server for the events you’re trying to log.
Welcome messages not sending
Solution:
- Verify welcome messages are enabled:
/config welcome enable.
- Check that the welcome channel is set:
/config welcome channel #channel.
- Ensure Infusion has “Send Messages” permission in the welcome channel.
- Verify the welcome message format is valid.
Role management issues
Cannot add or remove roles
Solution:
- Verify Infusion has “Manage Roles” permission.
- Ensure Infusion’s role is positioned higher than the role you’re trying to manage.
- Check that the role isn’t managed by an integration (bot roles, booster roles).
Auto-roles not being assigned
Solution:
- Verify auto-roles are configured:
/config autorole list.
- Ensure Infusion has “Manage Roles” permission.
- Check that Infusion’s role is higher than the auto-role.
- Verify the role still exists in the server.
Slow response times
Solution:
- Check your internet connection.
- Verify Discord’s API status.
- Try the command again after a few moments.
- If the issue persists, contact support.
Commands timing out
Solution:
- Avoid using commands that affect large numbers of users simultaneously.
- Break large operations into smaller batches.
- Wait between consecutive commands.
Configuration issues
Settings not saving
Solution:
- Ensure you have “Manage Server” or “Administrator” permission.
- Verify the command completed successfully (check for confirmation message).
- Use
/config view to verify the settings were applied.
Lost configuration
Solution:
- If you have a configuration backup, use
/config import to restore it.
- Reconfigure settings manually using the configuration commands.
- Contact support if you need assistance recovering settings.
Getting help
If you’re still experiencing issues after trying these solutions:
Check the documentation
Review the relevant documentation pages:
Join the support server
Get help from the Infusion team and community:
This command provides a link to join our support server.
Report a bug
If you’ve found a bug:
- Join the support server.
- Provide detailed information:
- What you were trying to do
- What happened instead
- Any error messages
- Steps to reproduce the issue
- Include screenshots if possible.
Feature requests
Have an idea for a new feature?
- Join the support server.
- Share your suggestion in the feedback channel.
- Explain the use case and how it would benefit users.
Discord limitations
Some issues are due to Discord’s API limitations:
- Messages older than 14 days cannot be bulk deleted.
- Maximum timeout duration is 28 days.
- Bots cannot moderate server owners.
- Bots cannot manage roles higher than their own highest role.
- Some actions require specific permissions that cannot be bypassed.
Keep Infusion’s role near the top of your role hierarchy to avoid permission issues.
