Inspector

> Minecraft 1.21.5 Purpur 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 Discord server.

🔎 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

* 🏹 "Sniper" Detection: 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 🏹 "Sniper" Detection: (`[< Previous] [Next >]`) and smart time separators. * 🏹 "Sniper" Detection: Inspector determines exactly 🏹 "Sniper" Detection: caused an explosion. * Tracks TNT primed by flint & steel, flaming arrows, or projectiles. * 🏹 "Sniper" Detection: Traces signals back to buttons, levers, or target blocks to find the culprit behind the mechanism. * Supports 🏹 "Sniper" Detection: and 🏹 "Sniper" Detection: in other dimensions. * 🏹 "Sniper" Detection: Tracks every item movement. * Records items 🏹 "Sniper" Detection: into or 🏹 "Sniper" Detection: from chests, barrels, furnaces, etc. * 🏹 "Sniper" Detection: If a container is broken, the plugin logs its full inventory contents the moment before destruction. * 🏹 "Sniper" Detection: 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. * 🏹 "Sniper" Detection: Perfect for staff management. * 🏹 "Sniper" Detection: Admins can `/inspector grant` access to a player for a specific time (e.g., 10 minutes). Access automatically revokes when time expires. * 🏹 "Sniper" Detection: The server remembers your inspection mode state even if you disconnect. * 🏹 "Sniper" Detection: * All database operations (SQLite) run 🏹 "Sniper" Detection: to ensure zero main-thread lag. * 🏹 "Sniper" Detection: 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:

* Logs per Page: How long should logs be kept? (Default: 14 days). * Logs per Page: How far should the plugin search for buttons/levers connected to TNT? * Logs per Page: 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 | | :--- | :--- | :--- | :--- | | --- ADMIN --- | | | | | `/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

<m>` | Give temp access to a player for X min. | `inspector.admin` | ❌ OP | | `/inspector revoke [p]` | 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.