Zenith-Mod v1.2.4 Update

🎨 New Feature: Ban List GUI

A powerful, interactive GUI system for managing bans!

Zenith-Mod now includes a comprehensive ban list interface that makes it easier than ever to view, filter, and manage player bans directly from an in-game GUI.

✨ Key Features

Interactive Ban List GUI

• Visual Ban Overview: Browse all bans in a beautiful, organized GUI
• Player Heads: See player avatars for each banned player
• Detailed Information: View ban reason, staff member, case ID, date, duration, and status at a glance
• Click to View Details: Click on any ban to see full information

Advanced Filtering System

• Active Bans: Filter to show only currently active bans
• Expired Bans: View bans that have expired or been lifted
• Player Bans: Filter to show only player-specific bans
• IP Bans: Filter to show only IP-based bans
• All Bans: View complete ban history

Pagination Support

• Navigate through large ban lists with ease
• Page indicators show your current position
• Smooth navigation between pages

Quick Actions

• Unban Directly from GUI: Unban players with a single click (requires permission)
• Detailed View: Click any ban to see complete information including:
  • Player UUID and IP address
  • Full ban reason
  • Staff member details
  • Case ID
  • Ban date and duration
  • Current status (Active/Expired/Unbanned)

🎯 Configuration

The ban list GUI is fully configurable via modules/banlist.yml:

• Customizable GUI Titles: Use hex colors and small caps formatting
• Configurable Item Lore: Customize what information is displayed
• Filter Button Positions: Arrange filter buttons as you prefer
• Material Customization: Choose different materials for active/expired/IP bans
• Variable Support: Use placeholders like {player_name}, {reason}, {case_id}, etc.
• Color Utils Support: Full support for %smcaps% and hex colors (&#RRGGBB)

🔐 Permissions

• zenith.banlist - Access to /banlist command
• zenith.banlist.unban - Unban players from the GUI

📋 Usage

Simply use the /banlist command to open the ban list GUI. From there, you can:

1. Browse all bans with pagination
2. Apply filters to narrow down results
3. Click on any ban to view detailed information
4. Unban players directly from the detail view (if you have permission)

🎨 Customization Examples

The ban list GUI supports extensive customization through the configuration file:

gui:
  title: '&#00FFAA%smcaps%BAN LIST%smreset%'
  ban_item:
    name: '&#FF5555{player_name}'
    lore:
      - '&#AAAAAAReason: &#FFFFFF{reason}'
      - '&#AAAAAAStaff: &#FFFFFF{staff_name}'
      - '&#AAAAAACase ID: &#FFFFFF{case_id}'

All text supports:

• Hex colors (&#RRGGBB)
• Small caps formatting (%smcaps%...%smreset%)
• Variable placeholders ({player_name}, {reason}, etc.)
• Standard Minecraft color codes

🔧 Technical Details

• Asynchronous Loading: Ban data is loaded asynchronously to prevent server lag
• Session Management: Player sessions track current filter and page state
• Efficient Filtering: Smart filtering system handles large ban lists efficiently
• Thread-Safe: All GUI operations are properly synchronized

📊 Integration

The ban list GUI integrates seamlessly with:

• Existing ban system
• History tracking
• Case ID system
• Unban functionality
• Staff notification system

⚠️ Breaking Changes

None - This update is fully backward compatible. All existing commands and functionality work exactly as before.

🔄 Migration Notes

• No configuration changes required
• The ban list module is enabled by default
• New configuration file modules/banlist.yml will be created automatically
• All existing bans are immediately visible in the GUI

📝 Files Changed

New Classes

• me.kzlyth.modules.banlist.BanListModule
• me.kzlyth.modules.banlist.BanListConfig
• me.kzlyth.modules.banlist.gui.BanListGUI
• me.kzlyth.modules.banlist.gui.BanDetailGUI
• me.kzlyth.modules.banlist.gui.BanListGUIHandler
• me.kzlyth.commands.admin.BanListCommand

New Configuration

• modules/banlist.yml - Complete GUI configuration

Enhanced

• ZenithMod - Added ban list module initialization
• plugin.yml - Added /banlist command and permissions

---

🎉 Enjoy the new ban list GUI! This feature makes ban management more intuitive and efficient than ever before.

📢 Note: The ban list GUI requires players to have the zenith.banlist permission. Make sure to grant this permission to your staff members.