# 🛡️🔍📋 ServerGuard — Complete Server Monitoring & Security

> **Know everything that happens on your server — log it, watch it, roll it back.**

[![Version](https://img.shields.io/badge/version-1.26.1.2-blue)]()
[![API](https://img.shields.io/badge/API-Spigot | Paper 1.21+-green)]()
[![Java](https://img.shields.io/badge/Java-21+-orange)]()
[![Dependencies](https://img.shields.io/badge/dependencies-none-brightgreen)]()

---

## 🌟 What is ServerGuard?

**ServerGuard** is a comprehensive server monitoring and logging plugin that gives you complete visibility into everything happening on your server. Track player actions, detect suspicious behavior, investigate griefing incidents, and roll back damage — all from an intuitive in-game interface.

Whether you run a small community server or a large network, ServerGuard provides the tools your staff team needs to keep things safe and fair.

---

## ✨ Core Features

- 📝 **Action Logging** — Block place/break, container access, item drops/pickups, command usage
- 👁️ **Watch System** — Flag specific players for enhanced real-time monitoring
- 🚨 **Alert System** — Configurable triggers for suspicious behavior patterns
- 🔎 **Audit System** — Detailed audit trails for thorough investigations
- 🖥️ **Admin GUI** — Beautiful in-game interface for browsing and searching logs
- 💾 **Database Storage** — Persistent SQLite storage for reliable log retention
- ⏪ **Rollback Capability** — Undo griefing damage with time-based rollbacks
- 🕐 **Time-Based Filtering** — Search logs by time ranges for efficient investigation
- 📊 **Player Activity Reports** — Generate comprehensive reports on player behavior
- 🌍 **Multi-Language** — Built-in English and Polish localization

---

## 🏆 ServerGuard Pro Addon

Take your server security to the next level with **ServerGuard-Pro**:

https://bellforge.pl/en/pluginy/serverguard-pro/

| Feature | Description |
|---------|-------------|
| 🧠 **Pattern Detection** | Enhanced watch alerts with behavioral pattern recognition |
| ✈️ **Hack Detection Signals** | Flight/speed hack detection integration |
| 📤 **CSV Export** | Export logs in 3 modes: full, filtered, or summary |
| 💬 **BellChat Hook** | Moderation integration with BellChat plugin |
| 🔔 **Discord Webhooks** | Real-time security alerts sent to your Discord server |

---

## 📸 How It Works

```
┌──────────────────────────────────────────┐
│ Player Actions │
│ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
│ │Blocks│ │Chests│ │Items │ │ Cmds │ │
│ └──┬───┘ └──┬───┘ └──┬───┘ └──┬───┘ │
│ └────────┼────────┼────────┘ │
│ ↓ ↓ │
│ ┌────────────────────────┐ │
│ │ ServerGuard Engine │ │
│ │ ┌──────┐ ┌────────┐ │ │
│ │ │ Logs │ │ Alerts │ │ │
│ │ └──────┘ └────────┘ │ │
│ └────────────────────────┘ │
│ ↓ ↓ ↓ │
│ ┌────────┐ ┌───────┐ ┌──────────┐ │
│ │Database│ │ GUI │ │ Rollback │ │
│ └────────┘ └───────┘ └──────────┘ │
└──────────────────────────────────────────┘
```

---

## 💻 Commands

| Command | Description |
|---------|-------------|
| `/serverguard watch <player>` | Start watching a player's actions |
| `/serverguard unwatch <player>` | Stop watching a player |
| `/serverguard alert` | View recent security alerts |
| `/serverguard audit <player>` | Generate full audit of player activity |
| `/serverguard search <query>` | Search through action logs |
| `/serverguard gui` | Open the admin log browser GUI |
| `/serverguard rollback <player> <time>` | Rollback a player's actions |
| `/serverguard reload` | Reload plugin configuration |

---

## 🔐 Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| `serverguard.admin` | Full access to all commands | OP |
| `serverguard.watch` | Watch/unwatch players | OP |
| `serverguard.audit` | Access audit reports | OP |
| `serverguard.rollback` | Perform rollback operations | OP |
| `serverguard.gui` | Open the admin GUI | OP |
| `serverguard.alerts` | View security alerts | OP |

---

## 📥 Installation

1. Download `ServerGuard.jar`
2. Place it in your server's `plugins/` folder
3. Restart the server
4. Configure `config.yml` to your needs
5. *(Optional)* Add `ServerGuard-Pro.jar` for enhanced features

---

## ⚙️ Configuration Highlights

```yaml
# Logging settings
logging:
block-changes: true # Log block place/break
container-access: true # Log chest/barrel/etc. access
item-drops: true # Log item drops and pickups
commands: true # Log command usage
log-retention-days: 30 # Auto-cleanup after 30 days

# Watch system
watch:
enhanced-logging: true # Extra detail for watched players
alert-threshold: 5 # Actions per minute to trigger alert

# Alert system
alerts:
enabled: true
notify-on-join: true # Alert when watched player joins
suspicious-break-rate: 50 # Blocks/min to flag as suspicious

# Database
database:
type: SQLITE # SQLite storage
file: "serverguard.db"

# Language
language: en # en / pl
```

---

## 🔗 Dependencies

| Type | Plugin | Required? |
|------|--------|-----------|
| — | — | No dependencies required! |
| Soft | BellChat | Optional — enables moderation hooks (Pro) |

ServerGuard works fully standalone. Pro addon adds optional integrations.

---

## 📊 Use Cases

### 🔍 Grief Investigation
A player reports their build was destroyed. Use `/serverguard audit <suspect>` to see exactly what they did, when, and where. One command to find the truth.

### 👁️ Suspicious Player Monitoring
New player acting strange? `/serverguard watch <player>` — every action is logged with extra detail and staff is alerted in real-time.

### ⏪ Damage Recovery
Confirmed griefer? `/serverguard rollback <player> 2h` — all their damage from the last 2 hours is reversed instantly.

---

## 🤝 Part of the Bell Ecosystem

ServerGuard works seamlessly with the Bell plugin family:
- **BellChat** — Moderation hook integration (Pro)
- **BellLP** — Staff permission management
- **Discord Webhooks** — Real-time alerts to your moderation channels (Pro)

---

## 📋 Requirements

- ☕ **Java 21+**
- 🖧 **Paper or Spigot 1.21+**
- 💾 No additional dependencies

---

## 🆘 Support

- 💬 **Discord:** [https://discord.gg/6q7bnSYaR](#)
- 🐛 **Issues:** [GitHub Issues](#)
- 📖 **Wiki:** [Documentation](#)
- 💡 **Feature Requests:** [Submit ideas](#)

---

## 📄 License

ServerGuard is developed and maintained as part of the Bell plugin ecosystem.

---

> 🛡️ *Your server, fully protected — ServerGuard sees everything so you don't have to.*

ServerGuard_by_Bell