SMP-Reconnect
The Ultimate Lightweight Auto-Reconnect Solution for Velocity
Turned Away by Restarts?
In the competitive world of Minecraft servers, player retention is everything. When a sub-server crashes or undergoes a scheduled restart, players are traditionally kicked back to the lobby or, even worse, disconnected from the proxy entirely. Most servers lose up to 20% of their concurrent players during these brief downtime windows.
SMP-Reconnect maintains your player count by keeping users bridged on the Velocity proxy during downtime. The moment the backend server is ready, they are automatically returned—providing a premium, seamless experience that keeps your community engaged.
SMP-Reconnect maintains your player count by keeping users bridged on the Velocity proxy during downtime. The moment the backend server is ready, they are automatically returned—providing a premium, seamless experience that keeps your community engaged.
Exclusive Features
Zero-Latency Performance: All pings and reconnection logic are handled asynchronously, ensuring your proxy remains lag-free.
Advanced Server Pinging: Uses the Velocity internal ping API to accurately detect when a server is accepting players again.
Smart Reconnect Logic: Intelligently remembers where each player was. No more "lost" players wandering around the lobby.
Fail-Safe Protection: Automatically detects if a player was banned or kicked and will NOT reconnect them.
Dynamic Fallback Mapping: Map specific source servers to specific fallback destinations (e.g. Survival to Survival-Lobby).
Customizable Notifications: Full control over hex-colors and the frequency of reconnect notifications.
Commands & Admin Control
| Command | Description | Permission |
| /reconnectreload | Reloads the config.yml without restarting the proxy. | smpreconnect.admin |
| /reconnectdebug | Toggles verbose logging in the console for troubleshooting. | smpreconnect.admin |
Technical Configuration Guide
YAML:
# Servers that should NEVER trigger reconnect logic
blacklisted_servers:
- lobby
- login
# Map source servers to specific fallback destinations
fallback_servers_map:
survival: lobby
skyblock: skyblock_lobby
# Frequency (in seconds) to check if a server is back online
ping_delay_seconds: 5
# What do the players see while waiting?
reconnecting_message: "&aThe server is still starting up! You will be connected shortly..."
Quick Installation
- Download the reconnectanzi-X.X.jar.
- Place it into your Velocity /plugins folder.
- Restart your proxy and configure the mapping.
- You're done! Your players are now protected.
