modified: bot.py

bot.py

@@ -2222,8 +2222,10 @@ async def modhelp(ctx):
         name="👮 Moderator Commands (Level 5+)",
         value=(
             "`/warn <user> <reason> [message_id]` - Warn a user (with optional message reference)\n"
-            "`/mute <user> <duration> [reason]` - Mute a user temporarily\n"
-            "`/unmute <user>` - Manually unmute a user\n"
+            "`/mute <user> <duration> [reason] [message_id]` - Mute a user temporarily\n"
+            "`/unmute <user>` - Manually unmute a user (deactivates all active mutes)\n"
+            "`/viewmute <id_or_uuid>` - View detailed mute information by ID or UUID\n"
+            "`/listmutes [status]` - List mutes (active, completed, expired, cancelled, all)\n"
             "`/modinfo [user]` - View comprehensive user information\n"
             "`/viewwarn <warning_id>` - View detailed warning information\n"
             "`/removewarn <warning_id>` - Deactivate a warning (Level 6+)\n"
@@ -2265,6 +2267,21 @@ async def modhelp(ctx):
             inline=False
         )
     
+    # Mute System Features
+    embed.add_field(
+        name="🔇 Advanced Mute System",
+        value=(
+            "• **Persistent Records**: All mutes saved permanently in database\n"
+            "• **Message Context**: Referenced messages archived with full context\n"
+            "• **Auto-Unmute**: Automatic role restoration when mute expires\n"
+            "• **Mute IDs**: Easy-to-use numeric IDs for tracking (e.g. `/viewmute 123`)\n"
+            "• **Multiple Mutes**: Can handle multiple active mutes per user\n"
+            "• **Smart Notifications**: Auto-unmute alerts sent to mod log channel\n"
+            "• **Role Restoration**: Automatically restores previous roles after mute"
+        ),
+        inline=False
+    )
+    
     # Moderation Configuration Help
     embed.add_field(
         name="⚙️ Moderation Configuration",
@@ -2272,20 +2289,24 @@ async def modhelp(ctx):
             "Use `/modconfig` without parameters to see current settings.\n"
             "Available settings: mute_role, mute_role_name, auto_create_mute_role,\n"
             "max_warn_threshold, auto_mute_on_warns, auto_mute_duration,\n"
-            "log_channel, mod_log_enabled"
+            "mod_log_channel_id, mod_log_enabled"
         ),
         inline=False
     )
     
-    # Duration Formats
+    # Duration Formats and Examples
     embed.add_field(
-        name="⏱️ Command Examples",
+        name="⏱️ Command Examples & Formats",
         value=(
             "**Mute duration formats:**\n"
             "`10m` = 10 minutes, `1h` = 1 hour, `2d` = 2 days\n\n"
-            "**Warning with message reference:**\n"
-            "`/warn @user Bad language 1234567890123456789`\n"
-            "The message will be saved even if deleted later."
+            "**Mute with message reference:**\n"
+            "`/mute @user 1h Spam 1234567890123456789`\n"
+            "Saves message content and context automatically.\n\n"
+            "**View mute details:**\n"
+            "`/viewmute 123` (by Mute ID) or `/viewmute abc12345` (by UUID)\n\n"
+            "**List active mutes:**\n"
+            "`/listmutes active` - Shows all currently active mutes with IDs"
         ),
         inline=False
     )