ServerSwitch

ServerSwitch 2.1.0

Summary

ServerSwitch 2.1.0 is a major feature release with 33 new modules for routing, security, player experience, analytics, integrations, and network operations — across Spigot/Paper, BungeeCord, and Velocity. ---

New Features

Network & Routing

- Maintenance Mode — Put individual servers into maintenance; blocks joins and proxy switches - Player Affinity Routing — Remembers preferred servers per player in the database - Geographic Routing — Region-based server mapping (EU/US/etc.) - Fallback Chain — Automatic redirect when a target server is unavailable - Scheduled Server Opens — Time- and day-based server access windows

Security & Anti-Abuse

- VPN/Proxy Detection — Block suspicious IP prefixes - Session Fingerprinting — Validates IP consistency across proxy and backend - Switch Lock — Temporary switch ban after kicks or abuse - Staff Alert Dashboard — Live staff notifications for security events - IP Reputation Score — Tracks and blocks high-risk IPs

Player Experience

- Switch GUI (/servergui) — Visual server selector from server-groups - Party Sync (/party) — Create parties and sync group switches - Reconnect Memory — Stores last server for crash/disconnect recovery - Switch Effects — Configurable sound + title on server join - Queue Display — Shows position in the priority queue

Admin & Operations

- Web Dashboard — Built-in HTTP dashboard on port 8765 - Discord Integration — Webhook events for joins and security alerts - Health Checks — Server heartbeat tracking - Auto-Scaling Hooks — Webhook triggers on high load - Config Profiles — Save/load named configuration profiles

Integrations

- LuckPerms Sync — Permission-based server access checks - PlaceholderAPI Hook — Optional placeholder support (if installed) - Redis Pub/Sub — Cross-proxy event broadcasting - Economy Hook — Optional Vault-based switch fees

Analytics

- Heatmap — Switch activity by hour and day of week - Churn Detection — Flags players who disconnect shortly after switching - Popularity Ranking — Top servers by switch count - Export API — Token-protected JSON export endpoint - A/B Routing — Percentage-based routing experiments

Infrastructure

- Redis Tickets — Optional Redis-backed proxy join tickets with TTL - Cluster Mode — Multi-proxy cluster ID support - Remote Feature Flags — Poll remote URL to toggle features - Audit Replay — Timeline view of player audit logs ---

New Commands

| Command | Description | |---------|-------------| | /servergui | Open server switch GUI | | /party create\|invite\|list | Party sync commands | | /ssp maintenance <on\|off> <server> | Toggle maintenance mode | | /ssp profile <load\|save> <name> | Manage config profiles | | /ssp replay <player> [limit] | Audit replay timeline | | /ssp heatmap | View switch heatmap | | /ssp popular [limit] | Top servers by popularity | ---

Improvements

- Feature registry expanded from 14 → 47 modules - BungeeCord proxy bridge for maintenance mode and fallback chains - Version bumped to 2.1.0 across all platforms - Config version updated to 2.1.0 with full v2.1 feature blocks ---

Configuration

All new features are under features.<name>.enabled in config.yml. Most v2.1 features default to enabled where safe; infrastructure features (Redis, Web Dashboard, Export API, Remote Flags) default to disabled. ---

Notes

- Web Dashboard and Export API bind to local ports — configure firewalls accordingly - Redis features require a reachable Redis instance - PlaceholderAPI and Vault are optional soft dependencies (reflection-based) - Existing usage.dat counters from 2.0.x remain compatible --- Full plugin package includes Spigot/Paper, BungeeCord, and Velocity builds.

Changelog – ServerSwitch 2.0.0

This is a major release featuring a complete overhaul of the core architecture and full support for the modern Velocity API. ## New Features & Improvements Brand New Module System (v2.0): Introduced a completely new architecture for server features. All currently available modules (including FeatureManager, Webhooks, Rate-Limiting, Cooldown, etc.) are brand new in v2.0* and did not exist in previous versions. Velocity Module Evolution:* New Configuration System:* Replaced the external ConfigurationNode dependency with a faster, custom-built SimpleYamlConfig parser. Full YAML Support:* Seamlessly handles nested values and YAML lists (e.g., for blacklists and webhooks). Modern API Compliance:* * Resolved all deprecation warnings in the Spigot module (PlayerLoginEvent.disallow, etc.) while maintaining full compatibility from Minecraft 1.8 to 1.21. * Updated BungeeCord to use modern TextComponent constructors, reducing console clutter. ## Bug Fixes Fixed Proxy Join Detection:* Resolved "Direct join detected" false positives by increasing the database ticket timeout and optimizing the registration order of event listeners. Update Logic Improvement:* Fixed the update checker to correctly recognize v2.0.0 as a separate, newer branch, preventing accidental downgrades to 1.3.x. BungeeCord Stability:* Fixed potential NullPointerExceptions during database initializations. * Resolved a critical NullPointerException when loading empty configuration nodes in the Velocity module. * Fixed method ambiguity in the configuration loader, ensuring accurate property retrieval. * Corrected syntax errors in the database auto-delete timer and update checker. * Fixed type conversion issues between SimpleYamlConfig and legacy configuration nodes.

