Table of Contents

• Moderation System
• Basic Commands
• Mass Moderation
• Case Management
• Configuration
• Utility Commands
• Moderator Statistics

Moderation System

Lumière provides a comprehensive moderation toolkit with case tracking, automatic enforcement, strike systems, and detailed analytics. All moderation actions are logged with unique case IDs for accountability and appeals.

Core Features

Case Management

• Unique Case IDs: Every action gets a trackable case ID
• State Tracking: Cases are marked as OPEN or CLOSED
• Proof Attachments: Upload evidence for actions
• Moderator Visibility: Toggle whether moderators are shown in DMs

Permission Requirements

User Permissions

Commands require specific Discord permissions:

Bot Permissions

The bot needs matching permissions to execute actions:

• Moderate Members - For timeouts
• Kick Members - For kicks
• Ban Members - For bans
• Manage Messages - For message operations
• View Audit Log - For case management

Basic Commands

/warn

Issue a warning with optional duration and proof.

/warn user:@User reason:"Spam" duration:"30d" proof:<attachment> dm:true

Features:

• Generates unique case ID
• Tracks expiration automatically
• Checks for duplicate warnings (5min window)
• DM includes case details and proof
• Dispatches event for logging

Duration Format Examples:

/warns

View warnings for a user.

/warns user:@User all:false

Display includes:

• Case ID and status (OPEN/CLOSED)
• Expiration timestamp (relative time)
• Reason for each warning
• Total warning count

/pardon

Remove active warnings from a user.

/pardon user:@User reason:"Good behavior" all:false dm:true

Behavior:

• By default: Removes the most recent warning only
• With all:true: Shows confirmation for removing all warnings
• Updates case state to CLOSED
• Records who pardoned and when
• Dispatches moderation event

/mute

Apply a Discord timeout to a user.

/mute user:@User reason:"Spam" duration:"2h" dm:true

Features:

• Uses Discord's native timeout system
• Maximum duration: 28 days (Discord limit)
• Creates case with MUTE type
• Shows relative expiration time
• Automatic case closure on expiry

/unmute

Remove a timeout from a user.

/unmute user:@User reason:"Appeal approved" dm:true

Validation:

• Checks if user is actually timed out
• Prevents unmuting non-muted users
• Closes any open MUTE cases
• Records closure reason and timestamp

/kick

Remove a user from the server.

/kick user:@User reason:"Rule violations" dm:true

Features:

• Sends DM before kicking
• Creates case with KICK type
• Auto-closes case if user rejoins
• Dispatches "Un(Kick)" event on rejoin

Auto-Closure Logic: When a kicked user rejoins, Lumière automatically:

1. Finds the open KICK case
2. Updates status to CLOSED
3. Sets close reason: "User rejoined the server after kick"
4. Dispatches moderation event

/ban

Ban a user from the server.

/ban user:@User reason:"Harassment" duration:"7d" proof:<file> hack:false soft:false purge_days:1 dm:true

Ban Types:

Permanent Ban

/ban user:@User reason:"Severe rule break"

• No duration specified
• Requires manual unban
• Case stays OPEN until unban

Temporary Ban

/ban user:@User reason:"Cooldown needed" duration:"7d"

• Automatically schedules unban
• Case closes on expiration
• Shows relative expiration time

Soft Ban

/ban user:@User reason:"Message cleanup" soft:true purge_days:7

• Bans user immediately
• Deletes messages (up to 7 days)
• Unbans automatically after 1.5 seconds
• Closes case immediately
• Useful for mass message removal

Hack Ban

/ban user:123456789 reason:"Pre-emptive ban" hack:true

• Ban users not currently in server
• Requires user ID instead of mention
• Useful for ban lists from other servers

Message Purging:

• purge_days:0 - No messages deleted
• purge_days:1 - Delete last 24 hours
• purge_days:7 - Delete last 7 days (maximum)

/unban

Remove a ban from a user.

/unban user:@User reason:"Appeal approved" dm:true

Features:

• Verifies user is actually banned
• Closes any open BAN cases
• Generates new case if no open case exists
• Records unban reason and moderator
• Sends DM with case ID

Mass Moderation

All mass commands follow the same pattern and include confirmation prompts.

/mass warn

Warn multiple users at once.

/mass warn users:"@User1 @User2 @User3" reason:"Spam raid" duration:"7d" proof:<file> dm:true

Process:

1. Parses mentions and IDs
2. Shows confirmation with user list
3. Creates individual case for each user
4. Reports success/failure per user
5. Shows DM status for each

/mass pardon

Remove warnings from multiple users.

/mass pardon users:"@User1 @User2" reason:"False positive" all:false dm:true

Behavior:

• Single confirmation for all users
• Removes latest warning by default
• With all:true: Removes all warnings per user
• Reports closed case IDs per user

