FallBackRouter

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!