跳到主要内容
信息

你需要安装 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. 连接到你的服务器

    在同一网络中本地连接
    在与服务器相同的设备上,你可以使用 localhost127.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