commit, am too tired to add docs here

2026-01-25 09:09:07 +01:00
parent 32d63284c7
commit 1e3acf05d0
15 changed files with 3336 additions and 61 deletions
--- a/config/templates/guild-default.yml
+++ b/config/templates/guild-default.yml
@@ -0,0 +1,102 @@
+# Default Guild Configuration Template
+# Copy this file to config/guilds/guild-{GUILD_ID}.yml and customize
+
+# Guild Information
+guild_id: 123456789012345678  # Replace with your Discord server ID
+name: "My Discord Server"     # Replace with your server name
+owner_id: 987654321098765432  # Replace with owner's Discord user ID
+premium: false                # Set to true if you have premium features
+
+settings:
+  # General Settings
+  general:
+    prefix: "!"                # Command prefix (if keeping read-only commands)
+    locale: "en"              # Language code (en, es, fr, de, etc.)
+    
+  # Channel Configuration (Discord Channel IDs)
+  # Set to null to disable, or use actual channel IDs
+  channels:
+    log_channel_id: null           # General event logging
+    mod_log_channel_id: null       # Moderation action logging  
+    welcome_channel_id: null       # New member welcome messages
+    
+  # Role Configuration (Discord Role IDs)
+  roles:
+    mute_role_id: null            # Role for timed-out members
+    verified_role_id: null        # Role given after verification
+    mod_role_ids: []              # List of moderator role IDs
+    
+  # Moderation Settings
+  moderation:
+    automod_enabled: true         # Enable automatic moderation
+    anti_spam_enabled: true       # Enable anti-spam protection
+    link_filter_enabled: false    # Enable suspicious link filtering
+    
+    # Strike System - Actions taken when users reach strike thresholds
+    strike_actions:
+      "1":                        # At 1 strike
+        action: warn
+      "3":                        # At 3 strikes  
+        action: timeout
+        duration: 3600            # 1 hour timeout
+      "5":                        # At 5 strikes
+        action: kick
+      "7":                        # At 7 strikes
+        action: ban
+        
+  # Automatic Moderation Thresholds
+  automod:
+    # Message Rate Limiting
+    message_rate_limit: 5         # Max messages per time window
+    message_rate_window: 5        # Time window in seconds
+    duplicate_threshold: 3        # Duplicate messages to trigger action
+    
+    # Mention Spam Protection  
+    mention_limit: 5              # Max mentions per message
+    mention_rate_limit: 10        # Max mentions per time window
+    mention_rate_window: 60       # Mention time window in seconds
+    
+    # Scam Protection - Domains allowed to bypass scam detection
+    scam_allowlist:
+      - "discord.com"             # Example: Allow Discord links
+      - "github.com"              # Example: Allow GitHub links
+      # Add trusted domains here
+      
+  # AI-Powered Moderation
+  ai_moderation:
+    enabled: true                 # Enable AI content analysis
+    sensitivity: 80               # AI sensitivity (0-100, higher = stricter)
+    confidence_threshold: 0.7     # Minimum confidence to take action (0.0-1.0)
+    log_only: false               # Only log violations (true) or take action (false)
+    nsfw_detection_enabled: true  # Enable NSFW image detection
+    nsfw_only_filtering: false    # Only filter sexual content (true) vs all content (false)
+    
+  # Member Verification System
+  verification:
+    enabled: false                # Enable verification for new members
+    type: "button"                # Verification type: button, captcha, math, emoji
+
+# Configuration Notes:
+# 
+# NSFW-Only Filtering:
+#   false = Block all inappropriate content (sexual, violence, harassment, hate speech)
+#   true  = Only block sexual/nude content, allow violence and harassment
+#
+# AI Sensitivity Guide:
+#   0-30   = Very lenient (only extreme violations)
+#   31-50  = Lenient (clear violations)  
+#   51-70  = Balanced (moderate detection)
+#   71-85  = Strict (catches most issues)
+#   86-100 = Very strict (may have false positives)
+#
+# Verification Types:
+#   button = Simple button click (easiest)
+#   captcha = Text-based captcha entry
+#   math = Solve simple math problem
+#   emoji = Select correct emoji from options
+#
+# Strike Actions:
+#   warn = Send warning message
+#   timeout = Temporarily mute user (requires duration in seconds)
+#   kick = Remove user from server (can rejoin)
+#   ban = Permanently ban user from server