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!

Lyra-Trinity

🛡️ Lyra-Trinity – Cross-channel spam killer. Server-wide protection + invite blocking control 🛡️

Stemmen voor Lyra-Trinity

Wil je ons ondersteunen?