# 🛡️🔍📋 ServerGuard — Complete Server Monitoring & Security
> **Know everything that happens on your server — log it, watch it, roll it back.**
[]()
[]()
[]()
[]()
---
## 🌟 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.*
