Report¶
The report command provides a safe and anonymous way for community members to alert server moderators to potential rule violations, harassment, or other issues.
Unlike public reports, this command opens a private interface that only the reporter sees, and the final report is sent to a private moderation channel.
Syntax¶
The report command is available only as a Slash Command to ensure user privacy and support the interactive modal interface.
Slash Command:
/report
How It Works¶
When you run /report, Tux will open a pop-up window (modal) with several fields for you to fill out:
- Subject: A brief title for your report.
- User(s) Involved: The name or ID of the user(s) you are reporting.
- Details: A thorough description of the incident or behavior.
- Evidence: Links to message IDs, screenshots (uploaded elsewhere), or other proof.
Once you submit the modal, Tux will:
- Validate that all required information is present.
- Format your report into an embed.
- Post the report into the server's designated Mod Log or Report Channel.
- Send you a private confirmation that your report was received.
Permissions¶
Bot Permissions¶
Tux requires the following permissions:
- Send Messages - In the designated report/log channel.
- Embed Links - To format the report for moderators.
User Permissions¶
This command is typically available to all server members by default.
Permission System
Server administrators can restrict who can use the report command via Tux's dynamic permission system. Configure via /config commands.
Usage Examples¶
Starting a Report¶
/report
This will immediately open the report interface on your screen.
Response¶
Upon successful submission, you will receive an ephemeral message:
"Thank you for the report! It has been sent to the moderation team."
Your name is included in the report sent to moderators, but it is not visible to the user you are reporting or anyone else in the public channels.
Error Handling¶
Common Errors¶
Error: Modal Failed to Open¶
When it occurs: You run the command but nothing happens, or an error says the interaction failed.
Solution: Ensure you are using a modern Discord client that supports modals. Try restarting your Discord app or running the command again.
Error: Report Channel Not Found¶
When it occurs: The bot attempt to post the report but the server's designated report/log channel has not been configured.
Solution: Contact a server administrator to ensure the moderation log channel is set correctly in Tux's configuration.
Related Documentation¶
- Moderation Module
- Configuration Guide - Learn how to set up the report channel.