-
Notifications
You must be signed in to change notification settings - Fork 12
ClientPatch
A client patch MAY be necessary in order for players to teleport between servers using Transporter. Read on to understand...
The vanilla MC client has no way of being told by the server to connect to a different server (which is what happens when Transporter teleports a player from one server to another). A client patch can change the behavior of the client to detect a specially formatted kick message and reconnect to the server encoded in the kick message. If you attempt to teleport between servers without a client patch installed, you will see the kick message in the client.
If your servers have a proxy installed, like BungeeCord, the plugin can be configured to tell the proxy to handle the reconnect. In this case, the proxy doesn't pass the message to the client, but instead reconnects to the specified server itself while maintaining its connection to the client. The teleport becomes seamless to the client and the client doesn't need to be patched.
If you need a client patch, you have some options. As of v6.10, the plugin is compatible with the BukkitContrib and Spout clients. Users with those client mods installed do not need to install the client patch below; they already have the functionality.
If you still need a client patch in order to teleport between servers, you can use the one built into the Transporter jar file.
Download the latest version of the plugin (yes, the server plugin) to your desktop and double-click it. The patcher is integrated right into the server plugin file and will run as an application when opened this way. You should see something like this:
Click the "Patch" button and in a couple of seconds, the patch has been applied. Then click the "Close" button. You're all done. You can delete the downloaded jar file.
This patch can be safely applied alongside of many other client patches; it only modifies one standard client class.
When the plugin detects a player teleporting to another server, it sends a "kick" command to the client. Without the client patch installed, the player is simply disconnected from the server and given the message that was included by the plugin when it issued the command. The client patch detects this message, which includes the address of the server to connect to, and tells client to connect to that server. From the user's point of view, it's automatic. They step into a gate, and their client displays the "Connecting..." screen as it connects to the new server. When connected, the player steps out of the gate on the receiving side.