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!