Moderation

The logging system records user actions, moderation events, voice activity, security incidents, and more. All logs are sent to configured channels using embeds, so staff can easily review activity

Quick Setup

1. Enable the log/feature you want.

   Enabled: true

2. Replace "CHANNEL_ID" with your actual log channel ID.

3. (Optional) Customize embeds with placeholders.

👉 How to copy a Channel ID

---

User Activity Logs

🔄 Profile Changes

• Tracks username, avatar, and discriminator updates.

🎭 Role Management

• Logs when users gain or lose roles (manual or automatic).

---

Server Management Logs

🖼 Server Changes

• Name changes, icon updates, and settings modifications.

#️⃣ Channel Management

• Channel creation/deletion.

• Permission changes.

---

Message Activity Logs

❌ Message Deletion

• Shows deleted content.

• Can include attachments if LogImages: true.

• Shows who deleted it (if available).

✏️ Message Edits

• Logs before/after message content.

📦 Purge Logs

• Logs bulk message deletes in a single purge channel.

---

Voice Activity Logs

• Voice joins/leaves.

• Channel switches.

• Streaming activity.

---

Moderation Logs

⏳ Timeout System

• Logs timeouts applied/removed.

⚠️ Warning System

• Configurable warning tiers & punishments.

Warnings:
  Expiry: 30d
  Punishments:
    1:
      Timeout: ""
    2:
      Timeout: "10m"
    3:
      Timeout: "15m"

🔨 Ban/Kick System

• Logs bans, unbans, and kicks with moderator info.

Available placeholders:

• {user} → Mentioned user

• {userTag} → Username#0000

• {userId} → User ID

• {moderator} → Staff member

• {reason} → Reason for action

• {guildName} → Server name

• {longtime} → Full date/time

• {shorttime} → Shortened time

---

Security & Anti-Abuse Logs

👤 Alt Prevention

• Blocks/kicks accounts younger than TimeLimit (e.g. 30d).

• Sends DM & log embed if triggered.

☢️ Anti-Nuke

• Protects from mass bans/kicks/channel/role deletes.

• Uses tiered thresholds with escalating actions (mute/remove role/ban).

🔰 Anti-Hoist

• Removes special characters (-, _, !, etc.) from usernames.

• Optionally renames to a default like zName.

👥 Anti-Mass Mention

• Prevents spam mentions (@everyone or multiple users).

• Can timeout offenders and DM them.

🚫 Anti-Spam

• Limits how many messages can be sent in a short time.

• Example: MsgLimit: 4 within TimeLimit: "1s".

• Can timeout & DM the user.

📝 Blacklist Words

• Deletes messages with blacklisted patterns.

• Supports wildcards (*badword*) and regex.

• Can whitelist roles, channels, or categories.

---

Miscellaneous Logs

• 📥 Invite tracking

• 🎉 Giveaway logs

• 🗑 Purge logs (bulk deletions)

• 📝 Reports (user-submitted reports with jump-to-message links)

Example report log:

Report:
  LogsChannelID: "CHANNEL_ID"
  Embed:
    Title: "📢 New Report"
    Description:
      - "**User:** {user}"
      - "**Content:** {message}"
      - "**Channel:** {channel}"
      - "**Reporter:** {reportingUser}"
      - "**Reason:** {reason}"
      - "**Date:** {timestamp}"