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!
