Skip to content
7man7LMYT edited this page May 13, 2021 · 1 revision

Bedrock clients will join through Rory and it will handle all the packet translations. There are six different versions of Rory: Rory for Spigot (works on derivatives such as Paper), Rory for BungeeCord (also works on Waterfall), Rory for Velocity, Rory for Sponge, Rory for Fabric (does not support client required mods, and more info about that can be found here) and Rory Standalone. The first five versions run as plugins/mods and can be installed directly onto the server. The standalone version can be used in a similar way, except you run it separately.

If you are running a server, it is highly recommended you use one of the plugin versions, and if you want to join a server that does not have Rory installed, you can run the standalone version. If you use Pterodactyl Panel we have an egg for the standalone version, please see here for more information.

If you're still having problems with Rory not working or giving you an "Unable to connect to world" error, see the Common Issues page.
For more information, take a look at the Understanding the Config page, and the FAQ page.
And if you still have questions, feel free to join the Discord if you haven't already.

Prerequisites

  • The server you are connecting to has to support the latest version of Minecraft Java Edition (at this time this is Minecraft 1.16.5). The server itself does not have to be the latest version but does have to allow connections. If you're running the server on an older version, you can use the plugin ViaVersion.
  • If you are connecting to an online mode Java server, a paid Java account is required. If you are running the server, you can bypass this requirement for your server with Catgate.
  • Your Bedrock client has to be a supported version - at this time that is any Bedrock 1.16 stable version from 1.16.100 to 1.16.210.
  • If you are running the server, you need to have a UDP port opened. See below for more instructions.

Plugin Setup

  1. Download a jar of Rory from the build server depending on what platform your server runs on. See the FAQ if you're confused about which build to download.
  2. Put the Rory jar file in your plugins folder and start up the server.
  3. If you are on a hosting provider, you will likely need to change your Bedrock port in config.yml. Information on your hosting provider might be available on the Supported Hosting Providers page.
  4. Restart your server if you edited your config.
  5. If not using a hosting provider you will need to use port forwarding to allow people out of your LAN to connect. You want to port forward 19132 UDP, instructions to do that for most routers can be found here.

If you are trying to join from the same LAN, the server should show up in the friends tab.

Standalone Setup

Please keep in mind, you need some sort of computer or host to run Rory Standalone on. Applications such as Termux on Android are capable of running Rory, but this largely depends on how powerful your Android device is. Please do so at your own risk. Instructions to run Rory on Termux can be found here.

  1. Download a jar of Rory from the build server.
  2. Create a new folder for Rory, and drop the jar in there.

GUI Setup (Recommended)

  1. Double-click the jar file and all the necessary files for Rory will be created.
  2. Configure options such as the server you want to join in the Rory config. A description of all options of the config can be found on the Understanding the Config page.
  3. Stop the current instance of Rory and re-run it.

Console Setup

  1. Create a new bat or startup script, similar to the one you'd use for a Spigot or Paper server, and take a look at this page for what to put into it.
  2. Run the startup script/bat, and all the necessary files for Rory will be created.
  3. Configure options such as the server you want to join in the Rory config. A description of all options of the config can be found on the Understanding the Config page.
  4. Stop the current instance of Rory and re-run it.

Once you're done, open up Minecraft: Bedrock Edition and in the Friends tab, Rory should show up there. If it does not show up, just add the Java IPv4 address and Bedrock port.

Standalone Setup (Rory and Catgate are not on the same server)

If you want to offload Rory's processing you can host Rory (Standalone) somewhere else and make it redirect to your server. Warning: Do not forget to edit the remote section of your Rory config. See the Floodgate wiki page for more details.

Port Forwarding

Unlike Minecraft Java Edition, Bedrock Edition runs on port 19132 on the UDP protocol. When port forwarding, make sure to allocate to 19132 UDP or another UDP port. For many server hosting providers, you will simply need to change your Bedrock listening port (see here for a list of supported providers).

Termux (Android)

Please read the disclaimer here before continuing.

  1. Download Termux
  2. Follow this guide
  3. Run apt install default-jre
  4. Run wget https://ci.opencollab.dev/job/GeyserMC/job/Geyser/job/master/lastSuccessfulBuild/artifact/bootstrap/standalone/target/Geyser.jar
  5. Run java -jar Geyser.jar

OR

We have an automated setup script for clean Termux installs, might not work for all users. If the manual guide above does not work, try this. Run this to start the download/install:

curl https://gist.githubusercontent.com/rtm516/e3e07d6595ee41e05a38b03c0f4d7a80/raw/install.sh | bash

NewTerm 2 (iOS)

Note: A jailbreak is required. You can find what jailbreak to use for your device here.

  1. Install Filza File Manager.
  2. Install NewTerm 2.
  3. Download jre-16 for iOS and install it using Filza here.
  4. Download my modified java commands, and install it using Filza here.
  5. Open NewTerm 2 and run wget https://ci.opencollab.dev/job/GeyserMC/job/Geyser/job/master/lastSuccessfulBuild/artifact/bootstrap/standalone/target/Geyser.jar.
  6. Run java -jar Geyser.jar.
  7. You can find Rory server running in MCPE!

Note: Due to iOS's environment, if your device has low specs, iOS might end up killing NewTerm 2 while you're playing, stopping the server. There is no fix for that because of how iOS works.

You may encounter some issues. If you do, run su then enter the root password (default is alpine) for root access. Then, run the server like you normally would, and it should work just fine.

Setup Videos

Setup tutorials in a variety of languages.

English

HOW TO PLAY WITH JAVA VIA BEDROCK! [GeyserMC/Floodgate] (Tutorial) by More 7LM

YouTube Video