Setup

Host Provider

Select a providerNot listed365HostsAklizApex HostingAquatisArth HostingAternosBedrockHostBirdflopBisectHostingBloom.HostCloud NordClovuxConsulhostingCraft-HostingCreeperHostCubes HostingDedicatedMCElfIDCEnviroMCexarotonExtraVMFadeHostFakaHedaFalixNodesFeatherFerox HostingFluctis HostingFREAKHOSTINGFreeMcServer.netFusion HostingGameHosting.itGameProHostGGServersGPortalHeavynodeHicoriaHost HavocHosterfyHostEZHosting-MinecraftHumbleServersKaasHostingKeKsHostKinetic HostingLilypadMC-HOST24.deMCFORFREE.DEMCPEhost.ruMCServerHostMeloncubeMinecraft-Hosting.proMinefortMinehutMineStratorModrinth HostingMyArenaNetbelaNFOserversNiCraftNitradoNodecraftOMGServOrionNodesPaperNodesPebblehostPhysgunPiglinHostPlanetNodePlay HostingPUBCSPufferfish HostRamShardRedline HostingRevivenodeScalaCubeServer.proShockbyteSimpleGameHostingSkynode.proSnakecraft HostingSparked HostSRKHOSTSTIPESyntexHostingThe Minecraft HostingTNAHostingTurboHostUltimateSRVUltraServersVemoxHostVexyHostVirtual GladiatorsVolcano HostingVoltHostingVultamWasabi HostingWepwawetWinterNodeWiseHostingWitherHostingZapHosting

Provider 操作指南

选择一个 provider 以查看具体的安装说明

Paper / Spigot

信息

If your server is not running 1.21.11, you will need to install ViaVersion. See also this page on supported versions.

1. Select your server hosting provider in the dropdown above.

2. Download the plugin from the download page.

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:

   bedrock:
     # The IP address that will listen for 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
   
     # 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.
     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 <ip> <port> in the console.

信息

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.

Modded Servers

警告

Geyser-Fabric and Geyser-NeoForge run only on a 1.21.11 server. See this page for more details.

信息

Geyser only works with server-side mods. Mods that require a client-side install will not work!

1. Select your server hosting provider in the dropdown above.

2. Download the mod from the download page.

3. Place the Geyser mod jar in the mods folder, and restart the server. For Fabric, you will also need FabricAPI.

4. Open your Geyser config, located in /config/Geyser-Fabric/config.yml (or /config/Geyser-NeoForge/config.yml), and find the following:

   bedrock: 
     # The IP address that will listen for 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
   
     # 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.
     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 <ip> <port> in the console.

信息

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.

Proxy Servers

信息

• Install Geyser only on the proxy server! You can install Floodgate on all servers for better skin support & network-wide Floodgate API availability for other plugins.
• All servers on the network must accept 1.21.11 Java clients, as Geyser imitates one.

1. Select your server hosting provider in the dropdown above.

2. Download the plugin for your proxy software from the download page.

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:

   bedrock:
     # The IP address that will listen for 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
   
     # 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.
     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 <ip> <port> in the console.

信息

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.

Self Host

Paper / Spigot

信息

If your server is not running 1.21.11, you will need to install ViaVersion. See also this page on supported versions.

1. Download the plugin from the download page.

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:

   bedrock:
     # The IP address that will listen for 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
   
     # 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.
     clone-remote-port: false

   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. 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:

   • Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. Our port forwarding guide explains how to do this in detail. After doing this, players can connect with your public IPv4 + port to your server.

   • 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. Ngrok will not work since it is TCP-only.

5. Verify whether connections from other networks are possible by running geyser connectiontest <ip> <port> in the console.

警告

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.

Modded Servers

警告

Geyser-Fabric and Geyser-NeoForge run only on a 1.21.11 server. See this page for more details.

信息

Geyser only works with server-side mods. Mods that require a client-side install will not work!

1. Download the mod from the download page.

2. Place the Geyser mod jar in the mods folder, and restart the server. For Fabric, you will also need FabricAPI.

3. Open your Geyser config, located in /config/Geyser-Fabric/config.yml (or /config/Geyser-NeoForge/config.yml), and find the following:

   bedrock:
     # The IP address that will listen for 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
   
     # 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.
     clone-remote-port: false

   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. 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:

   • Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. Our port forwarding guide explains how to do this in detail. Then, players can connect with your public IPv4 + port to your server.

   • 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. Ngrok will not work since it is TCP-only.

5. Verify whether connections from other networks are possible by running geyser connectiontest <ip> <port> in the console.

信息

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.

Proxy Servers

信息

• Install Geyser only on the proxy server! You can install Floodgate on all servers for better skin support & network-wide Floodgate API availability for other plugins.
• All servers on the network must accept 1.21.11 Java clients, as Geyser imitates one.

1. Download the plugin for your proxy software from the download page.

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:

   bedrock:
     # The IP address that will listen for 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
   
     # 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.
     clone-remote-port: false

   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. 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:

   • Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. Our port forwarding guide explains how to do this in detail. Then, players can connect with your public IPv4 + port to your server.

   • 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. Ngrok will not work since it is TCP-only.

5. Verify whether connections from other networks are possible by running geyser connectiontest <ip> <port> in the console.

信息

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.

ViaProxy

1. Setup ViaProxy.

2. Download the plugin from the download page.

