changelog

punishment GUI and escalation overhaul

1. made the gui 10X better
2. escalation overhaul deleted the old system and changed it to the new one. now you can do it like this for templates and escalation automatically (/ban player67 #Hacking) (/tempban Steve193 #extreme-jokes)

Changelog:

• remove auto mod entirely
• fixed performance on the newest version of folia
• fixed a potential error on load with velocity

🔴 Critical Fixes

• Fixed main thread blocking from .join() calls in ReportsCommand, NoteCommand, and MyReportsGuiManager. All database operations now use async callbacks with scheduler dispatch.
• Fixed synchronous Mojang API lookups in AltsCommand, HistoryCommand, ReportCommand, PunishCommand, and UnvoidJailCommand. Replaced deprecated Bukkit.getOfflinePlayer(String) with async UUID resolution using database cache and UuidUtil fallback.
• Fixed ConcurrentModificationException in AltService. Changed HashSet<UUID> to ConcurrentHashMap.newKeySet() for thread-safe alt collection across async database futures.
• Fixed offline player unjail trap. Players unjailed while offline are now flagged with pending_unjail in void-jail.yml and automatically teleported to their return location on next login.

🟠 High Priority Fixes

• Fixed async Bukkit API call in PunishmentService. Moved Bukkit.getOfflinePlayer() from CompletableFuture.supplyAsync() to scheduler.callSync() to comply with Paper/Folia thread safety rules.
• Fixed database thread pool overflow risk. Replaced CallerRunsPolicy with a custom rejection handler that logs a warning and discards tasks instead of executing them on the caller thread (which could be the main server thread).
• Fixed fail-open mute bypass in PlayerChatListener. On cache miss, chat messages are now cancelled while the async mute lookup completes. Messages are re-sent only if the player is confirmed unmuted.

🟡 Medium Priority Fixes

• Fixed memory leaks in ChatManager and ReportService. Added PlayerQuitEvent listeners to remove disconnected players from lastMessageTime and lastReportTime maps.
• Fixed settings GUI triggering full plugin reloads on the main thread. Config save and plugin.reload() now run asynchronously, with GUI reopen dispatched back to the main thread.
• Fixed inefficient N+1 subqueries in PunishmentDao. Replaced correlated subqueries (SELECT name FROM controlbans_history WHERE uuid = t.uuid ...) with LEFT JOIN controlbans_history across getRecentPunishments, getPunishmentHistory, getPunishmentById, and getAllPunishments.

🟢 Low Priority Fixes

• Fixed void jail command whitelist edge case. Added length check before event.getMessage().substring(1) to prevent issues when a player types only /.
• Fixed GUI cooldown feedback ignored in GuiListener. The report GUI now checks the submitReport() return value and displays a cooldown message if the report fails.
• Fixed brittle YAML string parsing in ConfigUpdater. Replaced primitive .replace("\"", "\\\"") with proper YAML escaping that handles special characters, multiline strings, booleans, numbers, and lists.
• Fixed zero-size pagination inconsistency in HistoryGuiManager. Changed Math.ceil(...) with manual if (maxPage == 0) maxPage = 1 to Math.max(1, (int) Math.ceil(...)) for consistency with AltsGuiManager.
• Fixed missing return statement in PlayerJoinListener blacklist check. Added explicit return after event.disallow() to prevent execution continuation and potential future bugs.

fixes & additions

• added modrinth update checker — staff with controlbans.admin will be notified in-game on join if a new version is available
• fixed /unipban and /unipmute now accepting a player name instead of requiring the raw IP address
• added missing /unipmute command entirely
• fixed IP address being exposed raw in staff alerts — now masked as 192.168.*.*
• fixed IP address being broadcast publicly in unban announcements — now staff-only
• fixed silent no-op when IP banning a player with no join history — now sends a proper error message
• fixed database executor being unbounded — now capped with backpressure to prevent thread storms under load
• fixed janitor not cleaning old kicks, warnings, and resolved reports — now purges all types on schedule
• fixed MongoDB having no janitor at all — expired records were accumulating forever
• fixed /unipban tab completer returning nothing — now suggests player names
• fixed premature "Banning..." message sending before the player lookup even completes
• fixed stale javadoc in IdUtil still saying 6-character IDs

fixes

• fixed database not properly updating the alt service
• fixed folia console error
• fixed performance on folia
• fixed a weird crash on startup with velocity and bungeecord (rare)
• fixed the freeze manager not properly unfreezing
• fixed the muting system once again

The fix:

1. a weird issue with discord SRV now fully fixed and logging properly
2. fixed a very rare database error that's pretty much it

Please check out 5.0-devbuild to see what I have changed and updated but for this Pacific changlog

1. fix the weird issue where the message duplicates with chat features (lock|slow)
2. Fixed where the mutes won't unmute player after expire or unmute. They would have to relog. So now that is fully fixed.

🚀 ControlBans 5.0 - The Reports Update ✨ New Features & Additions:

"My Reports" Tracking System: Added a brand new premium paginated GUI. Players can run /reports to seamlessly view all of their previously submitted reports and check if they are actively being handled. Staff Resolutions: Added the /reports resolve command. Staff can now update active reports to PENDING, RESOLVED, or REJECTED, updating the player's personal UI dynamically with color-coded icons! Global Localization Auto-Sync: The new reporting menus natively support all 10+ bundled foreign languages right out of the box—updating cleanly without tearing up your heavily customized translations. 🐛 Bug Fixes & Architecture Refactors:

Indestructible Mutes & Locks: Fixed an issue where third-party chat formatting plugins (like EssentialsChat) could override the plugin. ControlBans now executes its Mute and Chat-Lock evaluations at the HIGHEST priority, guaranteeing that blocked chats are halted dead in their tracks. Cleaned up trailing compilation errors involving duplicate command alias registration in ReportsCommand. Congratulations on officially completing version 5.0! Let me know if there are any other plugins or features you want to build next!

What’s new:

• Expanded the escalation system with history windows, punishment-type filters, and reason aliases.
• Added the missing config sections for anti-spam, anti-caps, voice mute bossbars, and LiteBans import settings.
• Improved staff alert flow so important moderation signals are cleaner and more consistent.
• Finished wiring more GUI, rollback, AutoMod, and punishment prompts into the language system.

Fixes and improvements:

• MongoDB storage support is now much more complete and aligned with the main storage contract.
• Proxy punishment messages now preserve formatting correctly across supported platforms.
• Login checks were improved to avoid unnecessary blocking during slow lookups.
• Missing permission nodes were cleaned up for better admin control.
• Config and locale files now backfill missing keys automatically, which helps older installs update more safely.

Notes:

• All bundled locale files are now accounted for, and missing keys fall back cleanly.
• New locale entries will default to English until custom translations are added.

v4.8-HF1: Alt-System Data Integrity Hotfix

This is a critical hotfix that resolves a data cross-contamination issue within the Alternate Account tracking system. All users are strongly advised to update.

🐛 Bug Fixes

• [CRITICAL] Alt Cross-Contamination: Fixed an issue where punishing offline players or having a misconfigured proxy (broken IP-forwarding) would log placeholder IPs (such as 0.0.0.0 or 127.0.0.1) into the history table. The Alt GUI previously treated these as valid IPs, falsely linking unrelated players together as alts.
• The system now utilizes a strict quarantine filter that completely ignores local, loopback, and placeholder IPs when calculating alternate accounts.

Note: No database reset is required. The plugin will automatically ignore any bad IP data already existing in your database, instantly fixing the /alts GUI upon restart.

v4.8: Shadow Mutes, Staff Rollbacks & Smart AutoMod

This update introduces highly requested enterprise-grade moderation tools and automated background maintenance to keep your server safe and fast.

✨ New Features

• Shadow Mutes (/shadowmute <player>): The ultimate anti-troll weapon. Shadow-muted players can still type in chat and see their own messages, but their messages are completely hidden from everyone else. They are silently ignored without realizing they have been punished.
• Staff Rollbacks (/cb rollback <staff> <time>): Protect your network from compromised or rogue staff accounts. Instantly revert every action a specific staff member took within a given timeframe (e.g., /cb rollback RogueMod 1h).
• Expanded AutoMod: Added asynchronous Anti-Spam (prevents message flooding and duplicate messages) and Anti-Caps (automatically converts ALL CAPS messages into lowercase text, reducing player friction).

🛠️ Optimizations & Maintenance

• Automated Database Janitor: Added a silent background thread that runs once every 24 hours. It safely purges temporary punishments that expired more than 30 days ago, preventing long-term database bloat and keeping queries lightning fast.
• Config Auto-Updater: The plugin will automatically append the new AutoMod configuration sections to your existing config.yml without overwriting your current settings.

Note: To use the new commands, ensure you assign the controlbans.shadowmute and controlbans.admin.rollback permissions to your administrators.

https://tawnye.github.io/ControlBansWeb/updates.html

There's a lot of stuff that has changed, and I cannot remember 90% of it, but I have done a few things. I reworked the database and how it works entirely, so you may have to actually reload the database entirely. But you can always save it in the JSON thing or the export command, and it should work completely fine. The messages have been updated for each of languages. There's a few things that I just cannot remember, so there may be some edge cases in this version. I'm not going to come back fully, but I will every now and then try to update the plugin as needed and or emergency updates. So sorry for the long wait. Oh, and a few things. This version has support for Bungie and Velocity. Now you don't need multiple plugins to do one simple thing. But if you have any issues with that, you can always contact me on Discord.

You can find the update(log) here:

https://tawnye.github.io/ControlBansWeb/updates.html

changelog:

• revamped all language files to be 10 times better and more premium feel.
• fixed potential issues and performance hits

1. potential fix for AI moderation failing during leg spikes, 2. fixed the chat database caching on mute not properly sinking so causing chat to look slow.

changelog:

1. Fixed a database issue where it deteriorates over time and causes issues.

2. Fixed an issue where you're not able to unmute voice chat players. (/voiceunmute)

3. Enhanced the history and alts GUI.

straightforward and simple change log:

1. added two new databases h2 and MongoDB

2. fixed most of the language files because they were incomplete or some of them were just old and not correct at all

3. added a new language file nl(Dutch)

4. fixed the ID system having a heart attack and not wanting to comprehend database checks.

That is pretty much all I could think of to add to this. I hope you enjoyed the new update. It's been out for a while, but I just forgot to update it on modrinth.

New features:

1. Simple voice chat integration You're able to mute players now

/voicemute
/voiceunmute

Fixes:

1. Fixes potential crashes
2. Fixed a memory leak (found by random user)
3. Fixed void jail corrupting its own files so the jail didn't work at all on startup or reload
4. Fixed bedrock users not able to be banned on certain servers.
5. Fixed UuID issue
6. Fixed voice chat service

Change log:

Fixes Closed a critical issue that caused the display of a generic “database error” instead of “player not found” error messages in cases of punishment attempts either with non-existent player names or with erroneous player names.

Fixed an issue with the Void Jail system that would result in its failure during the process of blocking commands due to an internal variable problem.

Fixed the issue that was causing the Void Jail to function improperly for those who had logged in while in jail.

Corrected the problem with Geyser/Floodgate integration that was utilizing the wrong method to find the player's UUID in Bedrock.

Changes The Void Jail has also received an added function to be utilized as a temporary mute within the game's chats. Jailed players are no longer allowed to communicate within public chats and will get a customized message if attempted.

New features Cross-Server Punishment Synchronization: A robust messaging component has been established within BungeeCord and Velocity to facilitate communication among servers. If a punishment is made or cancelled on one server, an immediate signal is sent to all other servers to ensure synchronized punishment application.

The Void Jail: A significant new psychological punishment gameplay element has been added. /voidjail : Locks the player in an isolated void cell that prevents any movement, action, damage, and most commands. /unvoidjail : This releases the player from jail and returns them to their original position.

Skin Ban: A new 'non-public' punishment option has been added. /banskin : Strips the custom skin from the player, making them look like Steve/Alex to every player. The ban is permanent and will stay with them even after logout. /unbanskin : Enables a player's use of his skin by kicking him out of the server to refresh his profile.

Geyser/Floodgate Integration: The plugin will now be able to properly punish Bedrock players by checking the prefix (e.g. .Steve).