🥾Moderation

Support & Moderation

📋 Overview

The Moderation module provides comprehensive server moderation tools for maintaining a safe and organized community. Features include a three-strike warning system with automatic escalation, timeout management with preset durations, member kick and ban capabilities, automatic temporary ban handling, bulk message deletion (purge), warning tracking and removal, moderation action logging, and DM notifications to affected users. The system includes built-in safeguards to prevent self-moderation and requires administrator permissions for most actions.

⚙️ How It Works

Three-Strike Warning System:

Warning Progression:

  1. First Warning:

    • 1-hour timeout automatically applied

    • User receives DM notification

    • Warning counter: 1/3

  2. Second Warning:

    • 12-hour timeout automatically applied

    • Final warning notification sent

    • Warning counter: 2/3

    • User warned of permanent ban on next violation

  3. Third Warning:

    • Permanent ban automatically applied

    • Ban notification with appeal link sent

    • Warnings reset to 0 (but user is banned)

    • Appeal form provided in DM

Warning Reset:

  • At 4 warnings, counter resets to 1

  • Prevents counter overflow

  • Maintains three-strike system

Timeout System:

Duration Options:

  • 1 Minute

  • 5 Minutes

  • 10 Minutes

  • 1 Hour

  • 1 Day

  • 1 Week

Timeout Features:

  • Prevents communication during timeout

  • DM notification sent to user

  • Can be removed early with /mod untimeout

  • Prevents duplicate timeouts

  • Logs action to moderation channel

Ban & Kick System:

Permanent Ban:

  • Removes user from server permanently

  • Requires manual unban to return

  • DM notification sent before ban

  • Logged to moderation channel

Kick:

  • Removes user from server temporarily

  • User can rejoin with invite link

  • DM notification sent before kick

  • Logged to moderation channel

Unban:

  • Removes existing ban

  • User can rejoin with invite

  • DM notification sent

  • Logged to moderation channel

Temporary Ban System:

Background Task:

  • Runs continuously in background

  • Checks every 60 seconds for expired bans

  • Automatically unbans users when time expires

  • Updates database accordingly

  • Separate from manual bans

Database Storage:

  • Stored in "temporary_moderation" collection

  • Tracks expiration timestamps

  • Cross-guild collection (database 0)

Message Purge:

Bulk Deletion:

  • Delete 1-100 messages at once

  • Optional: Target specific user's messages

  • Cannot delete messages older than 14 days (Discord limitation)

  • Logs number of deleted messages

  • Ephemeral confirmation to moderator

Logging System:

All Actions Logged:

  • Warn, Timeout, Untimeout

  • Ban, Unban, Kick

  • Purge operations

Log Information Includes:

  • Moderator who performed action

  • Target user/member

  • Reason provided

  • Additional details (duration, message count, etc.)

  • Timestamp of action

  • Color-coded by action type

DM Notification System:

Users Receive DMs For:

  • Warnings (with current count and timeout duration)

  • Timeouts (with duration and reason)

  • Timeout removal (with reason)

  • Bans (with reason)

  • Unbans (with reason)

  • Kicks (with reason)

  • Warning removal (with reason)

DM Features:

  • Graceful failure if DMs closed

  • No error shown to user if DM fails

  • Formatted embeds with server name

  • Includes appeal link for permanent bans

  • Timestamps included

Strikes Database:

Strike Tracking:

  • Stored per user per guild

  • Functions: add_strike(), get_strikes(), remove_strikes()

  • Categories: warnings, timeouts, bans (extendable)

  • Persistent across sessions

Safeguards:

Built-in Protections:

  • Cannot moderate yourself

  • Cannot timeout already timed-out users

  • Cannot unban users who aren't banned

  • Cannot untimeout users who aren't timed out

  • Permission checks before execution

  • Channel restrictions for specific guild

🔑 Key Commands

/mod warn

Description: Issue a warning to a member (Admin only) Access: Administrators only Cooldown: 10 seconds per member Required Permission: Administrator Parameters:

  • member (required): Member to warn

  • reason (optional): Reason for warning (default: "No reason specified")

First Warning Response:

DM to User:
Title: ⚠️ First Warning Issued
Description: "You have received a warning in **{server}** for: `{reason}`

This server operates under a 3-warning policy. You have been placed in timeout for 1 hour. If you believe this action was taken in error, please contact support after your timeout expires."
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Action: 1-hour timeout applied automatically

Moderator Confirmation:
Title: ⚠️ Warning Issued Successfully
Description: "{member} has been warned and now has **1** warning(s).

**Reason:** {reason}"
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Second Warning Response:

DM to User:
Title: ⚠️ Second Warning Issued
Description: "You have received your second warning in **{server}** for: `{reason}`

This is your final warning. One additional violation will result in a permanent ban. You have been placed in timeout for 12 hours. If you believe this action was taken in error, please contact support after your timeout expires."
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Action: 12-hour timeout applied automatically

Moderator Confirmation:
Title: ⚠️ Warning Issued Successfully
Description: "{member} has been warned and now has **2** warning(s).

