Geyser/Floodgate

### **A Quick Warning**

We're excited you want to play with us on our server from your Bedrock account! We use Java server software because it's been around longer, it's more stable and offers significantly more features, and it's amazing that we have the opportunity to invite you to join our community! That being said we do have to issue you a quick warning. **GEYSER IS NOT PERFECT.** Some features may not work as intended. You may experience bugs or connection issues. Purchasing premium items from the custom shops may not work as expected. This is especially true with skins and heads. Refunds will ***not*** be issued in these circumstances. It is the player's responsibility to read and understand this page when joining via Geyser. It is the player's responsibility to ask for clarification on topics they do not understand.

That said I hope you find this breakdown is informative and appropriately prepares you for challenges you may face using the Geyser/Floodgate Proxy.

### **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. Geyser can be used to join any modern Java server and doesn't require anything extra to be done on your end.

### **How does it work?**

Java and Bedrock are written in two completely different programming languages, so they have no idea how to talk to each other. What we need is a translator between the two! Geyser is a middleware, which translates all the incoming and outgoing packets between your computer and the server.

### **What is Floodgate?**

Floodgate is a hybrid mode plugin which allows for Minecraft: Bedrock Accounts to join Minecraft: Java Edition servers **without needing a Minecraft: Java Edition account**. If we didn't have Floodgate installed you would have to log into a Minecraft: Java Edition account to play. Obviously, not all of you own a copy of Java so Floodgate is a necessary tool we use to make sure we can all play together.

### **How does it work?**

Floodgate works by telling the server that you are actually a Java player and not some foreign unknown entity. In doing it's job Floodgate automatically adds an \_ (underscore) in front of your username. If your username is **Voyager** you would appear in the Java server as **\_Voyager**. If you own a **Bedrock account AND a Java account** the server sees those as separate users.

### **Bedrock/Java Account Linking**

Floodgate includes an *account linking feature* which will disable your Bedrock account and have the server fetch your Java player data when you log in from Bedrock instead. Not only is this extremely useful, it's mandatory for players who own both copies of the game. There are significant modes of abuse and exploitation available to players who have more than one account. In order to adhere to the Server Rules, dual accounts must be linked. We highlight the simple process here:

* Log in on java and run **"/linkaccount** *\_bedrockusername***" DO NOT FORGET THE \_ (underscore) or this will not work!**
* You will get a message asking you to run the **"/linkaccount** *javausername* XXXX**"** command on Bedrock *(keep an eye out for the special pin 'XXXX')*.
* Run the command given to you in Bedrock, **include the special pin.** You will be kicked on Bedrock. Upon relogging, you will be logged in as your java account.

No credentials for either your Java or Bedrock account are needed nor stored in this process.

### **What is left to be fixed?**

While Geyser/Floodgate is a *miracle solution* for cross platform play in the Minecraft community **it is not flawless**. There are a few known issues which are either actively being worked on to correct or are technically out of reach for the developers given the current state of the official release of the game.

#### Skins

Due to how Minecraft: Java Edition handles skins, Bedrock players from some platforms will appear as Steve or Alex to other Java players.

#### Movement and Ladders

There are still, to this day, some issues with movement and ladders. Traversing over transparent blocks such as glass panes, lanterns, beds and fences can cause 'rubber banding' and lag. Ladders may or may not work depending on positioning, length and angle of approach. Sometimes players have better luck using ladders if they being their climb one block up on a ladder rather than starting it on the bottom rung. Geyser players may be kicked from the game if the server determines they have "moved incorrectly", though this issue has been lesser as of recent builds.

#### Some Server Features

Some shops in the /hub menu may not open when clicked. To work around this use the commands from the command list to open the specific page you're looking for instead.

* **Banner Hats** - Banners from the Premium Cosmetic shop are not displaying correctly at this time.
* **All Custom Heads** - (currently, though this will be reduced to just heads in ***INVENTORIES*** at some point in the near future.
* **Leaving Jobs** - You may not be able to LEAVE a job you've taken in the Careers menu. If this is the case check the command list for a command to issue to leave your current job.
* **Lag** - There can be some moderate to significant lag in some areas of the city hub, especially around areas where there are a lot of particles or entities. Better computers will handle the load of these structures and entities more elegantly than consoles or older pcs.

#### Other Items

* Lecterns
* Near-perfect movement (to the point where anticheat on large servers is unlikely to ban you)
* Resource pack conversion/CustomModelData
* Some Entity Flags
* The Following Inventories
	+ Enchantment Table (as a proper GUI)
	+ Beacon
	+ Cartography Table
	+ Stonecutter
	+ Structure Block
	+ Horse Inventory
	+ Loom
	+ Smithing Table
	+ Grindstone

### **What CANNOT Be Fixed?**

The following things can't be fixed because of Bedrock limitations. They might be fixable in the future, but not as of now.

* Custom heads ***in inventories***
* Clickable links in chat
* Glowing effect
* Custom armor stand poses

Geyser players who purchase premium custom heads despite this warning will not be refunded.

### **Troubleshooting**

#### Invalid packet id:

This usually means one of two things:

* You're trying to log in without an Xbox account. Floodgate requires an Xbox account to authenticate the Bedrock player.

#### java.lang.NumberFormatException: For input string: ""

* You're trying to log in without an Xbox account. Floodgate requires an Xbox account to authenticate the Bedrock player.

#### Sometimes, when I go really far out, the world starts to experience very odd visual bugs...

This is a Bedrock client issue caused by Bedrock being 32-bit and Java being 64-bit. It can not be fixed. If you are using Geyser please try to stay within 50,000 blocks of spawn.

### **FAQ**

#### So, how does Redstone work?

Redstone, along with any other mechanics like commands, farms, etc., will work exactly like Java Edition since joining a Java Edition server and Geyser does not modify server behavior.

#### How can Bedrock players hold items in their offhand?

You can use the command `/geyser offhand`, which will swap the item in their main hand and offhand.