/mass mute

Timeout multiple users at once.

/mass mute users:"@User1 @User2 @User3" reason:"Raid prevention" duration:"1h" proof:<file> dm:true

Features:

• Confirmation with user list
• Individual case per user
• Skips users with higher roles
• Shows permission failures

/mass unmute

Remove timeouts from multiple users.

/mass unmute users:"@User1 @User2" reason:"Raid over" dm:true

Validation:

• Checks each user is actually muted
• Skips non-muted users with notice
• Closes open MUTE cases
• Reports individual status

/mass kick

Kick multiple users at once.

/mass kick users:"@User1 @User2" reason:"Raid participants" proof:<file> dm:true

/mass ban

Ban multiple users at once.

/mass ban users:"@User1 @User2 123456789" reason:"Coordinated raid" duration:"7d" proof:<file> hack:true soft:false purge_days:1 dm:true

Features:

• Supports mix of members and IDs (with hack:true)
• Individual case per user
• Schedules temporary unbans per user
• Reports bans and failures separately

Example for Raid:

/mass ban users:"@Raider1 @Raider2 @Raider3" reason:"Coordinated spam raid" soft:false purge_days:1

Example for Soft Ban (Cleanup):

/mass ban users:"@Spammer1 @Spammer2" reason:"Mass message cleanup" soft:true purge_days:7

/mass unban

Unban multiple users by ID.

/mass unban user_ids:"123456789 987654321" reason:"Ban wave reversed" dm:true

Features:

• Fetches users by ID
• Verifies each is actually banned
• Closes open BAN cases
• Shows success/failure per ID

Case Management

/case info

View detailed information about a case.

/case info case: e6cdDbPo

Information Displayed:

• Case ID, type, and status (OPEN/CLOSED/EXPIRED)
• Target user and reason
• Duration and expiration time
• Proof attachment link (if any)
• Closure information (who closed, when, why)

/case list

List moderation cases with optional filtering.

/case list user:@User user2:@OtherUser

Features:

• Shows up to 5 cases per page
• Sorts newest first
• Pagination for long lists
• Filters by user(s) if specified
• Shows case ID, type, status, moderator, reason, and time

/case delete

Delete a case or all cases.

/case delete case:"WRN-123" all:false

Safety Features:

• Requires confirmation before deletion
• Shows case details (if single case)
• Shows total count (if deleting all)
• Warns that deletion is irreversible
• Dispatches "Case Delete" event for logging

Configuration

/modvisibility

Toggle whether moderator names appear in moderation DMs.

/modvisibility visible:true

Warning Notification:

┌ You've been warned in ServerName!
│ Case ID: WRN-123
│ Reason: Spam
│ Moderator: @ModName   ← only shown if notifications enabled
│ Duration: 30d

Use Cases:

• Enable: Transparent moderation with accountability
• Disable: Protect moderators from targeted harassment
• Privacy: Reduce moderator doxxing risk in public servers

Utility Commands

/say

Make the bot send a message in a channel.

/say message:"Welcome to the server!" channel:#welcome attachment:<file>

Permissions Required:

• User: administrator
• Bot: send_messages in target channel

/nuke

Clone and delete a channel (full reset).

/nuke channel:#spam-chat

Process:

1. Asks for confirmation (type confirm within 10 seconds)
2. Clones the channel (preserves settings)
3. Maintains channel position
4. Deletes original channel
5. Sends confirmation embed in new channel

Moderator Statistics

Comprehensive analytics for moderation activity and performance tracking.

/modstats overview

Get a comprehensive overview of moderation statistics.

/modstats overview days:30 moderator:@Mod

/modstats leaderboard

View top moderators ranked by activity and quality.

/modstats leaderboard days:30 limit:10

Ranking Criteria:

1. Manual Actions (primary sort)
2. Escalations (tiebreaker)
3. Overall activity quality

Per-Moderator Metrics:

• Total actions (manual + auto)
• Manual action ratio
• Escalations (WARN → harsher penalty)
• Actions per day average
• Total strikes issued

/modstats user

View detailed moderation history for a specific user.

/modstats user user:@User days:90

/modstats timeline

View moderation activity over time.

/modstats timeline days:30

Features:

• Daily activity breakdown
• Top 3 action types per day
• Total actions per day
• Shows last 14 days maximum

/modstats export

Export raw moderation data to CSV file.

/modstats export days:90

Requires: administrator permission

CSV Columns:

• Case ID
• User ID
• Moderator ID
• Type (WARN, MUTE, BAN, etc.)
• Reason (escaped for CSV)
• Strikes
• Timestamp (YYYY-MM-DD HH:MM:SS UTC)
• State (OPEN/CLOSED)
• AutoMod (true/false)
• Duration