* Prepare for configurate changes, update API version, document all commands * Forgot these * Document GeyserIntegratedPack behavior * Update wiki/other/geyserintegratedpack.md * Update wiki/geyser/current-limitations.md Co-authored-by: Olivia <chew@chew.pw> --------- Co-authored-by: Olivia <chew@chew.pw>
102 lines
5.1 KiB
Plaintext
102 lines
5.1 KiB
Plaintext
---
|
|
title: Geyser Standalone Setup
|
|
description: Learn how to set up Geyser Standalone, a standalone Java program that allows you to connect Bedrock players to your Java Edition server.
|
|
hide_title: true
|
|
---
|
|
|
|
:::info
|
|
You need to have Java 17 or higher installed to run Geyser. To run Geyser Standalone on Android, see the bottom of this page.
|
|
:::
|
|
|
|
:::caution
|
|
Geyser-Standalone is NOT a plugin or mod! It is a standalone Java program that you would run separately to your Java Edition server.
|
|
:::
|
|
|
|
#### General Setup & Configuration \{#general-setup--configuration}
|
|
|
|
1. Download Geyser Standalone from [here](/download).
|
|
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](/wiki/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 Geyser will bind on to listen for incoming Bedrock connections.
|
|
# Generally, you should only change this if you want to limit what IPs can connect to your server.
|
|
address: 0.0.0.0
|
|
|
|
# The port that will Geyser will listen on for incoming Bedrock connections.
|
|
# Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
|
|
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
|
|
java:
|
|
# The IP address of the Java Edition server.
|
|
address: 127.0.0.1
|
|
|
|
# The port of the Java Edition server.
|
|
port: 25565
|
|
|
|
# What type of authentication Bedrock players will be checked against when logging into the Java server.
|
|
# Can be "floodgate" (see https://wiki.geysermc.org/floodgate/), "online", or "offline".
|
|
auth-type: online
|
|
```
|
|
Here, change `address` to the Java server's address, or leave it as-is 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](/wiki/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](/wiki/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:
|
|
|
|
- Port forwarding: 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](/wiki/geyser/port-forwarding/) 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](/wiki/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 <ip> <port>` in the console.
|
|
|
|
#### Running Geyser-Standalone on Android \{#running-geyser-standalone-on-android}
|
|
|
|
:::caution
|
|
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.
|
|
:::
|
|
|
|
##### Termux (Android) \{#termux-android}
|
|
1. Download and install [Termux](https://termux.com/)
|
|
2. Run `pkg install openjdk-17`
|
|
3. Run `wget https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone`
|
|
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
|
|
```
|
|
|