**Reason:** {reason}"
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Third Warning Response:

DM to User:
Title: 🔨 Permanent Ban Issued
Description: "You have been permanently banned from **{server}** for accumulating 3 warnings.

You may appeal this decision here: https://form.jotform.com/240926148172053"
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Action: Permanent ban applied automatically

Moderator Confirmation:
Title: ⚠️ Warning Issued Successfully
Description: "{member} has been warned and now has **3** warning(s).

**Reason:** {reason}"
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Permission Error:

Title: ❌ Insufficient Permissions
Description: "You do not have the required permissions to execute this command."
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

/mod checkwarnings

Description: View a member's warning count and history (Admin only) Access: Administrators only Cooldown: 5 seconds per member Required Permission: Administrator Parameters:

  • member (required): Member to check

Clean Record Response:

Title: 📊 Warning Status: {member name}
Description:
  **Status:** ✅ Clean Record
  **Total Warnings:** 0/3
  
  **Next Consequence:**
  • 1-hour timeout
Color: Green
Thumbnail: Member avatar
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

First Warning Status:

Title: 📊 Warning Status: {member name}
Description:
  **Status:** ⚠️ First Warning
  **Total Warnings:** 1/3
  
  **Next Consequence:**
  • 12-hour timeout
Color: Orange (0xFFA500)
Thumbnail: Member avatar
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Final Warning Status:

Title: 📊 Warning Status: {member name}
Description:
  **Status:** ⚠️ Final Warning
  **Total Warnings:** 2/3
  
  **Next Consequence:**
  • Permanent ban
Color: Dark Orange (0xFF6B00)
Thumbnail: Member avatar
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Maximum Warnings:

Title: 📊 Warning Status: {member name}
Description:
  **Status:** 🚫 Maximum Warnings Reached
  **Total Warnings:** 3/3
  
  **Next Consequence:**
  • Already at maximum warnings
Color: Red
Thumbnail: Member avatar
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

/mod removewarnings

Description: Clear all warnings from a member (Admin only) Access: Administrators only Cooldown: 10 seconds per member Required Permission: Administrator Parameters:

  • member (required): Member to clear warnings from

  • reason (optional): Reason for clearing (default: "No reason specified")

Success Response:

Moderator Confirmation:
Title: 🗑️ Warnings Cleared Successfully
Description: "All warnings have been removed from {member}.

**Previous Warnings:** {count}
**Reason:** {reason}"
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

DM to User:
Title: ✅ Warnings Cleared
Description: "Your warnings in **{server}** have been cleared.

**Reason:** {reason}"
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

No Warnings Found:

Title: ℹ️ No Warnings Found
Description: "{member} has no warnings to clear."
Color: Blue
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

/mod timeout

Description: Temporarily restrict a member's communication (Admin only) Access: Administrators only Cooldown: 30 seconds per member Required Permission: Administrator Parameters:

  • member (required): Member to timeout

  • duration (required): Duration (1m, 5m, 10m, 1h, 1d, 1w)

  • reason (optional): Reason (default: "No reason provided")

Success Response:

Moderator Confirmation:
Title: ⏱️ Timeout Applied Successfully
Description: "{member} has been timed out for **{duration}**.

**Reason:** {reason}"
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

DM to User:
Title: ⏱️ Timeout Notice
Description: "You have been placed in timeout in **{server}** for **{duration}**.

**Reason:** {reason}"
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Log Embed:
Author: Timeout | {member name} (with avatar)
Fields:
  - Moderator: {moderator mention}
  - Target: {member mention}
  - Duration: {duration name}
  - Reason: {reason}
Color: Blue
Thumbnail: Bot avatar
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Error Responses:

Already Timed Out:

Title: ❌ Already Timed Out
Description: "This member is already timed out."
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Delivery: Ephemeral

Self-Timeout Attempt:

Title: ❌ Invalid Action
Description: "You cannot timeout yourself."
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Delivery: Ephemeral

Invalid Channel (Guild-Specific):

Title: ❌ Invalid Channel
Description: "This command can only be used in <#1100115066940051578> or <#1079076009921482855>."
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Delivery: Ephemeral
Note: Only applies to guild ID 1066044662034477178

Insufficient Bot Permissions:

Title: ❌ Insufficient Permissions
Description: "I do not have the required permissions to timeout this member."
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Delivery: Ephemeral

HTTP Exception:

Title: ❌ Action Failed
Description: "Failed to timeout this member. Please try again."
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Delivery: Ephemeral

/mod untimeout

Description: Remove timeout restriction from a member (Admin only) Access: Administrators only Cooldown: 30 seconds per member Required Permission: Administrator Parameters:

  • member (required): Member to untimeout

  • reason (optional): Reason (default: "No reason provided")

Success Response:

Moderator Confirmation:
Title: ✅ Timeout Removed Successfully
Description: "{member} has been untimed out.

**Reason:** {reason}"
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

DM to User:
Title: ✅ Timeout Removed
Description: "Your timeout in **{server}** has been removed.

