Java Edition 1.21.6 is not yet supported by the latest stable version of GeyserMC, so you will need to use a preview version. Note that these versions may be unstable and contain bugs.
If your server is running a Minecraft Java Edition version no longer supported by Geyser, install the latest version of Geyser as well as the latest version of ViaVersion. In some cases, you need to install ViaBackwards as well.
It's not possible to use Geyser and a voice chat mod on the same server because both of them require their own UDP port, and we only provide one port per server.
What is Geyser?
Geyser is a proxy, bridging the gap between Minecraft: Bedrock Edition and Minecraft: Java Edition servers. The ultimate goal of this project is to allow Minecraft: Bedrock Edition users to join Minecraft: Java Edition servers as seamlessly as possible to allow for true cross-platform.
Using Geyser on Aternos
Aternos offers support for the Geyser Bukkit plugin and Fabric mod, which can be installed on your server to allow connections from Bedrock users on your Java Edition server. Currently, Geyser only supports version 1.21.5 of Minecraft Java Edition, so please make sure that you are running that version. The Geyser developers are working on supporting 1.21.6, but that will probably take a few days.
Bukkit plugin
If you don't know how to install plugins, you should read this article first: Install plugins
You can install the plugin here: https://aternos.org/addons/a/artemis-bukkit/geyser
Fabric mod
If you don't know how to install mods, you should read this article first: Install mods
You can install the mod here: https://aternos.org/addons/a/artemis-fabric/geyser-fabric
Make sure to install Fabric, not Forge, on your server first.
Also note that GeyserMC can only be used with server-side Fabric mods. Installing mods that need to also be added to the Minecraft client to work (e.g. Origins) will result in Bedrock players being unable to join.
Config
We currently only allow downloading the latest Geyser version. When installing it, we automatically install Floodgate for authentication as well. The Geyser config is also preconfigured for using Geyser on Aternos and should work without any changes. If you somehow have to reset your config or want to configure it yourself, make sure that the option clone-remote-port is set to true.
Account linking
Floodgate allows linking your Java Edition account to your Bedrock account. This is not enabled by default and can be enabled in the Floodgate config. Read more about account linking here: https://wiki.geysermc.org/floodgate/linking/
More info about Geyser (e.g. currently supported versions): https://github.com/GeyserMC/Geyser
More info about Floodgate: https://wiki.geysermc.org/floodgate/
Connecting to Geyser on Aternos
Server address
You can use the same server address (example.aternos.me) that you use when you connect using the Java Edition. If you are having issues with that address it might be necessary to use the DynIP or change your DNS.
Port
Minecraft Bedrock Edition requires a server port to connect to a server (on Java Edition this can be simplified using SRV records). Because of that, we try to keep your server port always the same, so you don't have to update your server list entry every time you start your server. This was only enabled for dedicated Bedrock Edition servers before, but now also applies to Java Edition servers. You can use the same port that you use for Java Edition to connect to your server with Bedrock after installing the Geyser plugin. You can find your port by clicking on the "Connect" button on the server page.
Share URL
In the Minecraft Bedrock Edition, it's possible to add a Server via a URL. We offer unique URLs for dedicated Bedrock servers. Those URLs can also be used by Bedrock players to connect to Java Edition servers with the Geyser plugin. You can build your own by using your server address like this:
https://add.aternos.org/<server address>
e.g.: https://add.aternos.org/example.aternos.me
You can leave out the ".aternos.me" part if you want to keep it short. It's also possible to use your own custom domains.
Updating to new Bedrock versions
When a new version of Bedrock Edition is released, you will have to update geyser. To do that, you just need to install it again as described above.
Paper/Bukkit, Spigot/Bukkit, and Fabric do not use bedrock versions and are only updated with new releases of the Java Edition. If you're already running the latest version of Paper or Spigot, then you only need to update Geyser.