🎉 BanMenu Update 1.4.2

Update from 1.4.1 to 1.4.2

Thank you for using BanMenu!
Version 1.4.2 introduces a fully configurable maintenance system with dynamic MOTD and server icon handling, including deep Minecraft and Discord integration.

This update focuses on server availability control, player flow during maintenance, and visual server state management.

✨ New Features

🧱 Server State Management (Maintenance, MOTD & Icons)

🚧 Advanced Maintenance Mode

• New global maintenance system with full control over player access.
• Activate maintenance using:
  • /maintenance on
  • /maintenance on <time>
  • /maintenance off
• Supported time units:
  • s (seconds), m (minutes), h (hours), d (days)
    Example: /maintenance on 10m, /maintenance on 2h, /maintenance on 1d
• If no timer is provided, maintenance is enabled immediately and a configurable kick countdown (defined in maintenance.yml) starts.
• If a timer is provided, it defines the duration of the maintenance mode, after which maintenance is automatically disabled.
• During an active countdown:
  • Players without banmenu.maintenance.join are kicked once the countdown expires.
  • Players with banmenu.maintenance.join may join even while the countdown is running.
• Fully configurable kick, join, and maintenance messages.

⏳ Dynamic Countdown System

• Countdown time formatting adapts automatically based on remaining duration:
  • > 48 hours → days only (e.g. 5 days)
  • > 24h & ≤ 48h → days + hours (e.g. 1 day 14 hours)
  • ≥ 2h & ≤ 24h → hours only
  • ≥ 60m & < 120m → hours + minutes
  • ≥ 2m & < 60m → minutes only
  • ≥ 60s & < 120s → minutes + seconds
  • < 60s → seconds only
• All time unit names are configurable in maintenance.yml.

📊 Maintenance Bossbar

• Optional bossbar displayed only during maintenance.
• Shows dynamic countdown information.
• Bossbar visibility is permission-based:
  • Only players with banmenu.maintenance.bossbar.show will see it.
• Fully customizable text and appearance.

🌐 Dynamic MOTD System

• New motd.yml with support for:
  • Multiple MOTDs
  • Random MOTD selection per server refresh
• Separate MOTD pools for:
  • Normal operation
  • Maintenance mode
• Maintenance MOTDs are only active if explicitly enabled.
• MOTDs automatically switch based on server state.

🖼️ Dynamic Server Icon System

• New server-icons/ directory structure.
• Supports:
  • Multiple server icons
  • Random icon per server refresh
• Separate icon pools for:
  • Normal operation
  • Maintenance mode
• Maintenance icons are only used if enabled.
• Icons automatically switch together with maintenance state.

🤖 Discord Integration

• All maintenance commands are available via Discord:
  • /maintenance on
  • /maintenance on <time>
  • /maintenance off
• Command availability via Discord depends on:
  • Properly configured Discord integration
  • Linked Minecraft permissions
• Current permission checks are based on Minecraft permissions.
• Planned feature: native Discord role-based permission checks.

🔐 New Permissions

🔧 Technical Changes

• New configuration files:
  • maintenance.yml
  • motd.yml
• New directory structure:
  • server-icons/
• All existing configuration files have been extended.
• Internal refactoring for:
  • Improved maintenance state handling
  • Optimized server ping logic for MOTD & icon refresh
  • Better synchronization between server state and visual output

⚠️ Important Notes

• Backup recommended before updating.
• This update introduces soft breaking changes.
• Recommended update process:
  1. Create backups of all configs.
  2. Stop the server.
  3. Delete the BanMenu plugin folder.
     • SQLite users may keep the database file.
     • MySQL users do not need any database changes.
  4. Start the server to regenerate fresh configs.
  5. Manually transfer configuration values section by section from backups.
• Server restart required after updating.
• Test maintenance permissions and Discord integration before production use.

🎉 BanMenu Update 1.4.1

Update from 1.4.0 to 1.4.1

Thank you for using BanMenu! Version 1.4.1 brings new features, improvements, and bugfixes for Discord integration and the Unverify system.

✨ New Features

🔄 Discord Role Sync

• default-role for unmapped Minecraft groups.
• /role give now optionally removes all mapped roles before adding the assigned role.
• /dc-sync keeps roles players should retain based on their Minecraft groups.

🛡️ Role Change Restrictions

• Protect Discord roles (cant-change-user-with-discord-role) and Minecraft groups (cant-change-user-with-minecraft-role).
• Self-modification protection; bypass with banmenu.discord.role.change.ignore.
• Configurable error messages.

🔓 Unverify System

• Codes stored in database (discord_unverify) with automatic expiry.
• Tab-completion for /dc-unverify confirm <code> works for Java & Bedrock.
• Multi-line messages with {code} placeholder.
• Bedrock support improved (SUGGEST_COMMAND, correct button formatting).

