ServerManagement+

# Changelog — ServerManagement+ v2.1.1-b1 (Minecraft 1.20.1) **Release Date:** Jul 16, 2026 **Latest Changes:** Jul 16, 2026 **Minecraft:** 1.20.1 | **Forge:** 47.4.0 | **Fabric:** 0.92.8+1.20.1 (loader 0.19.2) | **Branch:** `mc/1.20.1` *** ## Overview v2.1.1-b1 introduces a completely overhauled, bifurcated updater architecture. It brings independent dual-query support for Modrinth and CurseForge, an intelligent server-side smart start script generator, and strips out the obsolete legacy OTA networking framework to provide a cleaner, more robust update experience. *** ## Key Features & Improvements ### Updater Architecture Overhaul * **⚠️ Important Notice**: This specific update (v2.1.1-b1) must be downloaded and installed manually on both the server and the client one last time. Once this version is installed, the new automatic updater will take over seamlessly for all future releases. * **Dual-Query Support**: The updater now queries both Modrinth and CurseForge independently for updates. * **Standalone Handoff**: Extracts and runs a standalone `updater.jar` that can safely overwrite the mod file while the server is offline. * **Graceful Shutdown**: The server gracefully shuts down prior to applying updates, ensuring world data is safely saved and standard ports are freed. * **Smart Build Number Comparison**: The updater's version comparison logic now accurately handles build numbers (e.g., `2.1.0-b1` vs `2.1.0-b2`) for more granular patch detection. * **Update Check Logic Fix**: Updated the hardcoded base version string across the updater logic (e.g., in `CheckForUpdatesPacket` and `ServerUpdateScheduler`) from `"2.0.0"` to `"2.1.1-b01"`, fixing false-positive update notifications when admins manually clicked "Check for Updates" or upon joining the server. ### Smart Start Integration * **Script Generator**: A new `StartScriptGenerator` scans the server root for existing launch scripts (`.bat` / `.sh`) and intelligently injects the `-Dservermanagement.smartstart=true` flag. * **Auto-Override & Fallbacks**: Admins can now opt to automatically override their existing run scripts (safely backing up the originals as `.bak`). If no override is chosen, standalone `smart_start.bat` / `.sh` fallbacks are generated. * **Self-Cleaning System (`cleanupIfNeeded`)**: The generator was optimized to cleanly bypass startup generation if manual scripts are present. If the mod detects that the smart-start flag is successfully integrated into the main `run.bat` / `run.sh`, it will automatically clean up the redundant `smart_start` fallback files from the server root. * **Flag Management**: `update_in_progress.flag` and `update_finished.flag` are dynamically created to handle the update loop and are aggressively cleaned up during server startup to prevent false update loops after manual overrides. ### Legacy OTA Cleanup * **Removed Obsolete Architecture**: The `com.servermanagement.ota` packages (including `PlayerJoinListener`, `CurseForgeUpdateChecker`, `OTAVersion`) have been completely deleted from both Forge and Fabric. * **Network De-clutter**: Deleted the `ModFileTransferManager` and its corresponding packets (`VersionCheckPacket`, `ModFileRequestPacket`, `ModFileChunkPacket`, `ModFileCompletePacket`). * **Config Cleanup**: The server automatically deletes any leftover `curseforge.properties` file from previous installations to prevent console warnings on startup. * **Log Polish**: Replaced the global `Constants.LOG` with a dedicated `ServerManagementUpdater` logger so updater checks properly log as `[ServerManagementUpdater/INFO]`. ### General Tweaks & Bug Fixes * **Handshake Parity Fix**: * Enforced strict client-side mod requirement during network handshakes (Fabric). Vanilla clients or clients missing the mod are now gracefully rejected with a helpful disconnect message (`§cThis server requires the ServerManagement+ mod to be installed on your client!`), preventing server-side errors and breaking functionality. * Fixed a subsequent issue where valid Fabric clients were also being rejected by switching the handshake validation from the Forge-specific `main` channel to the cross-loader `SyncSessionTokenPacket.ID`. * **Updater GUI Polish & Fixes**: * Fixed `UpdaterScreen` and `PerformanceSettingsScreen` going off-screen upon window resizing. This was caused by overriding `Screen.rebuildWidgets()` in 1.20.1 without a super call, which bypassed the standard GUI initialization and scaling update matrix. Now properly uses `refreshWidgets()`. * Fixed update screen layouts (`UpdateAvailableScreen` and `OTAUpdateScreen`) going off-screen on narrow window sizes by implementing responsive vertical stacking and dynamic text width constraints. * Added a visual `Checking for updates…` loading animation in `UpdaterScreen` utilizing the new container tick loop, and ensured the GUI automatically sends a check packet when opened empty. * **Chat Formatting Fix**: The `ServerManagement Dashboard` welcome notification in chat no longer wraps text aggressively on standard 320px chat widths (formatting dividers reduced from 39 to 30 characters). * **Background Blur Shader Fix**: Resolved custom GUI background blur shader black rendering issues on modern GPU drivers by pivoting to GLSL 1.50 (`#version 150`) under the `servermanagement` namespace. * **Network Architecture Refactor (Fabric)**: Rewrote Fabric networking for 1.20.1 using the legacy `ServerPlayNetworking` / `ClientPlayNetworking` API, establishing uniform `IPacket` registries to mirror the Forge implementation. * **Build & Artifact Fixes**: * Cleaned up Gradle cache file locks and eliminated duplicate project compilation definitions in `settings.gradle`. * Mod version output double 'b' (`2.1.1-bb01`) in JAR outputs and logs has been normalized against `multiloader-common.gradle`. * Fixed broken em-dash formatting (`—`) on the Forge mods screen by stripping special characters in `gradle.properties`. * **Repository & Documentation Cleanup**: * Removed obsolete `build-full.txt` output log from the repository and explicitly untracked `description.md` from version control. * Added a comprehensive "How the Updater Works" section to `README.md` and `description.md` for full transparency with manual reviewers. * Provided explicit instructions for code reviewers on how to safely simulate an outdated mod and test the updater architecture using a cloned workspace.