3. Place the Geyser-ViaProxy.jar in the plugins folder, and restart ViaProxy.

4. Open your Geyser config, located in /plugins/Geyser/config.yml, and find the following:

   bedrock:
     # The IP address that will listen for 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
   
     # 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.
     clone-remote-port: false

   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 ViaProxy 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.

   If you use the ViaProxy GUI you can use its account management system to join online mode servers with Bedrock Edition. If you use the ViaProxy CLI and want to allow Bedrock players to join your online mode server you have to install and set up Floodgate.
   

   NOTE: The value of the auth-type field is ignored and managed by ViaProxy automatically.

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. 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:

   • Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall. Our port forwarding guide explains how to do this in detail. After doing this, players can connect with your public IPv4 + port to your server.

   • 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. 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.

信息

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.

Standalone

信息

你需要安装 Java 17 或更高版本才能运行 Geyser。要在 Android 上运行 Geyser 独立版，请参阅本页面底部。

警告

Geyser-Standalone 不是插件或模组！它是一个独立的 Java 程序，需要在 Java Edition 服务器之外单独运行。

一般设置与配置

1. 从 这里 下载 Geyser 独立版。

2. 为 Geyser 创建一个新文件夹，并将 jar 文件放入其中。

3. 启动 Geyser 独立版：

   • GUI（推荐）：
     双击 jar 文件，Geyser 所需的所有文件将会被创建。
   • 或使用 控制台设置：
     创建一个新的 bat 或启动脚本，类似于你用于 Spigot/Paper 服务器的脚本，并查看 此页面 了解需要在其中放置什么内容。
     运行启动脚本/bat，Geyser 所需的所有文件将会被创建。

4. 打开你的 Geyser 配置文件（config.yml），找到以下内容：

   bedrock:
     # Geyser 将绑定以监听传入 Bedrock 连接的 IP 地址。
     # 通常，你只有在想限制哪些 IP 可以连接到你的服务器时才应该更改此设置。
     address: 0.0.0.0
   
     # Geyser 将监听传入 Bedrock 连接的端口。
     # 由于 Minecraft: Bedrock Edition 使用 UDP，此端口必须允许 UDP 流量。
     port: 19132
   

   port 是 Bedrock 玩家连接服务器时需要输入的端口。
   取消注释并更改此处的 address 仅在你需要将连接限制到特定 IP 地址时才需要。

   要配置 Geyser 独立版将玩家发送到哪个 Java Edition 服务器，找到 remote 部分：

   java:
     # Java Edition 服务器的 IP 地址。
     address: 127.0.0.1
   
     # Java Edition 服务器的端口。
     port: 25565
   
     # Bedrock 玩家在登录 Java 服务器时将针对哪种类型的身份验证进行检查。
     # 可以是 "floodgate"（参见 https://wiki.geysermc.org/floodgate/）、"online" 或 "offline"。
     auth-type: online

   在此处，将 address 更改为 Java 服务器的地址，或者如果服务器与 Geyser-Standalone 在同一台机器上则保持原样。 然后，将 port 更改为 Java 服务器的端口。如果你在远程 Java 服务器上设置了 Floodgate，可以将 auth-type 设置为 "floodgate" - 否则， 对于在线模式服务器设置为 online，或对于离线模式服务器设置为 offline。要在独立服务器上安装和设置 Floodgate，请参阅 这里。

5. 连接到你的服务器

   在同一网络中本地连接
   在与服务器相同的设备上，你可以使用 localhost 或 127.0.0.1 作为地址进行连接。 请注意：在同一台 Windows 设备上托管和游玩时，你需要 环回修复。 同一本地网络中的其他设备可以使用你的本地 IPv4 进行连接 - 它以 10. 或 192.168. 开头。 或者，打开 Minecraft: Bedrock Edition，然后在 好友 选项卡中加入 LAN 服务器。

   从不同网络连接
   如果你想让网络外的玩家加入，你需要将 Geyser 运行的端口暴露到互联网。 要实现这一点，你有两个选项：

   • 端口转发：在路由器/调制解调器以及 Windows/Linux 防火墙中打开 Geyser 端口（例如 19132）的 UDP 协议。 完成此操作后，玩家可以使用你的公共 IPv4 + 端口连接到你的服务器。 请参阅 这里 获取有用的指南。

   • playit.gg：与其打开端口（这可能不是一个选项/或者你不想暴露你的家庭 IP），你可以使用 playit.gg 服务为你创建一个隧道来路由流量。请参阅我们的 playit.gg 指南。 Ngrok 无法工作，因为它仅支持 TCP。

6. 通过在控制台中运行 geyser connectiontest <ip> <port> 来验证是否可以来自其他网络的连接。

在 Android 上运行 Geyser-Standalone

警告

Termux 等 Android 应用程序能够运行 Geyser，但这很大程度上取决于你的 Android 设备的性能。请自行承担风险。

Termux (Android)

1. 下载并安装 Termux
2. 运行 pkg install openjdk-17
3. 运行 wget https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone
4. 运行 java -jar Geyser-Standalone.jar

或

我们有一个用于干净 Termux 安装的自动化设置脚本，可能不适用于所有用户。如果上面的手动指南不起作用，请尝试这个。 运行此命令开始下载/安装：

curl https://gist.githubusercontent.com/rtm516/e3e07d6595ee41e05a38b03c0f4d7a80/raw/install.sh | bash