StaffLogger

Lightweight, configurable staff moderation logging for Paper and Spigot servers with verified Discord reporting.

Unlike traditional command loggers, StaffLogger only logs moderation actions that actually succeed. Failed commands, typos, and permission errors are ignored, keeping your moderation logs clean and accurate.

---

✨ Features

✅ Verified Moderation Logging

Every supported moderation action is verified before being sent to Discord.

Supported verification includes:

• 🔨 Bans
• 🔓 Unbans
• 👢 Kicks

If the action wasn't successful, nothing gets logged.

---

⚙️ Fully Configurable Command Tracking

Track your own moderation commands directly from config.yml.

For each command you can configure:

• Aliases
• Verification type
• Discord embed color
• Display label

No Java knowledge or recompiling required.

---

🆔 UUID & NameMC Integration

Every moderation log includes:

• Target player
• Player UUID
• Clickable NameMC profile

Perfect for tracking players even after they change their username.

---

📨 Beautiful Discord Embeds

Logs are sent as clean, modern Discord embeds containing:

• 👮 Staff Member
• 🎯 Target Player
• 🆔 UUID
• ⚖️ Action
• ⏱️ Duration (if applicable)
• 📝 Reason
• 🕒 Timestamp

Each command can have its own embed color.

---

⚡ Lightweight & Async

Webhook requests are processed asynchronously.

• No TPS impact
• No main-thread blocking
• Suitable for servers of any size

---

⚙️ Example Configuration

commands:
  ban:
    aliases:
      - "ban"
      - "banip"

    type: BAN
    color: "#E74C3C"
    label: "Player Banned"

---

📖 Verification Types

Type	Description
BAN	Confirms the player was successfully banned before logging
UNBAN	Confirms the player was successfully unbanned before logging
KICK	Confirms the player was kicked before logging
GENERIC	Logs the command without additional verification

---

📦 Requirements

• Paper / Spigot 1.21+
• Java 21+
• Discord Webhook URL

---

❤️ Why StaffLogger?

Most moderation loggers record every command that's entered—even if it fails.

StaffLogger verifies every action before logging it, ensuring your Discord audit log only contains real moderation actions. Clean, accurate, and reliable.