Moderation

Configure moderation logs and anti-abuse features from a single module.

Quick Setup

1

Enable the log/feature you want

Enabled: true

2

Set the channel

Replace "CHANNEL_ID" with your actual log channel ID.

See Developer Mode (Copying IDs).

3

(Optional) Customize embeds

You can customize embeds with placeholders.

---

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}"