StaffLogger

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

Unlike plugins that simply log every command executed, StaffLogger verifies that the moderation action actually succeeded before sending it to Discord. No more log spam from typos, missing permissions, or failed commands.

---

✨ Features

✅ Verified Logging

StaffLogger confirms that moderation actions actually happened before logging them.

Supported verification includes:

• Player Bans
• Player Unbans
• Player Kicks

If the command fails, nothing is sent to Discord.

---

⚙️ Fully Configurable Command Tracking

Track any moderation command directly from config.yml.

For every command you can configure:

• Command aliases
• Verification type
• Discord embed color
• Display label

No coding or recompiling required.

---

🆔 UUID + NameMC Integration

Every logged action includes:

• Player username
• UUID
• Direct link to the player's NameMC profile

This makes it easy to identify players even after name changes.

---

📨 Beautiful Discord Embeds

StaffLogger sends clean, easy-to-read Discord embeds containing:

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

Each command can have its own custom embed color.

---

⚡ Asynchronous & Lightweight

Webhook requests are processed asynchronously.

• No server lag
• No impact on TPS
• Safe for large servers

---

⚙️ Example Configuration

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

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

Verification Types

Choose how StaffLogger verifies each command before logging it.

Type	Description
BAN	Verifies the player was successfully banned
UNBAN	Verifies the player was successfully unbanned
KICK	Verifies the player was kicked
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 typed—even if it fails.

StaffLogger only logs successful moderation actions, giving your staff team accurate, trustworthy audit logs without unnecessary clutter.