Server Redirect

Server Redirect

This mod provides a lightweight way for servers to transfer players to another server address, without the use of a proxy server.

Server Redirect supports Forge, Fabric, Bukkit/Spigot, SpongeVanilla/SpongeForge, Bungeecord/Waterfall and Velocity.

With Server Redirect, server admins can avoid mod incompatibility issues caused by proxy servers (Bungeecord, Waterfall, and Velocity). In particular, this mod can be used in combination with Waterfall and Forge 1.13+ servers and clients to provide a way to transfer players between servers (currently, the 1.13+ Forge server needs to be "online" as they haven't included IP forwarding yet...).

This mod is optional, so it can be added to modpacks and players can still join servers without this mod. Likewise, servers with this mod can be joined by clients without this mod.

Commands

• /redirect <Target> <Server Address>: redirects the specified target player(s) to the specified address
• /fallback <Target> <Server Address>: sets the fallback server address for the specified target player(s)
• /ifplayercanredirect <Target> <Command...>: runs the specified command for each of the target player(s) that have Server Redirect
• /ifplayercannotredirect <Target> <Command...>: runs the specified command for each of the target player(s) that have not Server Redirect

The command source can be anything that can run a command, like a command block, a player, or console. Replace /redirect with /fallback to have the specified target players connect to the specified server address when they get forcefully disconnected from the server.

The <Target> argument can be one of the following:

• Player Name/UUID: the specified player on the server
• Target Selector: a target selector. Target selectors are not available on Bungeecord and Velocity.
• r=N: all players within N blocks from the command sender, or from the overworld spawn if run by console. Plugin version only.
• s=<ServerName>: all players in the specified ServerName. Bungeecord and Velocity only.
• *: all players on the server.

The <Command...> argument can contain the following placeholders:

• %PlayerName: this placeholder will be replaced with the player's name
• %PlayerId: this placeholder will be replaced with the player's UUID

NOTICE: /ifplayercanredirect and /ifplayercannotredirect will likely not work as expected if run when the target player just joined the server. These commands rely on the client sending a packet to the server telling them they have this mod installed. This packet requires some time to be sent by the client and processed by the server. It is recommended to delay this command execution by at least 20 ticks after the player has joined the server!

Examples:

• /redirect KaiNoMood myawesomemcserver.net:25667: the player named KaiNoMood will connect to myawesomemcserver.net:25667
• /redirect a54a7884-9ea4-4d54-ac35-1623d70ffbe1 myawesomemcserver.net:25667: the player with the specified UUID will connect to myawesomemcserver.net:25667
• **/redirect * myawesomemcserver.net:25667**: all players on the server will connect to myawesomemcserver.net:25667.
• /redirect @a[m=creative] myawesomemcserver.net:25667: all players in creative mode will connect to myawesomemcserver.net:25667.
• /redirect r=10 myawesomemcserver.net:25667: all players within 6 blocks from the command sender will connect to myawesomemcserver.net:25667. This works on Bukkit and Sponge based servers only.
• /redirect s=lobby myawesomemcserver.net:25667: all players in the "lobby" server will connect to myawesomemcserver.net:25667. This works on Bungeecord and Velocity proxy servers only.
• **/ifplayercanredirect * say %PlayerName is online and using Server Redirect! Yay!**: the specified command will run for each player on the server that has Server Redirect.
• /ifplayercannotredirect @a[distance=..5] tell %PlayerName It does not seem you have Server Redirect installed! Make sure to install it!: the specified command will run for all players without Server Redirect within 5 blocks of the command source.

Replace /redirect with /fallback for setting a fallback address for the target players. For more info about the fallback command, read below.

FAQ

How this mod redirects players

• By running the /redirect command, the server will send a "transfer" packet containing the specified server address to the specified players.
• All players receiving the packet that have the ServerRedirect mod installed will disconnect from the server, and automatically direct connect to the specified server address.

Any server address that is reachable by the players with the "Direct Connect" button can be used. The "transfer" packet will not affect players without the mod installed: they will simply stay connected on the current server. This behaves like the transfer packet present in "Minecraft: Bedrock Edition", feature included by Mojang by default on that client. Regrettably, "Minecraft: Java Edition" is missing this feature entirely. Both the redirect and fallback commands are not supposed to be run by players. They are intended for being run by the console, command blocks and other plugins. Command aliases and "server selector" GUIs are recommended (see BossShop or VirtualChest).

What the fallback command is for

The fallback command tells the clients which server address they should connect to in case they get forcefully disconnected from the server (e.g. the server crashes).