Changelog – ServerSwitch 1.3.5

This is a crucial stability update that significantly improves how the plugin handles unstable database connections.

Changes & Improvements

Database Stability (All Platforms):* Implemented a robust automatic reconnection system for Spigot, BungeeCord, and Velocity. The plugin will now detect a lost database connection and attempt to re-establish it periodically, preventing the plugin from becoming unresponsive. Improved Error Handling (Spigot):* Enhanced error handling during player login to prevent issues when the database is temporarily unavailable. Resource Management (Velocity):* The plugin now correctly closes the database connection when the Velocity proxy shuts down, preventing potential connection leaks.

Changes & Improvements

- License System: Migrated to a new license server infrastructure. The plugin now provides more detailed feedback regarding license validity, expiration, and deactivation reasons. - Internal API: Updated API endpoints and response parsing logic for license validation across Spigot, BungeeCord, and Velocity.

Changes & Improvements

- MySQL Compatibility: Implemented a driver fallback system. The plugin now attempts to load the modern com.mysql.cj.jdbc.Driver first and falls back to com.mysql.jdbc.Driver if not found. This resolves startup issues on older Minecraft versions (e.g., 1.8.8). - Build System: Refined build configuration to support a wider range of Java versions (Java 8 to Java 21) ensuring correct compilation for legacy and modern server software.

Bug Fixes

- Fixed a critical bug where the plugin would disable itself on 1.8 servers due to missing database drivers.

Version 1.3.2 – Velocity API Update & Stability Fixes

Updated for latest Velocity API: Replaced deprecated ServerConnectEvent with modern ServerPreConnectEvent for full compatibility with current Velocity versions. Improved target server detection: The final destination server is now correctly identified before connection, even when redirects occur. Pre-join blacklist and limit checks: Players are now blocked before switching servers, preventing unnecessary connections. Stability improvements: Minor internal optimizations and improved logging for better maintainability.

Changelog – ServerSwitch 1.3.1

Changes & Improvements

Java 21 Support:* Full compatibility with Java 21 for all supported server types (Spigot/Paper, BungeeCord, Velocity). Velocity:* Added missing loadConfig() method to properly support reloading and configuration changes. Reload Command:* Implemented /serverswitch reload for Spigot/Paper, BungeeCord, and Velocity. MySQL:* Modernized the JDBC URL and updated the MySQL driver. Bug Fixes:* * Fixed issues with table handling (PRIMARY KEY) and configuration processing. * Improved error handling for database connections. * Enhanced blacklist and limit validation. New Features:* * Optional settings for auto-update and logging. * Update checker for all platforms. * Velocity: Added blacklist, API key verification, free-limit handling, and custom table name support in line with other platforms.

Notes

* This version is a beta release and may contain bugs. * If you encounter any issues, please join the Discord server for support.

ServerSwitch – Version 1.3

Date: May 15, 2025

What’s New

Clear distinction between Free & Pro versions: Pro users unlock advanced features like server switch validation, API key authentication, and full database integration. Free users enjoy basic functionality with usage limits and no custom table support.

Improved Blacklist Management:

Blacklists are now reliably loaded from the config and enforced on player login.

Automatic Database Connection Monitoring:

Ensures stable MySQL connections with automatic reconnection for Pro users.

Built-in Update Checker:

Runs in the background to notify about new plugin versions, keeping your server up to date.

Customizable Join & Leave Messages:

Enhanced support for placeholders and easy disabling of join/quit messages.

Bug Fixes

Fixed issues with database connections and queries that caused instability in earlier versions. Correct handling of kick messages when unauthorized server switches are attempted. Various minor performance improvements and stability fixes.

Miscellaneous

Cleaner code with clear separation of features based on user type (Free vs Pro). Foundations laid for future feature expansions and enhancements.

Fixed all MySQL errors! JSMySQLFix needed!!

Velocity was removed due to a dependency outage and related errors.

Changes made:

- Velocity support has been added.

Info:

- The file size has increased due to the added dependencies.

Changes: - 1.21 Support - Database connection error fixed

Version 1.1.1 (May 20, 2024) Changes: Simplified MySQL connection configuration in the config file. General code optimization.