All versions
2.0
Beta
SimpleLogs 2.05 months ago 60
Compatibility
Minecraft: Java Edition
1.21.x
Platforms
Bukkit
Paper
Purpur
Spigot
Changes
ā” SimpleLogs 2.0 ā Major Feature Update
š New Systems
š§± Block Logging
- Tracks every block break and place across your server
- Configurable per-action toggle (log breaks only, places only, or both)
- Built-in per-player rate limiter ā max logs per second per player, excess silently dropped
- Material filter system with BLACKLIST / WHITELIST modes
- Default blacklist covers 40+ common junk blocks (dirt, stone, gravel, leaves, etc.) to prevent log spam from mining and farming
- GLOBAL and PER_PLAYER storage modes
- Query via
/sl blocklogs <player>
š¦ Container Interaction Logging
- Tracks OPEN, TAKE, and PUT actions on Chests, Barrels, Shulker Boxes, Hoppers, Droppers, Dispensers, Furnaces, Smokers, Blast Furnaces, and Brewing Stands
- Correctly handles direct clicks, shift-clicks, and partial pickups
- Skips null and AIR items automatically ā no empty-hand spam
- Per-player rate limiter identical to block logging
- GLOBAL and PER_PLAYER storage modes
- Query via
/sl containerlogs <player>
š Admin Investigation Tools
- New
/sl investigate <player>command pulls from ALL log systems simultaneously - Parallel async reads merge into a single formatted report on the main thread
- Filter by system:
/sl investigate <player> combat|blocks|containers|all - Color-coded output ā red for breaks/takes, green for places/puts
- Configurable max entries per system
- Zero blocking ā uses the same async + main-thread callback pattern as all other systems
š§ Fixes & Improvements
- Added Paper API (
paper-api:1.21.1) as secondarycompileOnlydependency alongside Spigot - Fixed deprecated
BanList.Type.NAMEā now uses profile-basedBanList.Type.PROFILE - Added Paper-compatible
AsyncChatEventhandler alongside existing SpigotAsyncPlayerChatEventhandler ā no crashes on either platform - Bumped version to
2.0 - New professional console startup banner
āļø Config Additions
block-loggingsection with full toggle, filter, rate limit, and storage controlscontainer-loggingsection with per-action toggles, rate limit, and storage controlsinvestigationsection with configurable max entries per system
š New Permissions
simplelogs.blocklogsā view block log historysimplelogs.blocklog.bypassā exclude player from block loggingsimplelogs.containerlogsā view container log historysimplelogs.containerlog.bypassā exclude player from container loggingsimplelogs.investigateā run full investigation reports
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:Dg25bN28:IuRPocdS"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:Dg25bN28:IuRPocdS"
}

