🚀 SMP-Reconnect

The Ultimate Lightweight Auto-Reconnect Solution for Velocity

Maintain 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.

Explore Features Documentation GitHub

❓ 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.

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.

~20%

Players lost during restarts (without us)

Player loss with SMP-Reconnect

< 1ms

Proxy performance impact

✨ Exclusive Features

⚡ Zero-Latency Performance

All pings and reconnection logic are handled asynchronously
Your proxy remains completely lag-free
Designed for networks of any size

📡 Advanced Server Pinging

Uses the Velocity internal ping API
Accurately detects when a server is accepting players
Configurable ping frequency

🔄 Smart Reconnect Logic

Intelligently remembers where each player was
No more "lost" players wandering the lobby
Automatic return to the original server

🛡️ Fail-Safe Protection

Detects if a player was banned or kicked
Will NOT reconnect banned/kicked players
Prevents abuse of the reconnect system

📂 Dynamic Fallback Mapping

Map source servers to specific fallback destinations
e.g. Survival → Survival-Lobby
Full control over reconnect routing

💬 Customizable Notifications

Full control over hex-colors
Configurable reconnect message frequency
Keep players informed while they wait

🛠️ 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`
`/vforward <server> <command...>`	Forwards a command to be executed by the backend server console. Requires the Bridge plugin installed on the target server.	`smpreconnect.forward`

⚙️ Technical Configuration Guide

config.yml

# 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

Download the SMP-Reconnect Proxy & Bridge plugins from GitHub or BuiltByBit.

Install Proxy

Place the main plugin into your Velocity /plugins folder.

Install Bridge

Place the Bridge plugin into your Spigot/Paper /plugins folder (optional, for /vforward).

Done!

Configure the fallback mapping. Your players are now protected from restarts!

🔗 Documentation & Support

Need help? Join our Discord community or check out the source code on GitHub.

Join Discord GitHub Project

Disclaimer: This plugin is Open Source and provided as-is. Use at your own risk.