Guardian - Logging

🛡️ Block & container logging with web dashboard for Paper servers - track who did what, when.

Quick challenge

How far can you run before the mobs catch you?

Guardian - Logging

🛡️ Guardian

Block & Container Logging with Web Dashboard for Paper Servers

*Track who did what, when. Now with a modern Web Dashboard.*

---

✨ Features

| Feature | Description | |---------|-------------| | 🌐 Double Chest Support | Modern, responsive admin panel for managing logs and analytics | | 📊 Double Chest Support | Action distribution charts and server activity insights | | 📦 Double Chest Support | Track all block breaks and placements with player attribution | | 📦 Double Chest Support | Monitor item additions and removals from chests, barrels, etc. | | 🔍 Double Chest Support | Click blocks directly to view their history | | 🔒 Double Chest Support | Secure login with JWT tokens and role-based access | | ⚡ Double Chest Support | Zero lag - all operations run in the background | | 💾 Double Chest Support | No external database setup required | | 🗄️ Double Chest Support | Correct handling of large container logging |

---

📥 Installation

``` 1. 📁 Download the latest Guardian.jar from releases 2. 📂 Drop it into your server's plugins folder 3. 🔄 Restart your server 4. ✅ Done! Database created automatically 5. 🌐 Access web dashboard at http://your-server-ip:7070 ```

---

🌐 Web Dashboard

Access the dashboard at `http://your-server-ip:6746` after installation.

Features

- 📈 Real-time analytics and charts - 📋 Browse and filter block/container logs - 👤 User management with role-based access (Admin/User) - 🔒 Secure JWT authentication - 📱 Mobile-responsive design

First-Time Setup

1. Navigate to the dashboard URL 2. Create your admin account 3. Configure your preferences

---

💻 Commands

| Command | Description | Permission | |:--------|:------------|:-----------| | `/lookup [page]` | 🔍 View block history at targeted block | `guardian.lookup` | | `/inspect` | 👁️ Toggle inspector mode | `guardian.inspect` | | `/guardian [page]` | 📦 View container item history | `guardian.inspect` |

🔗 Aliases

| Main Command | Aliases | |:-------------|:--------| | `/lookup` | `/guard`, `/glookup` | | `/inspect` | `/ginspect`, `/gi` | | `/guardian` | `/gcont` |

---

🔐 Permissions

| Permission | Description | Default | |:-----------|:------------|:--------| | `guardian.lookup` | Access block history lookup | OP | | `guardian.inspect` | Access inspector mode & container history | OP |

---

🔍 Inspector Mode

Toggle with `/inspect` for interactive lookups:

| Action | Result | |:-------|:-------| | Right-click any block | View block break/place history | | Right-click a container | View item add/remove history | | Right-click non-container | View block history |

> 💡 All interactions are cancelled in inspector mode to prevent accidents!

---