🐛 Bugfixes

• Discord button formatting for Bedrock fixed.
• Tab-completion for Unverify codes fixed.
• /dc-sync removes only mapped roles.
• Codes no longer lost on server restart.

🔧 Technical Changes

• New configs in discord_role-permissions.yml and discord.yml.
• New permission: banmenu.discord.role.change.ignore.
• Refactored code for better Bedrock support and optimized database queries.

📋 Notes

• No breaking changes; fully backward compatible.
• Backup configs and database before updating.
• Restart server after replacing the jar.
• Test default role, role protection, and Unverify codes.

🎉 BanMenu Update 1.4.0

Update from 1.3.1 to 1.4.0

Thank you for using BanMenu! Here are the most important changes and new features in this version:

✨ New Features

🤖 Discord Rules Bot

• Quiz system improved: Conducted directly in the Rules channel with ephemeral messages (no DMs anymore)
• Better overview: Only summary at the end, no immediate feedback after each question
• Verification check: Players with the role-to-assign role don’t need to retake the quiz
• Multilingual support: “Already verified” messages configurable in discord_rules_bot.yml (DE/EN)

🎯 Discord Role Management

• Flexible role management via Discord Slash Commands
• Group-based permissions: Admin/Moderator groups with individual rights
• New config: discord_role-permissions.yml for flexible role management
• Slash Commands: /role give & /role remove
• Minecraft integration: Roles also manageable via /discord-role

🔄 Role Synchronization

• Bidirectional: Minecraft groups ↔ Discord roles
• Configurable priority: minecraft, discord, or both
• Manual sync: /dc-sync for self- or other-player synchronization
• Customizable messages: All /dc-sync messages configurable via config

📝 Discord Slash Commands

• All Rules Bot commands now available as Slash Commands
• Configurable channel restrictions
• Always registered, even if modules are disabled
• New IDs: rule-config-channel-id & role-permission-set-channel-id
• Multi-line help messages in embed format

📁 Configuration Improvements

• Discord configs moved to subfolder Discord-Configs/
• New files: discord_role-permissions.yml, extended discord.yml
• Many messages now configurable

🐛 Bug Fixes

Discord Integration

• Fixed IllegalStateException on /role give
• Fixed permission issue for /discord-role
• Discord ↔ Minecraft sync now works correctly
• Fixed IllegalAccessException in LuckPerms
• Graceful shutdown warnings removed

General

• More stable LuckPerms integration
• Improved GroupManager support
• Enhanced logging for better debugging

🔧 Technical Changes

New Commands

• /dc-sync – manual sync for yourself
• /dc-sync <player> – sync for other players (requires banmenu.discord.role.sync.other)

New Permissions

• banmenu.discord.role.sync.use – self sync
• banmenu.discord.role.sync.other – other-player sync
• banmenu.discord.role.use – use /discord-role

Code Improvements

• Refactored DiscordRoleSyncManager
• Optimized error handling & logging
• Improved JDA integration

📋 Important Notes

⚠️ Breaking Changes

• All Discord configs now in plugins/BanMenu/Discord-Configs/
• Move config files after updating
• New discord_role-permissions.yml created on first start

📥 Update Instructions

1. Backup your config & database
2. Replace old banmenu-*.jar
3. Move Discord configs to the new folder
4. Restart your server
5. Check new options in discord_role-permissions.yml

💡 Recommendations

• Enable Discord Role Sync: discord-role-sync: true
• Check & assign permissions
• Test features on a test server before production

📚 Documentation

• German: BanMenu Documentation DE (PDF)
• English: BanMenu Documentation EN (PDF)

🙏 Feedback & Support

• Website: endcrystal.eu
• Forum: endcrystal.eu/forum
• Discord: Support Server

Enjoy BanMenu 1.4.0! 🎉
Developed by EndCrystalTV

Summary / Description: BanMenu is a powerful, modular Minecraft moderation plugin with a GUI, ticket system, Discord integration, and comprehensive punishment management. It supports Spigot, Paper, multi-server setups (BungeeCord, Velocity), and cross-platform servers via Geyser/Bedrock.

Features:

Ban, Mute & Kick system with temporary and permanent punishments

Intuitive GUI for fast moderation and punishment management

Ticket system with Open, Closed, and Reopened status

Discord integration with verification, notifications, and optional cross-ban/unban

IP tracking, optional VPN detection, chat filter, and chat delay

Complete history & statistics of all moderation actions

Multi-server, MySQL & SQLite support, PlaceholderAPI, LuckPerms & GroupManager integration

Fully configurable via YAML, multi-language support (English & German)

Changelog v1.3.1:

Added modular structure for all features (Ban, Mute, Kick, GUI, Ticket, Discord)

Optimized performance for multi-server setups

Improved GUI menu and Discord integration stability

Minor bug fixes and overall stability improvements