SimpleLogs

<div align="center"> # ⚡ SimpleLogs ### The Next-Generation Combat, Forensic & Admin Logging System **Engineered for high-performance Spigot, Paper, and Purpur networks — Minecraft 1.21.1+** (https://img.shields.io/badge/Version-2.0-007ec6?style=flat-square)](#) (https://img.shields.io/badge/API-1.21.1+-97ca00?style=flat-square)](#) (https://img.shields.io/badge/Platform-Spigot%20%7C%20Paper-orange?style=flat-square)](#) (https://img.shields.io/badge/Author-YounggamingDJ-e05d44?style=flat-square)](#) *One plugin. Complete server visibility. Zero TPS impact.* </div> --- ## 🧠 What is SimpleLogs? SimpleLogs is a production-grade server administration plugin built around a single philosophy: **your server should know exactly what happened, when it happened, and who did it — without ever sacrificing performance.** From combat loggers to base griefers, chest thieves to suspicious explosions, SimpleLogs captures everything silently in the background using fully asynchronous I/O, smart rate limiting, and efficient data structures. No chunk scanning. No blocking operations. No compromise. Built from the ground up for **Spigot as its primary platform**, with full **Paper compatibility** out of the box. --- ## ⚔️ Combat Logging Prevention Stop players from escaping fights unfairly. SimpleLogs tags both players the moment PvP begins and holds that tag until the combat timer expires. - **Configurable Logout Actions** — choose `KILL`, `PUNISH`, or `BOTH` when a tagged player disconnects - **Natural Item Drops** — the combat logger's inventory drops at their exact location for the victor to collect - **Punishment Engine** — apply `BAN`, `TEMPBAN`, `WARN`, or `NONE` as your server policy dictates. Tempban durations are fully configurable (`10m`, `1h`, `1d`) - **Grace Period Protection** — newly joined players are immune to combat tagging for a configurable window (default 5 seconds), preventing spawn-kill abuse - **Command Interception** — whitelist/blacklist engine blocks escape commands like `/spawn`, `/tp`, `/home` while always allowing chat commands like `/msg` and `/reply`. Fully configurable, bypass permission supported - **Combat Feedback** — ActionBar or BossBar timer display with configurable colors, styles, and formats. Combat-start sound plays once on entry (default: Ender Dragon growl). All UI elements are individually toggleable --- ## 💣 Explosion Forensic System *Running a Private SMP? Ever needed to prove exactly who blew up someone's base?* Activate `PRIVATE_SMP` mode to enable the full explosion forensics engine. Every detonation is captured as a timestamped forensic report containing everything you need for a thorough investigation. **Tracked explosion types:** - TNT ignitions (with source player detection) - Bed detonations in the Nether and End - End Crystal explosions - Respawn Anchor misuse **Every report includes:** - Explosion type and exact coordinates - Triggering player (or `UNKNOWN` if undetectable) - Full snapshot of all online players — names, worlds, and coordinates at the exact moment of detonation - Nearby suspects highlighted with precise block distance - Multi-timezone timestamps (IST, CET, EST, PST) **Anti-lag system built in** — per-second rate limiting, per-location cooldowns, and automatic disabling under extreme spam (configurable threshold) ensure TNT machines and raid farms never degrade your TPS. > *Radius calculations use `distanceSquared` exclusively for suspect detection — no square root overhead on the main thread.* --- ## 🧱 Block Logging Track every block interaction across your server with surgical precision. - Logs **breaks** and **places** independently — toggle each action in config - **Material filter system** — choose `BLACKLIST` mode to ignore junk blocks (dirt, stone, gravel, sand, leaves — 40+ defaults included) or `WHITELIST` mode to log only specific blocks you care about - **Per-player rate limiter** — configurable max events per second per player. Farms and mining machines never flood your logs - `GLOBAL` mode (single file) or `PER_PLAYER` mode (one file per player) - Query with `/sl blocklogs <player>` - Bypass permission for trusted staff or automated accounts --- ## 📦 Container Interaction Logging Know exactly who opened what, and who took or placed what items. **Tracked containers:** Chest, Barrel, Shulker Box, Hopper, Dropper, Dispenser, Furnace, Blast Furnace, Smoker, Brewing Stand **Tracked interactions:** - `OPEN` — player opened the container - `TAKE` — player removed items (direct click, shift-click, partial pickup) - `PUT` — player placed items (direct placement, shift-click from inventory) Null items and AIR are automatically ignored. Shift-click direction is correctly resolved — no duplicate logs, no missed interactions. Per-player rate limiter and bypass permission included. `GLOBAL` or `PER_PLAYER` storage. Query with `/sl containerlogs <player>`. --- ## 🔍 Admin Investi