WeGuardian | Modern Punishment System v2.4

A modern, fast, and scalable Minecraft punishment system built for Paper & Folia servers.
# 🛡️ WeGuardian Changelog

## Version 2.4 – Full Messages & GUI Configuration Update

Release Type: Major Configuration & Customization Update
Focus: Flexibility, Localization, and Server Branding

---

## ✨ New Features

### 📁 Fully Configurable messages.yml

  • Added a dedicated messages.yml file to centralize all player-facing text
  • Every message is now configurable, including:

* Chat messages
* Error messages
* Success messages
* Notifications
* Titles & subtitles
* Action bar messages

### 🧩 GUI Customization (100% Configurable)

* All GUI elements are now configurable from messages.yml, including:

* GUI titles
* Item display names
* Item lores
* Buttons & descriptions
* Affected GUIs:

* Punishment GUI
* Duration GUI
* History GUI

### 🛠️ New Messages Management System

* Introduced a MessagesManager system to:

* Load and cache messages efficiently
* Support placeholders across all messages
* Ensure consistent formatting everywhere
* Uses MiniMessage-compatible formatting for modern text styling

---

## 🔄 Improvements

* Removed hardcoded strings from:

* GUI classes
* Input handlers (Reason input, Custom duration input)
* Command feedback messages
  • Improved maintainability and readability of the codebase
  • Easier localization for non-English servers
  • Server owners can now fully brand WeGuardian without touching source code

---

## 🧹 Developer & Admin Benefits

  • No recompiling required for message changes
  • Clean separation between logic and presentation
  • Future updates will automatically support new messages via messages.yml

---

## ⚠️ Notes for Updating

  • On first startup, messages.yml will be generated automatically
  • Servers upgrading from older versions should review and customize the new file
  • Old message values previously in config.yml are now handled via messages.yml

---

### ✅ Recommended

Update to WeGuardian v2.4 to unlock full control over messages, GUIs, and server presentation.

🛡️ WeGuardian v2.3 – Changelog

🐛 Bug Fixes

  • Fixed /unbanip unbanning the incorrect IP when a banned player’s account was previously used by another person
  • Fixed /unmuteip resolving and removing the wrong IP address
  • Fixed {player} and {staff} placeholders not working in ban, kick, and mute screens
  • Fixed MiniMessage formatting not being parsed correctly when combined with legacy (&) and color codes

✨ New Features

  • Added {player} placeholder support to all punishment screen messages
    (ban, kick, mute)
  • Added {staff} placeholder support to all punishment screen messages
    (ban, kick, mute)
  • Added full MiniMessage support alongside legacy color codes
    • Supports tags like <red>, <bold>, <gradient:red:blue>
  • Added hex color support in MiniMessage format
    • Example: <#FF5555>

📢 Broadcast System

  • Added broadcast messages for all punishment types, fully configurable via config.yml
  • Supported broadcasts:
    • Ban / Unban
    • Mute / Unmute
    • Kick
    • IP Ban / IP Unban
    • IP Mute / IP Unmute
  • All broadcast messages support placeholders:
    • {player}, {staff}, {reason}, {duration}, {expires}, {ip}

⚡ Improvements

  • Chat mute listener priority changed to HIGHEST with ignoreCancelled = false
    → Ensures mutes are enforced over all other plugins
  • Plugin now loads on STARTUP for earlier and safer initialization
  • IP punishments now store and resolve the original punished IP from the punishment record instead of the player’s current IP

📁 Config Updates

  • Updated messages.ban.screen to include {player} and {staff} placeholders
  • Updated messages.kick.screen to include {staff} placeholder
  • Updated messages.mute.blocked to include {staff} placeholder
  • Updated messages.mute.applied to include {staff} placeholder
  • Added broadcast sections for all punishment and IP punishment types

🔐 WeGuardian v2.2 – Database & Security Fixes



🐛 Fixes & Improvements​

  • Fixed MySQL index creation issues (now fully compatible with MySQL & SQLite).
  • Punishment broadcast messages now correctly use messages.prefix from config.yml.
  • Resolved a critical IP-ban bypass issue allowing alt accounts to join.
    • Improved IP normalization (IPv4 & IPv6-mapped IPv4)
    • Fixed IP ban cache logic so new bans apply instantly

ℹ️ Notes​

  • No database migration required
  • No config or permission changes
  • Safe drop-in update
