# SmartRejoin for Velocity<\/p>\n
\n<\/p>\n
**SmartRejoin** is a modern alternative to older reconnect plugins, built with a highly customizable rule-based engine.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– \ud83e\udde0 Automatically sends players back to the server they disconnected from.
\n– \u2699\ufe0f Define custom rules based on a player’s last server. For example, send players from a `bedwars_` game to the most populated `bedwars_lobby`.
\n– \u2696\ufe0f Distributes players across lobbies by connecting them to the server with the **most** or **least** players, or to a **random** one.
\n– \ud83d\udee1\ufe0f Configure a safe fallback server (or a pool of servers) for new players or when a target server is offline.
\n– \u26a1 Reload the configuration on-the-fly with a simple command.<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Download the plugin
\n2. Place the plugin into your Velocity proxy’s `\/plugins` directory.
\n3. Restart your Velocity proxy. A `config.yml` file will be generated in `\/plugins\/SmartRejoin\/`.<\/p>\n
—<\/p>\n
## Commands & Permissions<\/p>\n
| Command | Alias | Permission | Description |
\n| :— | :— | :— | :— |
\n| `\/smartrejoinreload` | `\/srr` | `smartrejoin.command.reload` | Reloads the `config.yml` file. |<\/p>\n
—<\/p>\n
## Configuration (`config.yml`)<\/p>\n
The configuration is split into three main parts: **Fallback**, **Default Rule**, and **Custom Rules**.<\/p>\n
### Quick Start<\/p>\n
For the simplest setup, just install the plugin. By default (`rule: SAME`), it will automatically reconnect players to the server they left. New players will be handled by your `velocity.toml` configuration. To use the plugin’s fallback for new players, set `fallback.enabled: true`.<\/p>\n
### Example Use Cases<\/p>\n
– **BedWars Lobby**: If a player leaves `bedwars_12`, send them to the `bedwars_lobby` with the most players.
\n– **Persistent Survival**: If a player leaves `survival`, always send them back to `survival`.
\n– **Random Lobby**: If a player was in any `lobby_` server, send them to another random `lobby_` server.
\n– **AFK Escape**: If a player was in an `afk` server, send them to the `lobby` with the fewest players.<\/p>\n
### Full Configuration Example (different from default one!)<\/p>\n
“`yml
\n# ————————————————— #
\n# SmartRejoin Configuration #
\n# ————————————————— #<\/p>\n
# — General Settings —
\nsettings:
\n # If true, the plugin will print informational messages to the console.
\n # Critical errors are always logged.
\n logging_enabled: true<\/p>\n
# — Fallback Configuration —
\n# Used for new players or when a target server from a rule is offline.
\nfallback:
\n # If ‘enabled’, this plugin’s fallback logic will be used.
\n enabled: true
\n # ‘RANDOM’: Connects to a random server whose name CONTAINS the ‘name’ value.
\n # ‘SERVER’: Connects to a specific server with an exact ‘name’.
\n type: RANDOM
\n name: “lobby”<\/p>\n
# — Default Rule —
\n# Applied if a player’s last server doesn’t match any custom rules below.
\ndefault:
\n # ‘SAME’: Connects to the exact same server. (Most common)
\n # ‘FALLBACK’: Immediately uses the fallback rule.
\n # ‘SMART’: Finds a related lobby. See comments below for details.
\n rule: SAME
\n # Arguments for the ‘SMART’ rule.
\n # Example: [‘MOST’, ‘%last_seen%_lobby’]
\n arguments: []<\/p>\n
# — Custom Rules —
\n# Define specific redirection rules here. They are checked in order.
\nrules:
\n stay_on_survival:
\n last_seen:
\n # Condition: Player’s last server name must be an exact match.
\n type: EQUALS
\n name: “survival”
\n where_to_join:
\n # Action: Connect to a server with this exact name.
\n type: EQUALS
\n name: “survival”<\/p>\n
bedwars_lobby_fallback:
\n last_seen:
\n # Condition: Player’s last server name must contain “bedwars”.
\n type: CONTAINS
\n name: “bedwars”
\n where_to_join:
\n # Action: Find all online servers containing “bedwars_lobby” and
\n # connect to the one with the MOST players.
\n type: MOST
\n name: “bedwars_lobby”<\/p>\n","protected":false},"excerpt":{"rendered":"
A Velocity plugin that gives you full control over where players connect when they join your network.<\/p>\n","protected":false},"featured_media":143815,"template":"","meta":{"_minecraft_slug":"smartrejoin","_minecraft_project_id":"smSZvvku","_minecraft_author":"RealKomander1","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":1238,"_minecraft_follows":8,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"smartrejoin.zip","_minecraft_size_bytes":73805,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T07:49:11.062134Z","_minecraft_date_created":"2025-07-19T05:48:15.757244Z","_minecraft_date_modified":"2026-02-17T16:20:01.996887Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/smartrejoin","_minecraft_icon_attachment_id":143815,"_minecraft_imported_at":"2026-06-08T14:00:50+00:00","_minecraft_import_hash":"245b07e5dfdf8b526609be3384de4dba","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,92,985],"mod_loader":[986],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-143814","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n