⚠️ 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 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

• 🔍 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 ([< Previous] [Next >]) 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 [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.