2.0
Compatibility
Changes
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.
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:rfYPnUkQ:JLN3eJhp"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:rfYPnUkQ:JLN3eJhp"
}

