Guardian - Logging

<div align="center">

🛡️ Guardian

Block & Container Logging with Web Dashboard for Paper Servers

Version

API

Java

License

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

</div>

---

✨ 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!

---

📋 Supported Versions

| Requirement | Version | |:------------|:--------| | Minecraft | 1.21 - 1.21.5 | | Server | Paper, Purpur, or compatible forks | | Java | 17+ |

---

<div align="center">

📜 License

BSD 3-Clause License

---

<div align="center">

🤝 Partner

<a href="https://emeraldhost.de/frxme"> <img src="https://cdn.emeraldhost.de/branding/icon/icon.png" width="80" alt="Emerald Host Logo"> </a>

Powered by EmeraldHost

*DDoS-Protection, NVMe Performance und 99.9% Uptime.* *Der Host meines Vertrauens für alle Development-Server.*

<a href="https://emeraldhost.de/frxme"> <img src="https://img.shields.io/badge/Code-Frxme10-10b981?style=for-the-badge&logo=gift&logoColor=white&labelColor=0f172a" alt="Use Code Frxme10 for 10% off"> </a>

</div>

Made with ❤️ by Frxme

</div>