Moderation & Admin Tools

Admin Command Overview

M4T3 provides powerful administrative tools that require ManageGuild permissions or higher.

Basic Admin Commands

• /admin settings - Configure bot appearance and embed customization
• /admin coins - Manage user economy (add/remove/set balances)
• /admin purge - Bulk delete messages with advanced filtering
• /admin modlog - View detailed moderation action history

Automated Protection Systems

Anti-Spam Configuration (/admin antispam)

Dashboard Path: Settings → Anti-Spam

Key Features:

• Message Rate Limits: Prevent rapid message flooding
• Duplicate Detection: Catch copy-paste spam automatically
• Link Protection: Control external URL sharing
• Emoji Spam: Limit excessive emoji usage
• Custom Punishments: Escalating penalties (warn → mute → kick → ban)

Setup Process:

1. Access via web dashboard for visual configuration
2. Set message limits (e.g., 5 messages per 10 seconds)
3. Configure punishment escalation
4. Test with trusted users to ensure proper function

Auto-Moderation (/admin automod)

Purpose: Automatic content filtering and rule enforcement

Content Filters:

• Profanity Detection: Built-in bad word lists + custom additions
• NSFW Content: Automatic adult content detection
• Invite Links: Block Discord server advertisements
• Caps Lock: Prevent excessive capitalization
• Custom Regex: Advanced pattern matching for specific violations

Configuration Tips:

• Start with moderate settings, adjust based on server culture
• Use whitelist channels for staff discussions
• Regular review of auto-mod logs for false positives

User Management Tools

Blacklist Management

AI Blacklist (/admin blacklist ai):

• Block users from AI commands due to misuse
• Temporary or permanent restrictions
• Automatic violations trigger blacklist additions

Music Blacklist (/admin blacklist music):

• Restrict music bot access for disruptive users

Economy Administration

Coin Management (/admin coins):

• Add: Reward users for events or achievements
• Remove: Penalties for rule violations
• Set: Direct balance adjustments for special circumstances
• Bulk Operations: Manage multiple users simultaneously

Shop Administration (/admin shop):

• Create Items (/setup shop create): Add server-specific shop items
• Delete Items (/setup shop delete): Remove items from shop
• List Items (/setup shop list): View all shop items
• Toggle Items (/setup shop toggle): Enable/disable item availability
• Give Items (/setup shop give): Give items directly to users

Advanced Admin Features

Welcome System Management

Commands:

• /setup welcome setup - Configure new member greetings
• /setup welcome delete - Remove welcome messages

Dashboard Configuration:

• Rich Embed Builder: Visual message creation
• Variable System: Dynamic content (user mentions, server stats)
• Channel Selection: Choose welcome message destination

Birthday System

Setup (/admin birthday):

• Channel Configuration: Where birthday announcements appear
• Message Customization: Personalized birthday wishes
• Role Rewards: Special birthday roles with permissions
• Privacy Controls: User opt-out options

Social Media Integration

Configuration (/setup social setup):
Supported Platforms:

• Twitch stream notifications
• YouTube video announcements
• Twitter/X post notifications
• Instagram post updates
• Reddit subreddit monitoring
• Custom RSS feed tracking

Setup Per Platform:

1. Enable platform in web dashboard
2. Add account usernames/channel IDs
3. Configure notification channels
4. Customize announcement messages
5. Test with recent posts

Achievement System Administration

Achievement Management (/admin achievements)

Features:

• Settings Configuration: Enable/disable achievement categories
• Progress Reset: Clear user achievements for fresh starts
• Reward Management: Set custom rewards for unlocking achievements
• Statistics Tracking: Monitor server-wide achievement progress

Categories:

• Economy: Coin milestones, daily streak achievements
• Gaming: Win streaks, jackpots, game-specific goals
• Social: Message counts, voice time, community participation
• Milestones: Server anniversaries, member count goals

Best Practices for Server Management

Moderation Workflow

1. Setup Foundation: Anti-spam → Auto-mod → Welcome messages
2. Monitor Activity: Regular log reviews, user feedback
3. Adjust Settings: Fine-tune based on server behavior
4. Staff Training: Ensure moderators understand tools
5. Documentation: Keep record of rule changes and reasons

Economy Management

1. Balanced Rewards: Avoid inflation with reasonable daily amounts
2. Event Economics: Special rewards for server events
3. Regular Audits: Check for exploitation or cheating
4. Community Input: Adjust based on user feedback

Prevention Strategies

1. Proactive Rules: Clear, visible server guidelines
2. Escalation Paths: Graduated punishments prevent harsh penalties
3. Appeal Process: Fair system for contesting moderation actions
4. Regular Updates: Keep filters current with evolving language

Troubleshooting Admin Issues

Common Problems

• Commands Not Working: Check bot permissions and role hierarchy
• Filter False Positives: Review auto-mod settings, add exceptions
• Economy Exploits: Monitor logs, adjust rate limits
• Backup Failures: Verify permissions and storage space

Performance Optimization

Getting Help

• Built-in Documentation: Use /info help for command references
• Web Dashboard: Comprehensive tooltips and guides
• Community Support: Discord server for administrator discussions
• Priority Support: Available for premium subscribers

M4T3's admin tools provide everything needed to maintain a thriving, well-moderated community!