diff --git a/_docs/floodgate/setup.md b/_docs/floodgate/setup.md index 7997b1b..7539bf6 100644 --- a/_docs/floodgate/setup.md +++ b/_docs/floodgate/setup.md @@ -12,17 +12,18 @@ Geyser: [https://ci.opencollab.dev/job/GeyserMC/job/Geyser/job/master/](https:// ## 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/setup/#standalone-setup). Floodgate does not replace Geyser. +- 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. ## Setting Up -*Any reference to Spigot here also refers to any compatible server software such as Paper.* +*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 from [here](https://ci.opencollab.dev/job/GeyserMC/job/Floodgate/job/master/) and add it to your plugins folder on your frontend server. - `floodgate-spigot.jar` for Spigot, Paper, etc + - `floodgate-fabric.jar` for Fabric, can be downloaded [here](https://ci.opencollab.dev/job/GeyserMC/job/Floodgate-Fabric/job/master/). (Requires [FabricAPI](https://www.curseforge.com/minecraft/mc-mods/fabric-api)) - `floodgate-bungee.jar` for BungeeCord, Waterfall, etc - `floodgate-velocity.jar` for Velocity - Change the `auth-type` in the Geyser config to `floodgate`. @@ -33,15 +34,15 @@ For BungeeCord/Velocity setups: you only are required to install Floodgate on th ### Installing Floodgate also on Spigot servers behind BungeeCord or Velocity -This is only needed when you want to use the Floodgate API on your Spigot server(s) behind a proxy. +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 -- Set `bungeecord` to `true` in your `spigot.yml` +- 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 Spigot 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 Spigot servers and proxy server. +- *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 @@ -52,12 +53,12 @@ In your Floodgate config, change `username-prefix` to whichever prefix you desir 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://floodgate-uuid.heathmitchell1.repl.co/) page. If this doesn't work, then try this method: +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 (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. +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 Bukkit 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. +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 Bukkit version of Floodgate, there is an unofficial plugin that adds Skript support [here](https://github.com/Camotoy/floodgate-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).