Lyra-Trinity

Lyra-Trinity Moderation Bot

Advanced multi-server moderation bot with smart spam detection, auto-forwarding, and graduated punishment system.

✨ Core Features

🔍 Smart Spam Detection: Identifies duplicate messages posted across channels 🎵 SUNO Auto-Forward: Automatically moves SUNO songs to designated channels 🔗 Discord Invite Blocking: Prevents unauthorized server advertising (toggleable) 📨 Forward Spam Protection: Limits message forwarding to prevent spam ⚡ Command Protection: Bot commands (! or /) bypass spam detection 📊 5-Step Violation System: Graduated punishments with multiple warnings ⏰ Configurable Timeouts: Customizable timeout durations per server 🛡️ Admin Immunity: Admins get warnings but bypass timeouts/bans 🎛️ Granular Control: Extensive configuration for each server 📈 Detailed Analytics: Track violations and server statistics 🔧 Multi-Server: Independent settings per Discord server

🎵 SUNO Auto-Forward (NEW!)

Keep your channels organized by automatically moving SUNO song links to dedicated channels:

• Auto-Detection: Recognizes suno.com URLs instantly
• Smart Forwarding: Moves posts with original author attribution
• Friendly Notifications: Users receive DMs explaining the move
• No Penalties: Pure organization - no spam violations applied
• Per-Channel Setup: Monitor multiple channels, each with different destinations

Example: Posts in #general containing SUNO links → automatically moved to #suno-songs

📊 5-Step Violation System

Violation	Action	Description
1st	⚠️ Warning	Message deleted + first warning sent
2nd	⚠️ Timeout Warning	Message deleted + timeout notice
3rd	⏰ Timeout	Message deleted + timeout applied (default: 1 hour)
4th	🚨 Final Warning	Message deleted + ban warning sent
5th	🔨 Ban	Message deleted + permanent ban

Admin Immunity: Administrators receive all warnings but are immune from timeouts/bans - perfect for testing!

🎛️ Admin Commands

All commands require Administrator permissions and use prefix !mod

Initial Setup

!mod support # Diagnostic & setup guide (run this first!) !mod config # View current server configuration

Configuration Commands

!mod timeout [duration] # Set timeout duration (e.g., 30m, 2h, 1d) !mod thresholds [timeout] [ban] # Set violation thresholds (e.g., 3 5) !mod channel #channel # Set notification channel for timeouts/bans !mod disable [feature] # Disable: ban, invites !mod enable [feature] # Enable: ban, invites !mod forward_role @role # Set role exempt from forward spam detection

SUNO Auto-Forward Commands

!mod auto_forward add #monitor #destination # Set up auto-forwarding !mod auto_forward remove #monitor # Remove auto-forwarding !mod auto_forward status # View current configuration

User Management

!mod status @user # Check user's violation status !mod reset @user # Clear all violations for a user !mod history @user # Show detailed violation history

System Management

!mod stats # View database statistics !mod cleanup # Manually trigger database cleanup

📖 Example Usage

!mod timeout 30m # Set 30-minute timeouts !mod thresholds 2 4 # Timeout at 2nd, ban at 4th violation !mod status @username # Check violation status !mod reset @username # Give clean slate !mod auto_forward add #general #suno-songs # Auto-move SUNO links !mod disable invites # Allow Discord invites !mod channel #mod-log # Send alerts to #mod-log

🚀 Quick Start

1. Invite the bot to your server
2. Run !mod support for setup diagnostics
3. Configure role hierarchy (bot role must be above user roles)
4. Customize thresholds and timeouts to your preference
5. Optional: Set up SUNO auto-forwarding with !mod auto_forward

🔒 Required Permissions

• Manage Messages (delete spam)
• Moderate Members (timeout users)
• Ban Members (ban repeat offenders)
• Send Messages (warnings/notifications)
• Embed Links (formatted messages)

💡 Pro Tips

• Use !mod support to validate bot permissions and role hierarchy
• Configure a dedicated #mod-log channel for timeout/ban notifications
• Set SUNO auto-forwarding to keep music channels organized
• Admins have complete immunity - great for testing settings
• Forward spam limit: Regular users can forward once, additional forwards trigger detection

🛡️ Privacy & Data

• All data stored locally per server
• Automatic cleanup of old messages (30 days) and violations (90 days)
• No data shared between servers
• Transparent violation tracking

---

Need Help? Use !mod support for live diagnostics and setup guidance!