ServerGuard_by_Bell

# 🛡️🔍📋 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**:

| 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.*