Welcome to the official ChatCop documentation. This detailed guide will thoroughly explain each feature, command, and configuration option available with ChatCop, ensuring you fully utilize its AI-driven moderation capabilities. 🚀 denotes ChatCop Boost (premium) commands.
ChatCop is a state-of-the-art Discord moderation bot designed to automatically detect and handle a wide range of harmful content including spam, toxic language, explicit threats, inappropriate embedded links, and poll manipulations. It also offers comprehensive manual moderation tools, empowering server moderators to efficiently manage their communities. Version 4 introduces significant improvements in user experience, moderation responsiveness, and provides greater configuration flexibility.
-
Invite ChatCop
- Begin by inviting ChatCop to your server via this invitation link.
- Ensure ChatCop has permissions to view and send messages in your selected logs channel.
-
Essential Configuration
- Set your moderation logs channel:
- Command:
/config logs_channel #moderation-logs
- Purpose: Defines the channel where moderation logs and flagged messages appear. This command automatically enables moderation.
- Activate moderation:
- Command:
/config enabled True
- Purpose: Turns on ChatCop’s moderation tools.
- Verify settings:
- Command:
/config view
- Purpose: Quickly display your current moderation configuration.
¶ 3. Detailed Command Reference
¶ 3.1 Configuration Commands (/config)
- Detailed Description: Specifies the channel where all moderation events, logs, and alerts will be posted. Running this again moves logging instantly to a new channel.
- Detailed Description: Controls whether automatic moderation is active. Turning it off pauses moderation without losing your configuration settings.
- Detailed Description: Provides a detailed summary of current settings, including logs channel, moderation status, threshold levels, and premium feature availability.
- Detailed Description: Adjust thresholds at which warnings are triggered for specific content types. Lower numbers result in more frequent warnings. Types include:
toxicity, severe_toxicity, identity_attack, insult, profanity, threat, spam, sexually_explicit, polls, embeds
- Values: From
0.0 (very sensitive) to 1.0 (disabled).
- Detailed Description: Sets automatic deletion thresholds. Messages exceeding these scores are removed instantly, keeping your community safe.
- Detailed Description: Customize the message users receive when their content is deleted. Supports placeholders for user names and reasons.
- Detailed Description: Controls where deletion notices are sent, allowing flexibility in transparency and discretion.
- Detailed Description: Enables or disables moderation action buttons (timeout and kick) within log entries, ideal for managing moderation workflows.
- Detailed Description: Exempts a specified role (such as moderators or VIPs) from automatic moderation checks.
- Detailed Description: Enables or disables moderator notifications whenever ChatCop takes action, ensuring immediate awareness.
- Detailed Description: Defines the specific role to be pinged by the
ping_mods command, ensuring the right moderators are alerted promptly.
- Detailed Description: Automatically applies a 15-minute timeout to repeat offenders, enhancing server safety without constant manual oversight.
¶ 3.2 Moderation Commands
- Detailed Description: Provides a comprehensive list of commands, each with clear descriptions and usage examples to guide moderators effectively.
- Detailed Description: Quick-action buttons (Accept, Delete, Timeout, Kick) appear within each moderation log entry, allowing moderators instant, efficient management of flagged content.
- Detailed Description: Retrieves moderation history for a specified user. Without Boost, the history covers the past 7 days. Boost users have unlimited access and can filter specifically by deleted messages or timeouts.
¶ 3.3 Subscription Commands (/subscribe)
- Detailed Description: Displays current subscription status, details on ChatCop Boost features, pricing, and instructions for subscribing, upgrading, or cancelling.
- Limited moderation history (last 7 days)
- Daily moderation limit (100–500 messages)
- Complete access to threshold customization
- Comprehensive help command
- Unlimited moderation history and message processing
- Advanced customization of deletion messages and notification settings
- Role-based moderation exemptions
- Moderator notification system and button visibility controls
- Automatic timeout for repeated infractions
- Moderation of embedded links and poll content
- Priority customer support
¶ 5. Support and Feedback
- Discord Community: Join here to engage with other users, report issues, or suggest features.
- Email Support: hello@nicebots.xyz for detailed inquiries or private support.