diff --git a/_data/toc.yml b/_data/toc.yml index 72c5e20..0479835 100644 --- a/_data/toc.yml +++ b/_data/toc.yml @@ -4,17 +4,12 @@ - title: Setting up Geyser url: "geyser/setup/" children: - - title: Plugin Setup - url: "geyser/setup/#plugin-setup" - title: Supported Hosting Providers url: "geyser/supported-hosting-providers/" - title: Using Geyser with Consoles url: "geyser/using-geyser-with-consoles/" - title: Using playit.gg with Geyser url: "geyser/playit-gg/" - - title: Setting up Geyser-Standalone - url: "geyser/standalone/" - children: - title: Creating a Startup Script url: "geyser/creating-a-startup-script/" - title: Common Issues @@ -73,6 +68,8 @@ url: "floodgate/setup/" - title: "Issues" url: "floodgate/issues/" + - title: "FAQ" + url: "floodgate/faq/" - title: "Features" url: "floodgate/features/" children: diff --git a/_docs/floodgate/faq.md b/_docs/floodgate/faq.md new file mode 100644 index 0000000..1808122 --- /dev/null +++ b/_docs/floodgate/faq.md @@ -0,0 +1,24 @@ +--- +title: FAQ +--- + +# FAQ + +## Changing/disabling the prefix + +***Please note: we do not recommend removing the prefix unless you are certain that no one will share a username between a Java and Bedrock player. Duplicated usernames will cause weird situations, like being unable to teleport to one of the players.*** + +In your Floodgate config, change `username-prefix` to whichever prefix you desire - you can set it to `""` and there will be no prefix. + +On some older Paper servers (or any forks that use them), you may need to also shut down your server and delete your `usercache.json` file located in the same folder as your server jar to prevent users who already joined from having the old prefix. See [this issue](/floodgate/issues/#prefix-is-not-changing-on-the-server-after-changing-it-in-the-config) for more information. + +## Obtaining UUIDs for Floodgate players +Check your server logs, or use [this](https://uuid.kejona.dev/) page. If this doesn't work, then try this method: + +First, you'll need to get the XUID of the player. There are several third-party websites to find this, for example, [this one](https://www.cxkes.me/xbox/xuid) (unaffiliated with Geyser). Make sure to choose "Hexidecimal." You'll need to enter the player's Xbox Gamertag, and, once submitted, and it should display the XUID in the format of `xxxxxxxxxxxxxxxx`. To turn the XUID into a UUID that Java Edition can recognize, you need to put the XUID in this format: `00000000-0000-0000-xxxx-xxxxxxxxxxxx`. If formatted right, Java Edition should accept it as a UUID. + +## Using PlaceholderAPI +If you're using the Spigot version of Floodgate, download the Placeholder plugin [here](https://github.com/rtm516/FloodgatePlaceholders/). Using the placeholders shouldn't require additional setup other than having [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) installed. See the section above on installing Floodgate on backend servers if you wish to use this on BungeeCord. + +## Using Skript +If you're using the Spigot version of Floodgate, there is an unofficial plugin that adds Skript support [here](https://github.com/Camotoy/floodgate-skript). diff --git a/_docs/floodgate/setup.md b/_docs/floodgate/setup.md index e9136ec..32bd6c3 100644 --- a/_docs/floodgate/setup.md +++ b/_docs/floodgate/setup.md @@ -1,59 +1,50 @@ --- title: Floodgate Setup +page_sidebar: false --- -## Downloads: +# Floodgate Setup -Download Geyser and Floodgate from the [Geyser download page](https://geysermc.org/download). + -## Prerequisites +
+ + + + +
-- You must own/manage the server in order to add Floodgate. *If you do not own the server, Floodgate does not allow you to bypass logging into Java servers that require a Mojang Java account*. -- You must either be running Geyser as a [plugin](/geyser/setup/), or be running [Geyser Standalone](/geyser/standalone/). Floodgate does not replace Geyser. -- `floodgate-spigot.jar` cannot be installed on CraftBukkit/Bukkit servers. +
+
+ {% capture my_include %}{% include setup/instructions/floodgate/spigot.md %}{% endcapture %} + {{ my_include | markdownify }} +
+
+ {% capture my_include %}{% include setup/instructions/floodgate/fabric.md %}{% endcapture %} + {{ my_include | markdownify }} +
+
+ {% capture my_include %}{% include setup/instructions/floodgate/proxy.md %}{% endcapture %} + {{ my_include | markdownify }} +
+
+ {% capture my_include %}{% include setup/instructions/floodgate/standalone.md %}{% endcapture %} + {{ my_include | markdownify }} +
+
-## Setting Up -*Any reference to Spigot here also refers to any compatible server software such as Paper. For the proxy setup, backend server implies all the servers that are behind the proxy.* - -For BungeeCord/Velocity setups: you only are required to install Floodgate on the BungeeCord or Velocity proxy unless you want to use the Floodgate API on the backend servers - see [below](#installing-floodgate-also-on-spigot-servers-behind-bungeecord-or-velocity) for the installation process. -       *Note:* Installing Floodgate on the backend servers will allow Bedrock player skins to display without the Bedrock player having to switch backend servers. - -- Download the Floodgate plugin and add it to your plugins folder on your frontend server. - - Select your platform on the download page linked above and click "Download Floodgate" - - If you are using Floodgate on Fabric, you will need to download the [Fabric API](https://www.curseforge.com/minecraft/mc-mods/fabric-api). -- Change the `auth-type` in the Geyser config to `floodgate`. -- Restart/start up the server. - -**ONLY do this step if using Geyser Standalone:** -- *Copy* the `key.pem` file in the Floodgate config folder to the same directory as Geyser Standalone. **DO NOT DISTRIBUTE THIS KEY TO ANYBODY!** This key is what allows for Bedrock accounts to bypass the Java Edition authentication, and if anyone gets ahold of this, they can wreak havoc on your server. - -### Installing Floodgate also on Spigot servers behind BungeeCord or Velocity - -This is only needed when you want to use the Floodgate API on your backend server(s) behind a proxy. - -- Install Floodgate on the proxy and on *all* backend servers as per the [previous instructions](/floodgate/setup/) -- Enable `ip_forward` in your BungeeCord `config.yml` if using BungeeCord. For Velocity, set up "player-info-forwarding". -- Set `bungeecord` to `true` in your `spigot.yml`. When using Velocity, see their [guide](https://docs.papermc.io/velocity/player-information-forwarding), as they have multiple options that require different setups. -- Start the proxy server. -- Edit the Floodgate config on your proxy server and set `send-floodgate-data` to `true`. -- *Copy* the `key.pem` file in the proxy Floodgate config folder to all backend servers' Floodgate config folder. **DO NOT DISTRIBUTE THIS KEY TO ANYBODY!** This key is what allows for Bedrock accounts to bypass the Java Edition authentication, and if anyone gets ahold of this, they can wreak havoc on your server. -- Restart the backend servers and proxy server. - -## Changing/disabling the prefix - -***Please note: we do not recommend removing the prefix unless you are certain that no one will share a username between a Java and Bedrock player. Duplicated usernames will cause weird situations, like being unable to teleport to one of the players.*** - -In your Floodgate config, change `username-prefix` to whichever prefix you desire - you can set it to `""` and there will be no prefix. - -On some older Paper servers (or any forks that use them), you may need to also shut down your server and delete your `usercache.json` file located in the same folder as your server jar to prevent users who already joined from having the old prefix. See [this issue](/floodgate/issues/#prefix-is-not-changing-on-the-server-after-changing-it-in-the-config) for more information. - -## Obtaining UUIDs for Floodgate players -Check your server logs, or use [this](https://uuid.kejona.dev/) page. If this doesn't work, then try this method: - -First, you'll need to get the XUID of the player. There are several third-party websites to find this, for example, [this one](https://www.cxkes.me/xbox/xuid) (unaffiliated with Geyser). Make sure to choose "Hexidecimal." You'll need to enter the player's Xbox Gamertag, and, once submitted, and it should display the XUID in the format of `xxxxxxxxxxxxxxxx`. To turn the XUID into a UUID that Java Edition can recognize, you need to put the XUID in this format: `00000000-0000-0000-xxxx-xxxxxxxxxxxx`. If formatted right, Java Edition should accept it as a UUID. - -## Using PlaceholderAPI -If you're using the Spigot version of Floodgate, download the Placeholder plugin [here](https://github.com/rtm516/FloodgatePlaceholders/). Using the placeholders shouldn't require additional setup other than having [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) installed. See the section above on installing Floodgate on backend servers if you wish to use this on BungeeCord. - -## Using Skript -If you're using the Spigot version of Floodgate, there is an unofficial plugin that adds Skript support [here](https://github.com/Camotoy/floodgate-skript). +

