🛡️ WeGuardian

Professional Punishment Management System for Minecraft Servers
by WeThink

---

✨ Features

🔨 Punishment System

• Ban & TempBan - Permanently or temporarily ban players
• IP Ban & TempIP Ban - Ban players by IP address with automatic IP resolution
• Mute & TempMute - Silence players permanently or temporarily
• IP Mute & TempIP Mute - IP-based muting system
• Kick - Instantly remove players from the server

🎮 Interactive GUI

• Punishment GUI - Beautiful and intuitive punishment selection interface
• Duration Selector - Easy-to-use duration selection with presets
• History Viewer - Browse punishment history with pagination

📊 Database Support

• SQLite - Zero-configuration local storage (default)
• MySQL - Scale to larger servers with MySQL support
• HikariCP - High-performance connection pooling
• Caffeine Caching - Lightning-fast data retrieval

🌐 Web Dashboard

• Built-in web panel for remote management
• REST API for custom integrations
• Configurable branding and appearance

🔗 Discord Integration

• Webhook logging for all punishments
• Batched messages to avoid rate limits
• Beautiful embed formatting

⚡ Performance

• Folia Support - Full compatibility with Folia servers
• Async Operations - Non-blocking database operations
• Lazy GUI Initialization - Optimized GUI performance

---

📥 Installation

1. Download the latest WeGuardian.jar
2. Place it in your server's plugins folder
3. Restart your server
4. Configure plugins/WeGuardian/config.yml

---

📝 Commands

| Command | Description | Permission |
|---------|-------------|------------|
| /ban <player> [reason] | Permanently ban a player | weguardian.ban |
| /tempban <player> <duration> [reason] | Temporarily ban a player | weguardian.tempban |
| /unban <player> | Unban a player | weguardian.unban |
| /banip <player> [reason] | IP ban a player | weguardian.banip |
| /tempbanip <player> <duration> [reason] | Temp IP ban a player | weguardian.tempbanip |
| /unbanip <player> | Unban a player's IP | weguardian.unbanip |
| /mute <player> [reason] | Permanently mute a player | weguardian.mute |
| /tempmute <player> <duration> [reason] | Temporarily mute a player | weguardian.tempmute |
| /unmute <player> | Unmute a player | weguardian.unmute |
| /muteip <player> [reason] | IP mute a player | weguardian.muteip |
| /tempmuteip <player> <duration> [reason] | Temp IP mute a player | weguardian.tempmuteip |
| /unmuteip <player> | Unmute a player's IP | weguardian.unmuteip |
| /kick <player> [reason] | Kick a player | weguardian.kick |
| /punish <player> | Open punishment GUI | weguardian.punish |
| /history <player> | View punishment history | weguardian.history |
| /weguardian reload | Reload configuration | weguardian.admin |

---

🔑 Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| weguardian.staff | All staff permissions | OP |
| weguardian.admin | Admin commands (reload) | OP |
| weguardian.bypass | Bypass all punishments | false |

---

⏱️ Duration Format

Durations support the following formats:

| Unit | Example | Description |
|------|---------|-------------|
| s | 30s | Seconds |
| m | 30m | Minutes |
| h | 6h | Hours |
| d | 7d | Days |
| w | 2w | Weeks |
| M | 1M | Months |
| y | 1y | Years |

Examples: 1h, 6h, 1d, 7d, 30d, 90d

---

⚙️ Configuration

Database (SQLite - Default)

database:
  type: "sqlite"
  sqlite:
    file: "punishments.db"

Database (MySQL)

database:
  type: "mysql"
  mysql:
    host: "localhost"
    port: 3306
    database: "weguardian"
    username: "root"
    password: "password"

Discord Webhook

discord:
  enabled: true
  webhook-url: "YOUR_WEBHOOK_URL"
  batch-interval-seconds: 5

Web Dashboard

web-dashboard:
  enabled: true
  host: "0.0.0.0"
  port: 8080
  admin-api-key: "YOUR_SECURE_KEY"

---

🛠️ Requirements

• Minecraft Server: Paper 1.21+ or Folia
• Java: 21 or higher

---

📚 Dependencies

• Paper API - Server API
• FoliaLib - Folia compatibility
• Caffeine - Caching
• HikariCP - Connection pooling
• ACF - Command framework
• FastInv - GUI framework
• bStats - Plugin metrics
• Javalin - Web framework

---

📞 Support

For support and questions, join our Discord or open an issue on GitHub.

---

📄 License

This project is licensed under the MIT License. See LICENSE.md for details.

---

Made with ❤️ by WeThink