**Reason:** {reason}"
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Log Embed:
Author: Untimeout | {member name} (with avatar)
Fields:
  - Moderator: {moderator mention}
  - Target: {member mention}
  - Reason: {reason}
Color: Green
Thumbnail: Bot avatar
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Not Timed Out Error:

Title: ❌ Not Timed Out
Description: "This member is not currently timed out."
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Delivery: Ephemeral

/mod ban

Description: Permanently ban a member from the server (Admin only) Access: Administrators only Cooldown: 30 seconds per member Required Permission: Administrator Parameters:

  • member (required): Member to ban

  • reason (optional): Reason (default: "No reason provided", max 500 chars)

Success Response:

Moderator Confirmation:
Title: 🔨 Member Banned Successfully
Description: "{member} has been permanently banned from the server.

**Reason:** {reason}"
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

DM to User (sent before ban):
Title: 🔨 Ban Notice
Description: "You have been permanently banned from **{server}**.

**Reason:** {reason}"
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Log Embed:
Author: Ban | {member name} (with avatar)
Fields:
  - Moderator: {moderator mention}
  - Target: {member mention}
  - Reason: {reason}
Color: Red
Thumbnail: Bot avatar
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Self-Ban Error:

Title: ❌ Invalid Action
Description: "You cannot ban yourself."
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Delivery: Ephemeral

/mod unban

Description: Remove a ban from a user (Admin only) Access: Administrators only Cooldown: 30 seconds per member Required Permission: Administrator Parameters:

  • user (required): User to unban

  • reason (optional): Reason (default: "No reason provided")

Success Response:

Moderator Confirmation:
Title: 🔓 User Unbanned Successfully
Description: "{user} has been unbanned from the server.

**Reason:** {reason}"
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

DM to User:
Title: 🔓 Ban Removed
Description: "Your ban from **{server}** has been lifted.

**Reason:** {reason}"
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Log Embed:
Author: Unban | {user name} (with avatar)
Fields:
  - Moderator: {moderator mention}
  - Target: {user mention}
  - Reason: {reason}
Color: Blue
Thumbnail: Bot avatar
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Not Banned Error:

Title: ❌ Not Banned
Description: "This user is not currently banned."
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Delivery: Ephemeral

/mod kick

Description: Remove a member from the server (Admin only) Access: Administrators only Cooldown: 30 seconds per member Required Permission: Administrator Parameters:

  • member (required): Member to kick

  • reason (optional): Reason (default: "No reason provided")

Success Response:

Moderator Confirmation:
Title: 👢 Member Kicked Successfully
Description: "{member} has been removed from the server.

**Reason:** {reason}"
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

DM to User (sent before kick):
Title: 👢 Kick Notice
Description: "You have been removed from **{server}**.

**Reason:** {reason}"
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Log Embed:
Author: Kick | {member name} (with avatar)
Fields:
  - Moderator: {moderator mention}
  - Target: {member mention}
  - Reason: {reason}
Color: Orange (0xFFA500)
Thumbnail: Bot avatar
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Self-Kick Error:

Title: ❌ Invalid Action
Description: "You cannot kick yourself."
Color: Red
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Delivery: Ephemeral

/mod purge

Description: Bulk delete messages from a channel (Admin only) Access: Administrators only Cooldown: 30 seconds per member Required Permission: Administrator Parameters:

  • amount (required): Number of messages (1-100)

  • member (optional): Only delete this member's messages

Success Response (All Messages):

Moderator Confirmation:
Title: 🗑️ Messages Purged Successfully
Description: "Deleted **{count}** message(s) from this channel."
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Delivery: Ephemeral

Log Embed:
Author: Purge | {channel name} (with guild icon)
Fields:
  - Moderator: {moderator mention}
  - Channel: {channel mention}
  - Messages Deleted: {count}
Color: Orange (0xFFA500)
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

Success Response (Specific Member):

Moderator Confirmation:
Title: 🗑️ Messages Purged Successfully
Description: "Deleted **{count}** message(s) from {member}."
Color: Green
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"
Delivery: Ephemeral

Log Embed:
Author: Purge | {channel name} (with guild icon)
Fields:
  - Moderator: {moderator mention}
  - Channel: {channel mention}
  - Target User: {member mention}
  - Messages Deleted: {count}
Color: Orange (0xFFA500)
Footer: "{timestamp} | Made by DIVINITY | Pleasure Corner"

👥 Who It's For

Administrators: Full access to all moderation commands

Moderators: Access with administrator permission (can be customized)

Server Owners: Ultimate control over server safety

Support Team: Can issue warnings and manage timeouts

💡 Why This Feature

Maintains server safety and order through structured moderation. Provides escalating consequences for rule violations. Automates timeout application based on warning level. Ensures users are informed of actions via DM. Creates audit trail through logging system. Prevents abuse through permission checks and safeguards. Allows flexible timeout durations for various violations. Enables efficient message cleanup with purge. Supports temporary ban system for timed restrictions. Promotes accountability through transparent action logging.

Made by DIVINITY • Pleasure Corner

PreviousLovenseNextSupport & Utilities

Last updated

Was this helpful?