SMP-Reconnect

Velocity3.xJava 17

Keeps players bridged on the Velocity proxy while a backend restarts or recovers, then returns them the moment it answers. No database, and nothing to install beyond the proxy itself.

Read the manual Source on GitHub Ask in Discord

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.

What it talks to

Ports

One run, and it is the platform. SMP-Reconnect stores nothing and depends on nothing else.

Velocity API

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!

Questions before you commit?

Support, licence keys, bug reports and feature requests all run through the Discord. Ask anything about SMP-Reconnect there — including whether it fits the server you already run.

Already bought it? Your licence lives in the licence portal — sign in there for your keys, or claim one with /claim in the Discord.

Join the Discord Back to all plugins