## 📜 Changelog


### 🔧 Fixes & Improvements


* Fixed full tab completion for smoother command usage.

* Reworked parts of the MySQL Database Manager to improve performance and stability.



### 🆕 New Features



* Added Alt Detection to better track and manage alternate accounts.



### ❌ Removed



* The /stats command has been removed.

📢 Changelog​


  • Added new option in config.yml under web-dashboard:

    web-dashboard:
    enabled: false
    web-header-title: "WeGuardian"
    You can now change the web header title from WeGuardian to your own name. This will be applied across all web pages.
  • Improved Web UI with various fixes
  • Added support for tempipban, unbanip, and ipban commands
  • Expanded Player Management section in the web panel
  • Implemented automatic player IP fetching for punishments
  • Added proper validation checks for temporary vs permanent punishments

Critical & High Severity


  1. Request/Response Mix-up – prevented user data from being sent to wrong users.
  2. Potential Remote Code Execution (RCE) – fixed vulnerability with partial PUT requests.
  3. DoS in multipart upload – mitigated Denial of Service attacks.
  4. TOCTOU Race Conditions – fixed Time-of-Check to Time-of-Use timing issues.
  5. Resource Shutdown Issues – corrected improper resource management.
  6. Regular Expression Denial of Service (ReDoS) – in TimeUtils.java, unsafe regex patterns fixed.



Moderate & Low Severity


  1. Security constraint bypasses – ensured constraints cannot be bypassed.
  2. HTTP priority header DoS – mitigated potential Denial of Service via HTTP headers.
  3. CGI and rewrite rule bypasses – fixed vulnerabilities allowing rule circumvention.
  4. Unbounded Input Handling – limited maximum input length in time parsing.
  5. Unsafe Time Parsing – ensured integers are only parsed after regex validation.
EULA: Free EULA
2,954 Views
242 Downloads
Sep 14, 2025 Published
Dec 25, 2025 Updated
5.00 star(s)
Average rating (7)
24.8 MB File size
Open source
  1. Yes
DRM-free
  1. Yes
Unobfuscated
  1. Yes
AI use in marketing
No
AI use in product
No
Type
  1. Staff
  1. Equipment
  1. Core
Game mode
  1. Survival
  1. Factions
  1. Skyblock
Supported software
  1. Bukkit
  1. Spigot
  1. Paper
  1. Folia
  1. Purpur
Supported versions
  1. 1.21
Supported languages
  1. English
Includes DRM
No
Source access (legacy)
Open source
Creators
Recommended for you
A feature-rich teleport request plugin with GUI support and Folia compatibility.
5.00 star(s) 32 ratings
343 purchases
Dynamic random teleportation within defined regions for enhanced gameplay
5.00 star(s) 12 ratings
143 purchases
Fast and optimized, made for large Minecraft servers.
5.00 star(s) 11 ratings
134 purchases
Create immersive single-biome worlds with unique terrain and features.
5.00 star(s) 30 ratings
135 purchases
Full-featured team system with cross-server homes, permissions, GUI, and Folia support
5.00 star(s) 19 ratings
106 purchases
2,954 Views
242 Downloads
Sep 14, 2025 Published
Dec 25, 2025 Updated
5.00 star(s)
Average rating (7)
24.8 MB File size
Open source
  1. Yes
DRM-free
  1. Yes
Unobfuscated
  1. Yes
AI use in marketing
No
AI use in product
No
Type
  1. Staff
  1. Equipment
  1. Core
Game mode
  1. Survival
  1. Factions
  1. Skyblock
Supported software
  1. Bukkit
  1. Spigot
  1. Paper
  1. Folia
  1. Purpur
Supported versions
  1. 1.21
Supported languages
  1. English
Includes DRM
No
Source access (legacy)
Open source
Creators
Recommended for you
A feature-rich teleport request plugin with GUI support and Folia compatibility.
5.00 star(s) 32 ratings
343 purchases
Dynamic random teleportation within defined regions for enhanced gameplay
5.00 star(s) 12 ratings
143 purchases
Fast and optimized, made for large Minecraft servers.
5.00 star(s) 11 ratings
134 purchases
Create immersive single-biome worlds with unique terrain and features.
5.00 star(s) 30 ratings
135 purchases
Full-featured team system with cross-server homes, permissions, GUI, and Folia support
5.00 star(s) 19 ratings
106 purchases
Top