Further information:

+ \ No newline at end of file diff --git a/_docs/geyser/creating-a-startup-script.md b/_docs/geyser/creating-a-startup-script.md index 75538c7..e1ff1ca 100644 --- a/_docs/geyser/creating-a-startup-script.md +++ b/_docs/geyser/creating-a-startup-script.md @@ -2,6 +2,8 @@ title: Creating a Startup Script --- +# Creating a Startup Script for Geyser-Standalone + **In order for this to work, you MUST have Java 16 (or higher) installed!** Once you have downloaded and placed Geyser into its own folder, you will need to create a startup script; similar to how you'd run a Bukkit/Spigot/Paper server. diff --git a/_docs/geyser/faq.md b/_docs/geyser/faq.md index 8082831..98bb209 100644 --- a/_docs/geyser/faq.md +++ b/_docs/geyser/faq.md @@ -2,6 +2,9 @@ title: FAQ --- +# Frequently Asked Questions +Here you can find answers to frequently asked questions about Geyser - if you have a question that isn't answered here, feel free to ask in our [Discord](https://discord.gg/GeyserMC)! + ## How Does it Work? Geyser works as a translator, translating both the incoming and outgoing packets to a format both the client and server can understand. With this being said, it emulates a Minecraft: Java Edition client, so the server actually thinks you're joining from Java Edition. Regardless of the server or what plugins it has installed, you can join it with Geyser (as long as the server supports the latest vanilla (unmodified) Minecraft version). @@ -32,6 +35,16 @@ Floodgate can cause issues with plugins as it modifies the login process. *Pleas If you come across any more, please let us know via [Discord](http://discord.gg/geysermc). +## What server versions does Geyser support? +The Geyser-Spigot plugin supports any Minecraft server version 1.13.2 or later. Any earlier version is not supported by the plugin - use a proxy version or the standalone build instead. +Since Geyser emulates a {{ site.data.versions.java }} Java Edition client, you need to [install ViaVersion](https://www.spigotmc.org/resources/viaversion.19254/) on your server +if it is not running the latest version of Minecraft.
+ +In order for Bedrock players to chat (1.19.3+) or join (1.19.1/1.19.2), you need to disable chat signing. More information about that can be read on the [chat signing page](geyser/secure-chat/).
+ +You will also need to run at least Java 16 or later to use Geyser. See [here](https://docs.papermc.io/misc/java-install) for more info on updating Java. +Paper versions not supporting Java 16 can add `-DPaper.IgnoreJavaVersion=true` flag to the Java startup arguments to allow Paper to run on Java 16. + ## Which plugin version of Geyser do I need? This is a non-complete list of what platform each plugin version of Geyser is for, and the standalone version can be used for any as it isn't a plugin. * Geyser-Spigot works with: @@ -44,14 +57,11 @@ This is a non-complete list of what platform each plugin version of Geyser is fo * Any other forks of the above * Geyser-Velocity works with [Velocity](https://www.velocitypowered.com/) * Geyser-Sponge works with [SpongeVanilla or SpongeForge](https://www.spongepowered.org/) -* Geyser-Fabric works with [Fabric](https://www.fabricmc.net/) +* Geyser-Fabric works with [Fabric](https://www.fabricmc.net/), and requires FabricAPI to be installed on the server as well. ## Which type of Geyser version is better, standalone or plugin? Because of optimizations that hook into the plugin platforms, plugin versions of Geyser are preferable compared to standalone Geyser. On Spigot, Velocity, and BungeeCord versions of Geyser, direct connections allow for faster loading times, lower latency, and accurate IP addresses without requiring Floodgate. Geyser-Spigot has further optimizations due to having direct world access, including lower memory usage and greater translation accuracy. However, large server networks might prefer standalone Geyser because it can be updated without needing to restart any other proxies or servers, and can offload resource usage onto seperate machines. -## What server versions does Geyser-Spigot support? -The Geyser-Spigot plugin supports any Minecraft server version 1.13.2 or later. Any earlier version is not supported by the plugin - use a proxy version or the standalone build instead. - ## If using BungeeCord or another fork, where do I need to put Geyser/Floodgate? You only need Geyser and/or Floodgate on the BungeeCord server, as long as not using the Floodgate API. In this case, Floodgate is needed on the "backend" servers as well. diff --git a/_docs/geyser/playit-gg.md b/_docs/geyser/playit-gg.md index 87c80f4..032f2e3 100644 --- a/_docs/geyser/playit-gg.md +++ b/_docs/geyser/playit-gg.md @@ -4,7 +4,10 @@ title: playit.gg Setup ## Prerequisites -- You must be able to connect to your Geyser instance locally. + + - If you already have playit.gg running & set up (for e.g. Minecraft Java edition), skip steps 1 and 2 and proceed with step 3. ## Setup diff --git a/_docs/geyser/setup.md b/_docs/geyser/setup.md index 040df77..bde658c 100644 --- a/_docs/geyser/setup.md +++ b/_docs/geyser/setup.md @@ -1,117 +1,33 @@ --- -title: Geyser Setup +title: Setup +page_sidebar: false --- +
+ Host Provider + Self Host +
-# Setup +
+
+ {% include setup/host-provider.html %} -## Overview + {% include setup/instructions/geyser/tabs.html type="provider" %} +
-Bedrock clients will join through Geyser, and it will handle all the packet translations. There are six different versions of Geyser: -1. Geyser for Spigot (works on derivatives such as Paper), -2. Geyser for BungeeCord (also works on Waterfall), -3. Geyser for Velocity, -4. Geyser for Sponge, -5. Geyser for Fabric (for setups that support vanilla Java clients; requires [Fabric API](https://www.curseforge.com/minecraft/mc-mods/fabric-api)), -6. Geyser Standalone (Standalone Setup instructions are [here](/geyser/standalone/)). +
+ {% include setup/instructions/geyser/tabs.html type="selfhost" show_standalone=true %} +
+
-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 Geyser installed, you can run the standalone version. If you use Pterodactyl Panel we have an egg for the standalone version, please see [here](/geyser/faq/#can-i-use-geyser-with-pterodactyl-panel) for more information. - - -## Prerequisites -- The server you are connecting to has to support the latest version of Minecraft Java Edition (at this time this is Minecraft {{ site.data.versions.java }}) -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](https://www.spigotmc.org/resources/19254/), but do note that only **1.13.2 and any version above is officially supported**. For older versions, use Geyser Standalone, or Geyser on a proxy like Velocity or BungeeCord. -- The device running Geyser must support Java 16 or later. If you need help installing or updating, please see [PaperMC's Java update page](https://docs.papermc.io/misc/java-install). If you're running a version of Paper that does not support Java 16 or later, you can add the flag `-DPaper.IgnoreJavaVersion=true` to your startup Java arguments to allow Paper to run on Java 16. You can run Geyser standalone on another device if a server software cannot be updated to use Java 16. -- 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 [Floodgate](/floodgate/). -- Your Bedrock client has to be a supported version - at this time that is Bedrock version(s) {{ site.data.versions.bedrock }}. -- If you are running the server, you need to have a UDP port opened. See below for more instructions. -- In order for Bedrock players to chat (1.19.3+) or join (1.19.1/1.19.2), you need to disable chat signing. More information about that can be read on the [chat signing page](/geyser/secure-chat/). - -## Plugin Setup -1. Read the Prerequisites above, especially if you are setting up Geyser for an older Minecraft Java Edition version! -2. To make sure you are using the easiest way to set up Geyser, please check whether your hosting provider features [built-in Geyser](/geyser/supported-hosting-providers/#built-in-geyser). If you are not using a hosting provider, or your hosting provider is not featured on said list, continue with the steps below. -3. If 2. does not apply: download Geyser [here](https://geysermc.org/download) for the platform your server runs on. See the [FAQ](/geyser/faq/#which-plugin-version-of-geyser-do-i-need) if you're confused about which build to download. -4. Put the Geyser jar file in your plugins folder and start up the server. -5. Port-forwarding: - - If you are using 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](/geyser/supported-hosting-providers/) page. If there is no information on your hosting provider and you are unable to assign/open ports yourself, try enabling `clone-remote-port` in Geyser's `config.yml` file and connecting with the same IP/port as you would with Java Edition. - - If not using a hosting provider, you will need to use port forwarding to allow people outside your LAN to connect. You want to port forward 19132 UDP, instructions to do that for most routers can be found [here](https://www.lifewire.com/how-to-port-forward-4163829). If you are trying to join from the same LAN, the server should show up in the friends tab. - - To check whether it is working correctly, you can use the `geyser connectiontest [yourIP]:[yourPort]` command in your server console to check if the server is reachable from the outside. - - _Restart your server if you edited your config! Simply reloading will not work._ -6. Besides the `port` entry in the _Bedrock Section_ of Geyser's `config.yml`, you rarely need to change anything. A few examples: - - `address: 0.0.0.0` The IP address that will listen for connections. There is no reason to change this unless you want to limit what IPs can connect to your server or if your hosting provider instructs you to do so. - - `port: 19132` The port Bedrock players will use to connect. If the option `clone-remote-port` is set to true, this port is ignored, and you'll have to use the same port on bedrock as you would on Java to connect. -7. The _remote_ section in the `config.yml` determines, which Java server the Bedrock players join. -- `address: auto` This means, that Geyser configures the server's IP, port and auth-type of the java server by itself, leave this at auto. -- `port: 25565` This should be the port of the Java server. By default, it is set to 25565 - your hosting provider may have assigned a different port to your Java server, set that here. -8. If you wish to remove the Java account requirement, set up the [Floodgate](/floodgate/setup/) plugin. This will allow Bedrock players to play on your server, without you having to use offline mode. -9. For further Geyser config changes, like allowing Bedrock players to build on the nether roof, refer to [the config help article](/geyser/understanding-the-config/). - -If you're still having problems with Geyser not working or giving you an "Unable to connect to world" error, see the [Common Issues](/geyser/common-issues/) page.\ -For more information, take a look at the [Understanding the Config](/geyser/understanding-the-config/) page, and the [FAQ](/geyser/faq/) page.\ -And if you still have questions, feel free to join the [Discord](https://discord.geysermc.org) if you haven't already. - -### BungeeCord/Velocity Setup -If you are using a BungeeCord, Waterfall, or Velocity proxy, then you only need to install Geyser (and Floodgate, if you desire) on the proxy. - -You can install Floodgate (but not Geyser) on the back-end servers to improve skin functionality and to let other plugins access the Floodgate API. If you do this, then you _must_ make sure that the same `key.pem` file is used between all instances of Floodgate; otherwise, Bedrock clients will not be able to join. Full instructions can be found on the [Floodgate Wiki](/floodgate/setup/). - -The Bedrock clients, like Java clients, should connect to the proxy server, and should never directly connect to a back-end server. You don't need to (and shouldn't) port-forward anything for the back-end servers! - -#### Setup: -1. Make sure Velocity/BungeeCord is up-to-date. The proxy can be newer than the servers behind it (also called backend servers). If you're running the backend servers on an older version then the current {{ site.data.versions.java }}, you can use the plugin [ViaVersion](https://www.spigotmc.org/resources/19254/). It is recommended to have the plugin on all backend servers where necessary, instead to having it on the proxy. -2. Download Geyser [here](https://geysermc.org/download) for the platform your server runs on. See the [FAQ](/geyser/faq/#which-plugin-version-of-geyser-do-i-need) if you're confused about which build to download. -3. Put the Geyser jar file in your plugins folder and start up the server. -4. Port-forwarding: -- If you are using a hosting provider, you will likely need to change your Bedrock port in the `config.yml` file. Information on your hosting provider might be available on the [Supported Hosting Providers](/geyser/supported-hosting-providers/) page. If your hosting provider is not listed there, and you are unable to port forward the default 19132 port on UDP, try setting `clone-remote-port` to true and connecting with the Java IP and port. Any port will work, as long as the UDP protocol is not blocked or already in use by the query feature (see `server.properties`) or another mod. -- If you are 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](https://www.lifewire.com/how-to-port-forward-4163829). Note: Any port will work, as long as UDP traffic is not blocked. Java uses the TCP protocol, so you will need to open both UDP and TCP if you wish to use the same port. -- To check whether it is working correctly, you can use the `geyser connectiontest [yourIP]:[yourPort]` command in your server console to check if the server is reachable from the outside. -- _Restart your server if you edited your config! Simply reloading will not work._ -5. Besides the `port` entry in the _Bedrock Section_ of Geyser's `config.yml`, you rarely need to change anything. A few examples: -- `address: 0.0.0.0` The IP address that will listen for connections. There is no reason to change this unless you want to limit what IPs can connect to your server or if your hosting provider instructs you to do so. -- `port: 19132` The port bedrock players will use to connect. If the option `clone-remote-port` is set to true, this port is ignored, and you'll have to use the same port on Bedrock as you would on Java to connect. -6. The _remote_ section in the `config.yml` determines which Java proxy the Bedrock players join. The proxy then configures which server the players are sent to. -- `address: auto` Leaving this at auto is recommended, because it means that Geyser configures the proxy's IP, port and auth-type itself. -- `port: 25565` This should be the port of the Java server. By default, it is set to 25565 - your hosting provider may have assigned a different port to your proxy, set that here. -7. For further Geyser config changes, like allowing Bedrock players to build on the nether roof, refer to [the config help article](/geyser/understanding-the-config/). - - -## Standalone Setup -Please read [Standalone Setup](/geyser/standalone/) to set up Geyser Standalone. - -## 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](/geyser/supported-hosting-providers/) for a list of supported providers). - -## Setup Videos -Setup tutorials in a variety of languages. Do note: Some might be outdated - but the written guide above is up-to-date. - -### English -**Connect to Java servers from Bedrock Edition! | GeyserMC Proxy Tutorial by [raimuakuna](https://www.youtube.com/channel/UCIMZsNCD_-prDETwRypAqmQ)** - -[![YouTube Video](https://img.youtube.com/vi/7rwfScY66Jc/0.jpg)](https://www.youtube.com/watch?v=7rwfScY66Jc) - -**How to play Java Servers in Minecraft Bedrock! by [PatarHD](https://www.youtube.com/channel/UCpowCAl4XV_hTQSYQpMWF6A)** - -[![YouTube Video](https://img.youtube.com/vi/IHg_ts3MgLY/0.jpg)](https://www.youtube.com/watch?v=IHg_ts3MgLY) - -**How to connect Bedrock players to Java servers Part One.** by [Casper](https://www.youtube.com/channel/UCHL0K3bOH0o7YoO5T-2_MzA) - -[![YouTube Video](https://img.youtube.com/vi/DHZHM1RBtfQ/0.jpg)](https://www.youtube.com/watch?v=DHZHM1RBtfQ) - -**How To Add Crossplay to Your Minecraft Server (Geyser Setup Guide).** by [The Breakdown](https://www.youtube.com/channel/UC6Ec5NXzcESo60F3UgtgQRA) - -[![YouTube Video](https://i.ytimg.com/vi/2HwqbDHWwu8/hqdefault.jpg)](https://youtu.be/2HwqbDHWwu8) - -### Russian -**ЗАШЕЛ НА ХАЙПИКСЕЛЬ С МКПЕ? ЧИТЕРСКИЙ КОНФИГ!** by [TOWUK](https://www.youtube.com/channel/UCK8v-rGsfCOkpbi0slIpAng) - -[![YouTube Video](https://img.youtube.com/vi/KcZZp05EfVQ/0.jpg)](https://www.youtube.com/watch?v=KcZZp05EfVQ) - -**ПОДНИМАЕМ СЕРВЕР JAVA+BEDROCK MINECRAFT** by [UncleZak](https://www.youtube.com/watch?v=nrFQ6BlOsLc) - -[![YouTube Video](https://img.youtube.com/vi/nrFQ6BlOsLc/0.jpg)](https://www.youtube.com/watch?v=nrFQ6BlOsLc) - -**Кроссплатформенный сервер Minecraft | GeyserMC Installation** by [Plutonium](https://www.youtube.com/channel/UCxXjEZgHcjMIYoHoDKOCBOw) - -[![YouTube Video](https://img.youtube.com/vi/nOwowRFZE9M/0.jpg)](https://www.youtube.com/watch?v=nOwowRFZE9M) +

Further information:

+ diff --git a/_docs/geyser/standalone.md b/_docs/geyser/standalone.md deleted file mode 100644 index 22b93e5..0000000 --- a/_docs/geyser/standalone.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: Geyser Standalone ---- - -# Setup of Geyser Standalone - - -## Prerequisites - -- The server you are connecting to has to support the latest version of Minecraft: Java Edition (at this time this is Minecraft {{ site.data.versions.java }}) -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](https://www.spigotmc.org/resources/19254/). -- The device running Geyser must support Java 16 or later. If you need help installing or updating, please see [PaperMC's Java update page](https://paper.readthedocs.io/en/latest/java-update/index.html). -- 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 [Floodgate](/floodgate/). -- Your Bedrock client has to be a supported version - at this time that is Bedrock version(s) {{ site.data.versions.bedrock }}. -- To allow Geyser Standalone to be reached outside the local network, 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. -- Currently, Geyser does not support key signing. To disable it (on servers running version 1.19 and higher), follow these instructions: Spigot, Paper, & all forks: Set `enfore-secure-profile: false` in the `server.properties` file. On BungeeCord: Set `enforce_secure_profile: false` in your `config.yml`. Using Velocity: set `force-key-authentication = false` in your `velocity.toml`. - - -## Standalone Setup -Please keep in mind, you need some sort of computer or host to run Geyser Standalone on. Applications such as Termux on Android are capable of running Geyser, but this largely depends on how powerful your Android device is. Please do so at your own risk. Instructions to run Geyser on Termux can be found [here](/geyser/setup/#termux-android). - -1. Download [Geyser Standalone](https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone). -2. Create a new folder for Geyser, and drop the jar in there. - -### GUI Setup (Recommended) -3. Double-click the jar file and all the necessary files for Geyser will be created. -4. Configure options such as the server you want to join in the Geyser config. A description of all options of the config can be found on the [Understanding the Config](/geyser/understanding-the-config/) page. -5. Stop the current instance of Geyser and re-run it. - -### Console Setup -3. 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](/geyser/creating-a-startup-script/) page for what to put into it. -4. Run the startup script/bat, and all the necessary files for Geyser will be created. -5. Configure options such as the server you want to join in the Geyser config. A description of all options of the config can be found on the [Understanding the Config](/geyser/understanding-the-config/) page. -6. Stop the current instance of Geyser and re-run it. - -Once you're done, open up Minecraft: Bedrock Edition and in the **Friends** tab, Geyser should show up there. If it does not show up, just add the Java IPv4 address and Bedrock port. - -### Standalone Setup (Geyser and Floodgate are not on the same server) -If you want to offload Geyser's processing you can host Geyser (Standalone) somewhere else and make it redirect to your server. -**Warning:** Do not forget to edit the remote section of your Geyser config. -See the [Floodgate](/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](/geyser/supported-hosting-providers/) for a list of supported providers). - -## Termux (Android) -Please read the disclaimer [here](/geyser/setup/#standalone-setup) before continuing. -1. Download and install [Termux](https://termux.com/) -2. Run `pkg install openjdk-17` -3. Run `wget https://ci.opencollab.dev/job/GeyserMC/job/Geyser/job/master/lastSuccessfulBuild/artifact/bootstrap/standalone/build/libs/Geyser-Standalone.jar` -4. Run `java -jar Geyser-Standalone.jar` - -OR - -We have an automated setup script for clean Termux installs, which 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](https://docs.google.com/spreadsheets/d/11DABHIIqwYQKj1L83AK9ywk_hYMjEkcaxpIg6phbTf0/edit?usp=sharing). -1. Install [Filza File Manager](http://cydia.saurik.com/package/com.tigisoftware.filza/). -2. Install [NewTerm 2](https://chariz.com/get/newterm). -4. Download PojavLauncher's Java 16 JRE for iOS and install it using Filza [here](https://github.com/PojavLauncherTeam/PojavLauncher_iOS/releases/download/v16-openjdk/openjdk-16-jre_16.0.0+git20201217.8383f41-2_iphoneos-arm.deb). -3. Download this package containing modified java commands, and install it using Filza [here](https://cdn.discordapp.com/attachments/558829512633090048/834014323755319306/com.letschill.java_0.1_iphoneos-arm.deb) (Note: Not an official GeyserMC project, install at your own risk). -4. Open NewTerm 2 and run `wget https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone` -5. Run `java -jar Geyser-Standalone.jar`. -6. Geyser should show up in the Friends tab inside Minecraft. - -**Note:** -Due to the iOS 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. diff --git a/_includes/setup/host-provider.html b/_includes/setup/host-provider.html new file mode 100644 index 0000000..9ef34c1 --- /dev/null +++ b/_includes/setup/host-provider.html @@ -0,0 +1,31 @@ +{% assign all_providers = site.data.providers.support | concat: site.data.providers.built_in | sort: 'name' %} +
+ +
+
+ + diff --git a/_includes/setup/instructions/floodgate/fabric.md b/_includes/setup/instructions/floodgate/fabric.md new file mode 100644 index 0000000..3872f96 --- /dev/null +++ b/_includes/setup/instructions/floodgate/fabric.md @@ -0,0 +1,11 @@ + +# Floodgate-Fabric setup + +1. Download Floodgate-Fabric from the [modrinth page](https://modrinth.com/mod/floodgate). +2. Place the Floodgate-Fabric.jar in the `mods` folder, and restart the server. **You also need [FabricAPI](https://modrinth.com/mod/fabric-api) installed.** +3. Change `auth-type` in Geyser's config to `floodgate`. +4. Restart the server. + + +**Note for Fabric behind a Velocity proxy:** +You will need to configure FabricProxyLite to allow the Fabric server to receive data from Velocity. \ No newline at end of file diff --git a/_includes/setup/instructions/floodgate/proxy.md b/_includes/setup/instructions/floodgate/proxy.md new file mode 100644 index 0000000..ce7a6c7 --- /dev/null +++ b/_includes/setup/instructions/floodgate/proxy.md @@ -0,0 +1,27 @@ +# Floodgate setup on a BungeeCord/Velocity proxy + + + +1. Download Floodgate for your proxy software from the [download page](https://geysermc.org/download). +2. Place the Floodgate jar in the `plugins` folder, and restart the proxy server. +3. Change `auth-type` in Geyser's config to `floodgate`. +4. Restart the server. + +## Installing Floodgate on servers behind the proxy + +This is only needed when you want to use the Floodgate API on your backend server(s) behind a proxy. + +1. After installing Floodgate on the proxy, install Floodgate on the backend servers (either Floodgate-Spigot, or Floodgate-Fabric). +2. Enable `ip_forward` in your BungeeCord `config.yml` if using BungeeCord. For Velocity, set up [player information forwarding](https://docs.papermc.io/velocity/player-information-forwarding). +3. Set bungeecord to true in your spigot.yml. When using Velocity, see their guide, as they have multiple options that require different setups. +4. Start the proxy server. +5. Edit the Floodgate config on your proxy server and set send-floodgate-data to true. +6. Copy the `key.pem` file in the proxy Floodgate config folder to all backend servers’ Floodgate config folder. +7. Restart the backend servers and proxy server. + + diff --git a/_includes/setup/instructions/floodgate/spigot.md b/_includes/setup/instructions/floodgate/spigot.md new file mode 100644 index 0000000..bbd9a41 --- /dev/null +++ b/_includes/setup/instructions/floodgate/spigot.md @@ -0,0 +1,6 @@ +# Floodgate-Spigot setup + +1. Download Floodgate-Spigot from the [download page](https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot). +2. Place the Floodgate-Spigot.jar in the `plugins` folder, and restart the server. +3. Change `auth-type` in Geyser's config to `floodgate`. +4. Restart the server. diff --git a/_includes/setup/instructions/floodgate/standalone.md b/_includes/setup/instructions/floodgate/standalone.md new file mode 100644 index 0000000..9f26e3f --- /dev/null +++ b/_includes/setup/instructions/floodgate/standalone.md @@ -0,0 +1,15 @@ +# Floodgate setup with Geyser-Standalone + + + +1. Download Floodgate from the [download page](https://geysermc.org/download). +2. Install the Floodgate jar - see the platform instructions for detailed info. +3. Change `auth-type` in Geyser Standalone's config to `floodgate`. +4. Copy the `key.pem` file in the Floodgate config folder to the same directory as Geyser Standalone. +5. Restart Geyser-Standalone. + + diff --git a/_includes/setup/instructions/geyser/provider/fabric.md b/_includes/setup/instructions/geyser/provider/fabric.md new file mode 100644 index 0000000..c9aac8a --- /dev/null +++ b/_includes/setup/instructions/geyser/provider/fabric.md @@ -0,0 +1,37 @@ + +# Fabric setup with server hosting provider + + + +1. Select your server hosting provider in the dropdown above. +2. Download the mod from [the download page](https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/fabric). +3. Place the Geyser-Fabric.jar in the `mods` folder, and restart the server. **You also need [FabricAPI](https://modrinth.com/mod/fabric-api).** +4. Open your Geyser config, located in `/config/Geyser-Fabric/config.yml`, and find the following: + + ```yaml + bedrock: + # The IP address that will listen for connections. + # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. + #address: 0.0.0.0 + + # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server. + port: 19132 + + # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock. + # This option makes the Bedrock port the same as the Java port every time you start the server. + # This option is for the plugin version only. + clone-remote-port: false + ``` + The vital part is the port. This is the port that Bedrock players will use to connect to your server. + Follow the instructions in the provider selector - change the port, and if necessary, `clone-remote-port` & `address`. + If `clone-remote-port` is enabled, the bedrock port will be overwritten with the Java port!
+ **Important**: Other services/mods that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser. + +5. Verify whether connections are possible by running `geyser connectiontest :` in the console. + + \ No newline at end of file diff --git a/_includes/setup/instructions/geyser/provider/proxy.md b/_includes/setup/instructions/geyser/provider/proxy.md new file mode 100644 index 0000000..0513356 --- /dev/null +++ b/_includes/setup/instructions/geyser/provider/proxy.md @@ -0,0 +1,39 @@ + +# Proxy setup with server hosting provider + + + +1. Select your server hosting provider in the dropdown above. +2. Download the plugin for your proxy software from [the download page](https://geysermc.org/download). +3. Place the Geyser jar in the `plugins` folder, and restart the server. +4. Open your Geyser config, located in `/plugins/Geyser-xyz/config.yml`, and find the following: + + ```yaml + bedrock: + # The IP address that will listen for connections. + # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. + #address: 0.0.0.0 + + # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server. + port: 19132 + + # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock. + # This option makes the Bedrock port the same as the Java port every time you start the server. + # This option is for the plugin version only. + clone-remote-port: false + ``` + The vital part is the port. This is the port that Bedrock players will use to connect to your server. + Follow the instructions in the provider selector - change the port, and if necessary, `clone-remote-port` & `address`. + If `clone-remote-port` is enabled, the bedrock port will be overwritten with the Java port!
+ **Important**: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser. + +5. Verify whether connections are possible by running `geyser connectiontest :` in the console. + + \ No newline at end of file diff --git a/_includes/setup/instructions/geyser/provider/spigot.md b/_includes/setup/instructions/geyser/provider/spigot.md new file mode 100644 index 0000000..42600ee --- /dev/null +++ b/_includes/setup/instructions/geyser/provider/spigot.md @@ -0,0 +1,37 @@ + +# Paper / Spigot setup with server hosting provider + + + +1. Select your server hosting provider in the dropdown above. +2. Download the plugin from [the download page](https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot). +3. Place the Geyser-Spigot.jar in the `plugins` folder, and restart the server. +4. Open your Geyser config, located in `/plugins/Geyser-Spigot/config.yml`, and find the following: + + ```yaml + bedrock: + # The IP address that will listen for connections. + # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. + #address: 0.0.0.0 + + # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server. + port: 19132 + + # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock. + # This option makes the Bedrock port the same as the Java port every time you start the server. + # This option is for the plugin version only. + clone-remote-port: false + ``` + The vital part is the port. This is the port that Bedrock players will use to connect to your server. + Follow the instructions in the provider selector - change the port, and if necessary, `clone-remote-port` & `address`. + If `clone-remote-port` is enabled, the bedrock port will be overwritten with the Java port!
+ **Important**: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser. + +5. Verify whether connections are possible by running `geyser connectiontest :` in the console. + + diff --git a/_includes/setup/instructions/geyser/selfhost/fabric.md b/_includes/setup/instructions/geyser/selfhost/fabric.md new file mode 100644 index 0000000..1349b3b --- /dev/null +++ b/_includes/setup/instructions/geyser/selfhost/fabric.md @@ -0,0 +1,51 @@ + +# Fabric setup - self-hosting + + + +1. Download the mod from [the download page](https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/fabric). +2. Place the Geyser-Fabric.jar in the `mods` folder, and restart the server. **You also need [FabricAPI](https://modrinth.com/mod/fabric-api).** +3. Open your Geyser config, located in `/config/Geyser-Fabric/config.yml`, and find the following: + + ```yaml + bedrock: + # The IP address that will listen for connections. + # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. + #address: 0.0.0.0 + + # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server. + port: 19132 + ``` + The vital part is the port. This is the port that Bedrock players will use to connect to your server! + If you enable `clone-remote-port`, the port will be overridden and the Java port is used. + Since you are self-hosting, you can choose the port freely - the default port is 19132.
+ **Important**: Other services/mods that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser. +
+ +4. Connecting to your server +

+ **Connecting locally in the same network**
+ On the same device as the server, you can connect using `localhost`, or `127.0.0.1` as the address. + Do note: When hosting and playing on the same Windows device, you will need the [loopback fix](/geyser/fixing-unable-to-connect-to-world/#Using-Geyser-on-the-same-computer). + Other devices in the same local network can use your local IPv4 to connect - it starts with `10.` or `192.168.`. +

+ **Connecting from a different network**
+ You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join. + To achieve that, you have two options:
+ + - Portforwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. + After doing this, players can connect with your public IPv4 + port to your server. + See [here](https://www.lifewire.com/how-to-port-forward-4163829) for a helpful guide.
+ + - playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use + the playit.gg service to create a tunnel for you to route the traffic through. See our [playit.gg guide](/geyser/playit-gg). + Ngrok will not work since it is TCP-only.
+ +5. Verify whether connections from other networks are possible by running `geyser connectiontest :` in the console. + + \ No newline at end of file diff --git a/_includes/setup/instructions/geyser/selfhost/proxy.md b/_includes/setup/instructions/geyser/selfhost/proxy.md new file mode 100644 index 0000000..c88ec3d --- /dev/null +++ b/_includes/setup/instructions/geyser/selfhost/proxy.md @@ -0,0 +1,53 @@ + +# Proxy setup - self-hosting + + + +1. Download the plugin for your proxy software from [the download page](https://geysermc.org/download). +2. Place the Geyser jar in the `plugins` folder, and restart the server. +3. Open your Geyser config, located in `/plugins/Geyser-xyz/config.yml`, and find the following: + + ```yaml + bedrock: + # The IP address that will listen for connections. + # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. + #address: 0.0.0.0 + + # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server. + port: 19132 + ``` + The vital part is the port. This is the port that Bedrock players will use to connect to your server! + If you enable `clone-remote-port`, the port will be overridden and the Java port is used. + Since you are self-hosting, you can choose the port freely - the default port is 19132.
+ **Important**: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser. +
+ +4. Connecting to your server +

+ **Connecting locally in the same network**
+ On the same device as the server, you can connect using `localhost`, or `127.0.0.1` as the address. + Do note: When hosting and playing on the same Windows device, you will need the [loopback fix](/geyser/fixing-unable-to-connect-to-world/#Using-Geyser-on-the-same-computer). + Other devices in the same local network can use your local IPv4 to connect - it starts with `10.` or `192.168.`. +

+ **Connecting from a different network**
+ You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join. + To achieve that, you have two options:
+ + - Portforwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. + After doing this, players can connect with your public IPv4 + port to your server. + See [here](https://www.lifewire.com/how-to-port-forward-4163829) for a helpful guide.
+ + - playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use + the playit.gg service to create a tunnel for you to route the traffic through. See our [playit.gg guide](/geyser/playit-gg). + Ngrok will not work since it is TCP-only.
+ +5. Verify whether connections from other networks are possible by running `geyser connectiontest :` in the console. + + \ No newline at end of file diff --git a/_includes/setup/instructions/geyser/selfhost/spigot.md b/_includes/setup/instructions/geyser/selfhost/spigot.md new file mode 100644 index 0000000..0a0b36b --- /dev/null +++ b/_includes/setup/instructions/geyser/selfhost/spigot.md @@ -0,0 +1,51 @@ + +# Paper / Spigot setup - self-hosting + + + +1. Download the plugin from [the download page](https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot). +2. Place the Geyser-Spigot.jar in the `plugins` folder, and restart the server. +3. Open your Geyser config, located in `/plugins/Geyser-Spigot/config.yml`, and find the following: + + ```yaml + bedrock: + # The IP address that will listen for connections. + # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. + #address: 0.0.0.0 + + # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server. + port: 19132 + ``` + The vital part is the port. This is the port that Bedrock players will use to connect to your server! + If you enable `clone-remote-port`, the port will be overridden and the Java port is used. + Since you are self-hosting, you can choose the port freely - the default port is 19132.
+ **Important**: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser. +
+ +4. Connecting to your server +

+ **Connecting locally in the same network**
+ On the same device as the server, you can connect using `localhost`, or `127.0.0.1` as the address. + Do note: When hosting and playing on the same Windows device, you will need the [loopback fix](/geyser/fixing-unable-to-connect-to-world/#Using-Geyser-on-the-same-computer). + Other devices in the same local network can use your local IPv4 to connect - it starts with `10.` or `192.168.`. +

+ **Connecting from a different network**
+ You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join. + To achieve that, you have two options:
+ + - Portforwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. + After doing this, players can connect with your public IPv4 + port to your server. + See [here](https://www.lifewire.com/how-to-port-forward-4163829) for a helpful guide.
+ + - playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use + the playit.gg service to create a tunnel for you to route the traffic through. See our [playit.gg guide](/geyser/playit-gg). + Ngrok will not work since it is TCP-only.
+ +5. Verify whether connections from other networks are possible by running `geyser connectiontest :` in the console. + + diff --git a/_includes/setup/instructions/geyser/selfhost/standalone.md b/_includes/setup/instructions/geyser/selfhost/standalone.md new file mode 100644 index 0000000..7c74148 --- /dev/null +++ b/_includes/setup/instructions/geyser/selfhost/standalone.md @@ -0,0 +1,101 @@ +# Geyser-Standalone Setup + + + +1. Download Geyser Standalone from [here](https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone). +2. Create a new folder for Geyser, and drop the jar in there. +3. Start Geyser Standalone: + - **GUI** (Recommended):
+ Double-click the jar file and all the necessary files for Geyser will be created. + - Or use the **console setup**:
+ Create a new bat or startup script, similar to the one you'd use for a Spigot/Paper server, and take a look at [this](/geyser/creating-a-startup-script/) page for what to put into it.
+ Run the startup script/bat, and all the necessary files for Geyser will be created. + +4. Open your Geyser config (`config.yml`), and find the following: + + ```yaml + bedrock: + # The IP address that will listen for connections. + # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server. + #address: 0.0.0.0 + + # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server. + port: 19132 + ``` + The `port` is the port Bedrock players will enter to connect to the server.
+ Uncommenting and changing `address` here is only needed if you need to limit connections to a specific IP address. +
+ + To configure which Java Edition server Geyser Standalone will send players to, find the remote section: + ```yaml + remote: + # The IP address of the remote (Java Edition) server + # If it is "auto", for standalone version the remote address will be set to 127.0.0.1. + address: auto + + # The port of the remote (Java Edition) server + port: 25565 + + # Authentication type. Can be offline, online, or floodgate (see https://github.com/GeyserMC/Geyser/wiki/Floodgate). + auth-type: online + ``` + Here, change `address` to the Java server's address, or to `auto` if the server is on the same machine as Geyser-Standalone. +Then, change `port` to the Java server's port. If you have set up Floodgate on the remote Java server, you can set auth-type to "floodgate" - otherwise, +set it to either `online` for an online mode server, or `offline` for an offline mode server. To install and set up Floodgate with a Standalone server, see [here](/floodgate/setup).
+ +5. Connecting to your server +

+ **Connecting locally in the same network**
+ On the same device as the server, you can connect using `localhost`, or `127.0.0.1` as the address. + Do note: When hosting and playing on the same Windows device, you will need the [loopback fix](/geyser/fixing-unable-to-connect-to-world/#Using-Geyser-on-the-same-computer). + Other devices in the same local network can use your local IPv4 to connect - it starts with `10.` or `192.168.`. + Alternatively, open Minecraft: Bedrock edition, and join the LAN-Server in the **Friends** tab. +

+ **Connecting from a different network**
+ You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join. + To achieve that, you have two options:
+ + - Portforwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. + After doing this, players can connect with your public IPv4 + port to your server. + See [here](https://www.lifewire.com/how-to-port-forward-4163829) for a helpful guide.
+ + - playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use + the playit.gg service to create a tunnel for you to route the traffic through. See our [playit.gg guide](/geyser/playit-gg). + Ngrok will not work since it is TCP-only.
+ +6. Verify whether connections from other networks are possible by running `geyser connectiontest :` in the console. + +# Running Geyser-Standalone on Android/iOS + + + +## Termux (Android) +1. Download and install [Termux](https://termux.com/) +2. Run `pkg install openjdk-17` +3. Run `wget https://ci.opencollab.dev/job/GeyserMC/job/Geyser/job/master/lastSuccessfulBuild/artifact/bootstrap/standalone/build/libs/Geyser-Standalone.jar` +4. Run `java -jar Geyser-Standalone.jar` + +OR + +We have an automated setup script for clean Termux installs, which 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](https://docs.google.com/spreadsheets/d/11DABHIIqwYQKj1L83AK9ywk_hYMjEkcaxpIg6phbTf0/edit?usp=sharing). +1. Install [Filza File Manager](http://cydia.saurik.com/package/com.tigisoftware.filza/). +2. Install [NewTerm 2](https://chariz.com/get/newterm). +3. Download PojavLauncher's Java 16 JRE for iOS and install it using Filza [here](https://github.com/PojavLauncherTeam/PojavLauncher_iOS/releases/download/v16-openjdk/openjdk-16-jre_16.0.0+git20201217.8383f41-2_iphoneos-arm.deb). +4. Download this package containing modified java commands, and install it using Filza [here](https://cdn.discordapp.com/attachments/558829512633090048/834014323755319306/com.letschill.java_0.1_iphoneos-arm.deb) (Note: Not an official GeyserMC project, install at your own risk). +5. Open NewTerm 2 and run `wget https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone` +6. Run `java -jar Geyser-Standalone.jar`. +7. Geyser should show up in the Friends tab inside Minecraft. + +**Note:** +Due to the iOS 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. \ No newline at end of file diff --git a/_includes/setup/instructions/geyser/tabs.html b/_includes/setup/instructions/geyser/tabs.html new file mode 100644 index 0000000..c673423 --- /dev/null +++ b/_includes/setup/instructions/geyser/tabs.html @@ -0,0 +1,37 @@ +
+ + + + {% if include.show_standalone != nil %} + + {% endif %} +
+ +
+
+ {% capture my_include %}{% include setup/instructions/geyser/{{include.type}}/spigot.md %}{% endcapture %} + {{ my_include | markdownify }} +
+
+ {% capture my_include %}{% include setup/instructions/geyser/{{include.type}}/fabric.md %}{% endcapture %} + {{ my_include | markdownify }} +
+
+ {% capture my_include %}{% include setup/instructions/geyser/{{include.type}}/proxy.md %}{% endcapture %} + {{ my_include | markdownify }} +
+ {% if include.show_standalone != nil %} +
+ {% capture my_include %}{% include setup/instructions/geyser/{{include.type}}/standalone.md %}{% endcapture %} + {{ my_include | markdownify }} +
+ {% endif %} +
\ No newline at end of file diff --git a/_includes/sidebar-nav.html b/_includes/sidebar-nav.html index 8aecaf7..227ff6e 100644 --- a/_includes/sidebar-nav.html +++ b/_includes/sidebar-nav.html @@ -6,10 +6,16 @@ diff --git a/_includes/sidebar-page.html b/_includes/sidebar-page.html index eda4ebe..c2b1c9e 100644 --- a/_includes/sidebar-page.html +++ b/_includes/sidebar-page.html @@ -2,4 +2,4 @@ Create Wiki issue/bug report Create Geyser issue/bug report -
+
diff --git a/_layouts/default.html b/_layouts/default.html index 74a9c74..d27d457 100755 --- a/_layouts/default.html +++ b/_layouts/default.html @@ -80,9 +80,9 @@ -