🛡️ 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

Each punishment type now requires its specific permission (weguardian.ban, weguardian.tempban, weguardian.mute, weguardian.tempmute, weguardian.kick) to be used through the GUI, matching the behavior of the command-based system.

🛡️ 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

🔑 Permissions

⏱️ Duration Format

Durations support the following formats:

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