> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.empowerservers.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to Install and Set Up Geyser On Your Minecraft Server


# 🌉 How to Install Geyser on Your Minecraft Server (Enable Bedrock Players!)

| **Quick Tip:** Looking for a Minecraft server? Visit [Empower Servers](https://empowerservers.com) and use coupon code **GETSTARTED** for 50% off your first month.
---

## 🌟 What is Geyser?

Geyser allows **Minecraft: Bedrock Edition** players (on mobile, console, and Windows 10) to connect directly to your **Minecraft Java Edition** server. It acts as a bridge for true cross-play!
---

## 🛠️ How to Install Geyser:

1. **Log into the [Control Panel](https://gp.empowerservers.com).**

2. **Click 'Manage'** next to your server.

   ![](https://storage.crisp.chat/users/helpdesk/website/-/8/5/b/c/85bc5985980c3800/image_3h5v0r.png)

3. **Navigate to your server files.**

   ![](https://storage.crisp.chat/users/helpdesk/website/-/8/5/b/c/85bc5985980c3800/image_cvgzs8.png)

4. **Open the `plugins` folder.**

   Geyser needs a `plugins` folder — make sure your server is running **PaperMC** or **Spigot** (not Vanilla).

5. **Download the Geyser Plugin:**

   - Visit [GeyserMC GitHub Releases](https://github.com/GeyserMC/Geyser/releases).
   - Download the latest **Geyser-Spigot** `.jar` file.

6. **Upload Geyser to Your Server:**

   Upload the `.jar` into the `plugins` folder using the **Upload** button.

   ![](https://storage.crisp.chat/users/helpdesk/website/-/8/5/b/c/85bc5985980c3800/image_usog3.png)

7. **Restart Your Server:**

   Restart your server to generate the Geyser configuration files.

   ![](https://storage.crisp.chat/users/helpdesk/website/-/8/5/b/c/85bc5985980c3800/image_3zn4pt.png)
---

## 🌐 Setting Up a Port for Bedrock Connections

Geyser requires a separate port for Bedrock players to join.  
**The default port (19132) will not work automatically** — you must assign a new free port.

### How to assign a port:

1. **Go to the 'Network' tab** inside your server control panel.

   ![](https://storage.crisp.chat/users/helpdesk/website/-/8/5/b/c/85bc5985980c3800/image_usog3.png)

2. **Use an Additional Allocation** if available:
   - If you already have an unused port listed, you can assign it for Geyser.

3. **Or create a New Allocation**:
   - Click **"Create Allocation"**.
   - The panel will generate a new open port for your server.

4. **Configure Geyser to use your new port:**

   - Navigate to `/plugins/Geyser-Spigot/config.yml`.
   - Find:
     
```
bedrock:
       address: 0.0.0.0
       port: 19132
```
   - Change `port: 19132` to the **new port** you were assigned.

5. **Save your changes and restart the server again.**
---

## 🖥️ How Bedrock Players Can Connect:

After setup, Bedrock players can join using:

- **Server Address:** Your server IP
- **Port:** The new allocated port you set for Geyser

Example:

If your server IP is `123.45.67.89` and the assigned port is `7708`, players would connect with:

```
Server IP: 123.45.67.89
Port: 7708
```
---

# 📋 Additional Configuration Options (Optional)

- **Authentication:**  
  In `config.yml`, set `auth-type: online` to require Bedrock players to log in with a Mojang/Microsoft account.  
  Set `auth-type: floodgate` if you want to allow Bedrock players without Java accounts (requires Floodgate).

- **Floodgate Support:**  
  If you want players to connect without needing a Java account, install [Floodgate](https://github.com/GeyserMC/Floodgate) alongside Geyser.

- **Customization:**  
  You can change MOTD, ping responses, and even Bedrock skin handling inside the Geyser settings.
---

# 🌎 Important Notes

- **Update both Geyser and your server** regularly for best compatibility.
- Not all Java plugins and features work perfectly for Bedrock players.
- Always **make a full backup** before installing or updating major plugins.