Vanguard | Moderation Framework v1.2.5

NEW FEATURES

Customizable Admin Command: Server owners can now fully customize the main administration dashboard command. A new adminCommandAlias configuration setting has been added to config.json (defaults to "hyadmin"). Changing this value will register the new command, allowing you to hide the admin dashboard behind a secret alias of your choice.

COMPATIBILITY AND PERFORMANCE FIXES

Chat Crash Prevention (MySQL Wait Timeout Fix): Fixed a critical bug where long periods of chat inactivity (20-30 minutes) would cause the server to permanently freeze. The system that checks a player's active mute status when they type in chat now runs asynchronously. If the database connection drops or times out, Vanguard will re-establish the connection in the background without locking up the main game thread, preventing players from being kicked and the server from requiring a manual restart.

NEW IN v1.2.4

- ADMIN PAGE THREAD FIX: Resolved IllegalStateException when opening the admin UI from the spawn world (or any non-default world). The error "Assert not in thread! Thread[WorldThread - default] but was in Thread[WorldThread - spawn]" occurred because the admin page was reading other players' component data (e.g. position) from Stores belonging to different world threads. Component access is now restricted to the current world's Store only; position is shown only for players in the same world as the admin.

COMPATIBILITY FIXES

• Server API Update: Recompiled against Hytale server version 2026.02.19-1a311a592 for compatibility with the latest server build.

• Database Threading: All database access (punishments, player lookups, join checks) now runs on a single dedicated thread. This prevents multi-thread use of the shared JDBC connection, which was causing silent server freezes and connection corruption when issuing mutes, warnings, bans, or kicks.

• Punishment Commands: Mute, warn, temp mute, ban, temp ban, and kick now perform database and Discord logging on the DB thread, then run in-game feedback (messages, disconnect, broadcast) on the world thread. This stops the main game thread from being blocked and avoids “server freezes / infinite chunk loading / can’t reconnect” after using these commands.

• Player Join: Ban checks and player updates on connect now run on the same DB executor and no longer contend with the connection thread, so join flow remains stable with MariaDB/MySQL enabled.

• Discord Bot Startup: Discord bot connection no longer blocks server startup. Bot startup runs in a background thread so the server can finish initializing and accept players even when Discord is configured; the bot connects asynchronously and logs once ready.

• Self-Ban / Temp-Ban Disconnect (Deadlock Fix)

NEW FEATURES
- OFFLINE BAN SUPPORT: You can now punish players even when they aren't online!
- The plugin automatically resolves offline usernames to UUIDs by scanning the server's universe data.
- Supports: /hyban, /hytempban, /hymute, /hytempmute, and /hywarn for offline players.
- Smart Lookup: Checks both Nameplate and DisplayName components for 100% resolution accuracy.


SERVER COMPATIBILITY
- LATEST SERVER SYNC: Fully updated and recompiled for Hytale Server Version 2026.02.18 (Build f3b8fff95).

COMPATIBILITY FIXES

- Server API Update: Recompiled against the latest Hytale server version to resolve NoSuchMethodError crashes.

- Packet Handling: Validated PacketHandler.write usage in Vanish Command and Unvanish Command to match the new server method signatures.

We are proud to announce the next evolution of our project! As of version 1.2.0, Bans+ has officially transitioned to VANGUARD. Same powerful tools, brand new professional identity.

COMPLETE REBRANDING

• NEW NAME: Vanguard
• INTERNAL REFACTOR: Cleaner package structure and optimized performance under the hood!
• CODE CLEANUP: Removed deprecated internal references and streamlined event listeners for better server-side efficiency.

ESSENTIAL MIGRATION GUIDE
To ensure a smooth transition, admins MUST follow these steps:

1. UPDATE PERMISSIONS

• All permission nodes have been changed from bansplus.* to vanguard.*
• EXAMPLE: vanguard.admin, vanguard.ban, vanguard.mute
• Please update your existing permission groups (LuckPerms, etc.) to use the new "vanguard" prefix.

2. MIGRATE CONFIGURATIONS

• The plugin now reads settings from the /Hyronix_Vanguard folder.
• STEP: Copy the contents of your old /Hyronix_BansPlus folder directly into the new /Vanguard folder.
• STEP: Once confirmed working, you can safely delete the old /BansPlus directory.

DISCORD BOT ENHANCEMENTS

• CUSTOM STATUS: You can now set a custom "Playing" status for your bot in discordconfig.json!
• DEFAULT: play.example.com

NEW PLAYER REPORTING

• COMMAND: /hyreport
• SHORT ALIAS: /report
• PERMISSION: Default (All Players)

Spoiler: ReportUI

NEW BUG REPORTING

• COMMAND: /hybugreport
• SHORT ALIAS: /bugreport
• PERMISSION: Default (All Players)

Spoiler: BugReportUI

ADMIN MANAGEMENT TOOLS

• REPORT LIST: /hyreportlist (Alias: /reportlist)
• BUG LIST: /hybuglist (Alias: /buglist)
• PERMISSION: bansplus.admin

Spoiler: AdminPlayerReportList

Spoiler: ReportDetails

Spoiler: AdminBugReportList

Spoiler: BugReportDetails

ADMIN MENU INTEGRATION
We've added 2 brand new buttons directly into the /hyadmin menu:
REPORTS — Instant access to the Player Reports dashboard.
BUGS — Instant access to the Bug Reports dashboard.

Spoiler: HyadminList

DISCORD LOGGING & INTEGRATION

• REAL-TIME BROADCASTS: Every report and bug is sent directly to your staff Discord channels with detailed embeds.
• TRANSPARENCY: Track reporter names, targets, reasons, and timestamps without even leaving Discord.

Spoiler: DiscordReportLogs

FIX: Vanish Chat Visibility
Resolved issue where vanished players messages were hidden from others.

FIX: Vanish Visibility
Resolved issue where vanished players were still seen.

NEW: Customizable Freeze Messages
Added 5 new message keys to config.json for all freeze/unfreeze actions and reminders.

STABILITY & LOGIC
Fixed SkipSentryException (Async access) during vanish/unvanish operations.
Fixed physical invisibility ghosting after world transitions via new VanishListener.​