Skip to content

Repository files navigation

Guardian

Version License Java Paper

A comprehensive grief protection and logging plugin for Minecraft servers, built with Paper API.


Features

  • Block Logging — Tracks all block place and break actions with full block data
  • Container Logging — Monitors item movements in chests, barrels, hoppers, dispensers, and droppers
  • Item Logging — Records item pickups and drops across the server
  • Interaction Logging — Logs door and container open/close events
  • Inspect Mode — Toggle inspect to view logs by clicking on blocks and containers in-world
  • Rollback — Revert block and container changes within a radius and time window
  • Player Lookup — View all logs for any player with clickable pagination
  • Player Stats — Per-player statistics with activity timeline
  • Auto Cleanup — Configurable automatic purging of old logs
  • MySQL Storage — Persistent data with HikariCP connection pooling
  • Multilingual — Built-in English and Italian language support, easily extensible
  • Interactive UI — Clickable coordinates (teleport), hover tooltips with item details, clickable pagination
  • Developer API — Public API module for integration with other plugins
  • WorldEdit Compatible — Soft dependency on FastAsyncWorldEdit

Requirements

  • Java 21+
  • Paper 1.21+ (Spigot/Bukkit compatible)
  • MySQL 5.7+ or MariaDB 10.3+

Installation

  1. Download the latest Guardian.jar from the releases page
  2. Place the JAR in your server's plugins/ folder
  3. Start or restart the server
  4. Edit plugins/Guardian/config.yml with your database credentials
  5. Reload or restart the server to apply changes

Time Format

The time argument supports combinations of s (seconds), m (minutes), h (hours), d (days).

Examples: 15m, 1h30m, 2d, 30s, 1h30m45s


Documentation

Full documentation including commands, permissions, configuration, and API reference:

DOCUMENTATION


Bug Reports & Feature Requests

Found a bug or have a suggestion? Open an issue on GitHub Issues.


License

This project is licensed under the MIT License.


Developed by zImpoo

About

No description, website, or topics provided.

Resources

Stars

8 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages