Inspector

> **⚠️ Compatibility Note:** This plugin is built for **Minecraft 1.21.5 Purpur**. I tested it on Purpur 1.21.5 and Spigot 1.21.1. It should work on 1.21.1-1.21.5 Spigot/Purpur/Paper/Bukkit. If you want to report a bug or suggest a new plugin, join my (https://discord.gg/A7WVnYj3BP). # 🔎 Inspector **Log. Analyze. Protect.** Inspector is a high-performance, asynchronous block logger designed for modern survival servers. It tracks block changes, container transactions, and explosions with forensic precision. Unlike older loggers, Inspector uses smart heuristics to determine exactly *who* triggered an explosion via Redstone or who spilled that water bucket, all while keeping your database clean and your server lag-free. ### ✨ Key Features * **🔍 Interactive Inspection Tool:** No complex commands needed for daily use. * Simply type `/inspect` to get the tool (Stick) and toggle inspection mode. * Right-click any block to see its full history with **Clickable Pagination** (` `) and smart time separators. * **🧨 Advanced Explosion Forensics:** Inspector determines exactly **who** caused an explosion. * Tracks TNT primed by flint & steel, flaming arrows, or projectiles. * **Redstone Detective:** Traces signals back to buttons, levers, or target blocks to find the culprit behind the mechanism. * Supports **Bed Bombing** and **Respawn Anchors** in other dimensions. * **📦 Container Transaction Logging:** Tracks every item movement. * Records items **Deposited** into or **Withdrawn** from chests, barrels, furnaces, etc. * **Snapshot System:** If a container is broken, the plugin logs its full inventory contents the moment before destruction. * **🌊 Smart Flow Tracking:** Detects who spilled water or lava. * If a liquid stream flows 5 blocks away and destroys crops or Redstone, the plugin correctly attributes the destruction to the player who placed the source bucket. * **🛡️ Granular Access Control:** Perfect for staff management. * **Temporary Access:** Admins can `/inspector grant` access to a player for a specific time (e.g., 10 minutes). Access automatically revokes when time expires. * **Persistence:** The server remembers your inspection mode state even if you disconnect. * **🚀 High-Performance Architecture:** * All database operations (SQLite) run **Asynchronously** to ensure zero main-thread lag. * **Module System:** You can disable resource-heavy features (like Flow tracking) in the config if running on weaker hardware. * **🏹 "Sniper" Detection:** Solves the "mystery arrow" problem. If a player activates a button using an Arrow or Trident to trigger a trap, the plugin identifies the shooter. --- ### ⚙️ Configuration Everything is customizable via `config.yml` or in-game commands: * **Retention Days:** How long should logs be kept? (Default: 14 days). * **Redstone Depth:** How far should the plugin search for buttons/levers connected to TNT? * **Modules:** Toggle Block Changes, Explosions, Flow, Interactions, or Entities independently to save resources. * **Logs per Page:** Customize how many entries appear in chat. --- ### 🔎 Inspector - Commands & Permissions **Main commands:** `/inspector` (Admin) and `/inspect` (Tool) | Command | Description | Permission | Default | | :--- | :--- | :--- | :--- | | **--- PLAYER / TOOL ---** | | | | | `/inspect` | Toggles inspection mode & gives tool. | `inspector.tool` | ❌ OP | | `/i`, `/lb`, `/logblock` | Aliases for `/inspect`. | `inspector.tool` | ❌ OP | | `/inspector language <pl/en>` | Change your personal interface language. | `inspector.use` | ✅ Everyone | | `/inspector` | Displays server status & active modules. | `inspector.use` | ✅ Everyone | | `/inspector help` | Displays available commands. | `inspector.use` | ✅ Everyone | | **--- ADMIN ---** | | | | | `/inspector grant <p> <m>` | Give temp access to a player for X min. | `inspector.admin` | ❌ OP | | `/inspector revoke ` | Revoke temp access (from one or all). | `inspector.admin` | ❌ OP | | `/inspector listtemp` | Show players with active temp access. | `inspector.admin` | ❌ OP | | `/inspector toggle <mod>` | Toggle modules (flow, explosions, etc.). | `inspector.modules` | ❌ OP | | `/inspector reload` | Reloads configuration & messages. | `inspector.admin` | ❌ OP | * **Wildcard Permission:** `inspector.*` (Grants full command access). **Modules (Toggleable):** You can enable/disable these systems via config or command to optimize performance. * `block-change`: Placing and breaking blocks. * `explosions`: TNT, Creepers, Beds, Anchors, Fire. * `flow`: Water/Lava spread and destruction (Heaviest). * `interactions`: Chest opening, transactions (deposit/withdraw). * `entities`: Item Frames, Armor Stands, Buckets, Trampling. --- ### 🚀 Installation 1. Download the `.jar` file. 2. Place it in the `/plugins/` folder of your server (Spigot/Paper/Purpur **1.21.x**). 3. Restart the server.