FallbackRouter is a Velocity proxy plugin that ensures a smooth player experience by redirecting users to predefined fallback servers when their current server goes down or restarts. It prevents disconnects and frustration – especially in large networks or lobby-based systems.
### ✅ Features
Automatic Fallback Handling
Detects when a player is kicked by a backend server and redirects them to the nearest predefined fallback server.
Multilingualism
Language files in YAML format (currently including EN and DE). Easily extendable with custom translations.
⚙️ Fully configurable via config.yml
Define fallback chains per server
Select a default language
Error Handling
Ping checks before connecting
Delayed retry logic to give servers time to start
### Example Configuration
```
language: "en"
fallbacks:
smp:
- smpfb
- lobby
prac:
- pracfb
```
### Language Example (en.yml)
```
fallback:
kicked: "You were kicked from %server%. Trying fallback..."
all_offline: "All fallback servers are offline."
connected: "Successfully connected to %target%."
```
### Installation
Download the latest .jar from the Modrinth page or build it yourself using Maven
Place it in your plugins/ folder on your Velocity proxy
Start the proxy once to generate config.yml and language files
Customize config.yml and optionally translate the language files in lang/
Open Source
This plugin is fully open-source and MIT licensed.
You are welcome to fork, extend, and share improvements!
