\n
\n
\n
\n
# \ud83d\udee1\ufe0f WeGuardian<\/p>\n
\n
\n
\n
\n
\n \n<\/p>\n
\n Professional Punishment Management System for Minecraft Servers<\/b>
\n by WeThink<\/i>\n<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### \ud83d\udd28 Punishment System
\n– **Ban & TempBan** – Permanently or temporarily ban players
\n– **IP Ban & TempIP Ban** – Ban players by IP address with automatic IP resolution
\n– **Mute & TempMute** – Silence players permanently or temporarily
\n– **IP Mute & TempIP Mute** – IP-based muting system
\n– **Kick** – Instantly remove players from the server<\/p>\n
### \ud83c\udfae Interactive GUI
\n– **Punishment GUI** – Beautiful and intuitive punishment selection interface
\n– **Duration Selector** – Easy-to-use duration selection with presets
\n– **History Viewer** – Browse punishment history with pagination<\/p>\n
### \ud83d\udcca Database Support
\n– **SQLite** – Zero-configuration local storage (default)
\n– **MySQL** – Scale to larger servers with MySQL support
\n– **HikariCP** – High-performance connection pooling
\n– **Caffeine Caching** – Lightning-fast data retrieval<\/p>\n
### \ud83c\udf10 Web Dashboard
\n– Built-in web panel for remote management
\n– REST API for custom integrations
\n– Configurable branding and appearance<\/p>\n
### \ud83d\udd17 Discord Integration
\n– Webhook logging for all punishments
\n– Batched messages to avoid rate limits
\n– Beautiful embed formatting<\/p>\n
### \u26a1 Performance
\n– **Folia Support** – Full compatibility with Folia servers
\n– **Async Operations** – Non-blocking database operations
\n– **Lazy GUI Initialization** – Optimized GUI performance<\/p>\n
—<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
1. Download the latest `WeGuardian.jar`
\n2. Place it in your server’s `plugins` folder
\n3. Restart your server
\n4. Configure `plugins\/WeGuardian\/config.yml`<\/p>\n
—<\/p>\n
## \ud83d\udcdd Commands<\/p>\n
| Command | Description | Permission | —<\/p>\n ## \ud83d\udd11 Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## \u23f1\ufe0f Duration Format<\/p>\n Durations support the following formats:<\/p>\n | Unit | Example | Description | **Examples:** `1h`, `6h`, `1d`, `7d`, `30d`, `90d`<\/p>\n —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n ### Database (SQLite – Default) ### Database (MySQL) ### Discord Webhook ### Web Dashboard —<\/p>\n ## \ud83d\udee0\ufe0f Requirements<\/p>\n – **Minecraft Server:** Paper 1.21+ or Folia —<\/p>\n ## \ud83d\udcda Dependencies<\/p>\n – Paper API – Server API —<\/p>\n ## \ud83d\udcde Support<\/p>\n For support and questions, join our Discord or open an issue on GitHub.<\/p>\n —<\/p>\n ## \ud83d\udcc4 License<\/p>\n This project is licensed under the MIT License. See [LICENSE.md](LICENSE.md) for details.<\/p>\n —<\/p>\n \n Made with \u2764\ufe0f by WeThink<\/b><\/p>\n","protected":false},"excerpt":{"rendered":" WeGuardian is a modern punishment plugin for single servers and server networks, offering reliable ban, mute, and kick management with a clear and customizable punishment system.<\/p>\n","protected":false},"featured_media":169473,"template":"","meta":{"_minecraft_slug":"weguardian","_minecraft_project_id":"QsS6k1xF","_minecraft_author":"WeThink25","_minecraft_license":"MIT","_minecraft_downloads":670,"_minecraft_follows":9,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"weguardian.zip","_minecraft_size_bytes":285661326,"_minecraft_version_count":13,"_minecraft_updated_at":"2026-05-16T09:45:26.545913Z","_minecraft_date_created":"2025-09-15T06:33:32.545249Z","_minecraft_date_modified":"2025-12-25T02:35:06.984641Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/weguardian","_minecraft_icon_attachment_id":169473,"_minecraft_imported_at":"2026-06-09T20:14:35+00:00","_minecraft_import_hash":"ee39e97842360e2309afd648b653ad83","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,88,125,126,90,127,128,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-169472","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-equipment","mod_category-folia","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/ban
\n| `\/tempban
\n| `\/unban
\n| `\/banip
\n| `\/tempbanip
\n| `\/unbanip
\n| `\/mute
\n| `\/tempmute
\n| `\/unmute
\n| `\/muteip
\n| `\/tempmuteip
\n| `\/unmuteip
\n| `\/kick
\n| `\/punish
\n| `\/history
\n| `\/weguardian reload` | Reload configuration | `weguardian.admin` |<\/p>\n
\n|————|————-|———|
\n| `weguardian.staff` | All staff permissions | OP |
\n| `weguardian.admin` | Admin commands (reload) | OP |
\n| `weguardian.bypass` | Bypass all punishments | false |<\/p>\n
\n|——|———|————-|
\n| `s` | `30s` | Seconds |
\n| `m` | `30m` | Minutes |
\n| `h` | `6h` | Hours |
\n| `d` | `7d` | Days |
\n| `w` | `2w` | Weeks |
\n| `M` | `1M` | Months |
\n| `y` | `1y` | Years |<\/p>\n
\n“`yaml
\ndatabase:
\n type: “sqlite”
\n sqlite:
\n file: “punishments.db”
\n“`<\/p>\n
\n“`yaml
\ndatabase:
\n type: “mysql”
\n mysql:
\n host: “localhost”
\n port: 3306
\n database: “weguardian”
\n username: “root”
\n password: “password”
\n“`<\/p>\n
\n“`yaml
\ndiscord:
\n enabled: true
\n webhook-url: “YOUR_WEBHOOK_URL”
\n batch-interval-seconds: 5
\n“`<\/p>\n
\n“`yaml
\nweb-dashboard:
\n enabled: true
\n host: “0.0.0.0”
\n port: 8080
\n admin-api-key: “YOUR_SECURE_KEY”
\n“`<\/p>\n
\n– **Java:** 21 or higher<\/p>\n
\n– FoliaLib – Folia compatibility
\n– Caffeine – Caching
\n– HikariCP – Connection pooling
\n– ACF – Command framework
\n– FastInv – GUI framework
\n– bStats – Plugin metrics
\n– Javalin – Web framework<\/p>\n