Shimatsu ProxyFallback

Shimatsu ProxyFallback is a lightweight and efficient solution for Velocity proxies, designed to keep your community connected even when backend servers fail.

💡 The Story Behind the Plugin

This plugin was originally developed exclusively for my own server, Shimatsu Network. I spent a lot of time looking for a simple and reliable fallback plugin that met our specific needs, but I couldn't find anything that fit. I decided to write my own solution and share it with the public to help other server owners who are looking for a "plug and play" fallback system.

⚡ Key Features

Automatic Fallback:

Seamlessly moves players to the lobby (or any designated server) if their current server crashes or shuts down.

Simple Exclusion System:

Uses a basic string-check to identify disconnect reasons that should not trigger a fallback (e.g., stopping the proxy from sending banned players back to the lobby).

Custom Server Commands:

Create your own shortcut commands (like /vanilla or /lobby) with custom permissions directly in the configuration.

Multi-language Support:

Pre-configured for English and Czech, utilizing MiniMessage (Adventure) for modern, easy-to-style formatting.

Selective Fallback:

Choose whether to enable fallback for all servers on your proxy or only a specific list.

⚠️ Important Information

!IMPORTANT Simple Exclusion System: The excluded-reasons feature is a simple string-based filter. It scans the disconnect message for specific keywords (e.g., "banned"). This is intended as a basic bridge. For proper network security, it is highly recommended to use a dedicated punishment plugin (such as LibertyBans or AdvancedBans) that handles bans and kicks across the entire network.

!NOTE Compatibility: This plugin was specifically developed and tested on Velocity 1.21.11. While it is expected to function correctly on Velocity 1.21.1 and newer, please test it thoroughly in your specific environment before full deployment.

⚙️ Configuration

The plugin is designed to be highly flexible. You can modify the fallback logic, all player-facing messages, and custom commands in the config.yml.

🛠️ Commands & Permissions

Custom Commands: As defined by you in the config (Default: /lobby, /vanilla).

Permissions: Custom permissions can be assigned to each command (e.g., proxyfallback.command.lobby).