阅前须知

  • 本文所述的基岩版为安卓基岩版而非Windows基岩版。
  • 当要连接的Java版服务器的版本低于1.20.1时，服务器需安装MOD 「ViaVersion」.
  • vim 使用方法为：按 i 进入编辑模式， 按 ESC后输入 :wq 保存并退出。

安装基岩版Minecraft 与 Termux

* 由于Geyser版本限制，基岩版Minecraft版本需为1.20.1及以上版本。

Minecraft 基岩版 1.20.0.01 下载地址: https://mcapks.net/down.php?vs=1.20.0.01_64

Termux 下载地址：https://ttj.asia/termux

安装完毕后，打开Termux。

方法一 Geyser一键安装脚本（推荐

这个脚本是我在长沙无聊的时候写的（
目前开源在Github，欢迎提issue与pr！

使用方法

打开Termux，输入以下命令以拉取脚本：

1
curl -O https://get.qiusyan.top/geyser.sh

输入以下命令启动脚本：

1
bash geyser.sh

启动后的界面如图所示：

脚本，启动！

然后就是依次输入 1、2、3并回车，按照指引操作。

注意：在第一步时，请一直按回车至更新完成。

当完成第一、二、三步后，输入 4 启动Geyser。

等到Geyser启动完毕后，请将Termux切换至后台并打开Minecraft。

打开Minecraft并登录你的Microsoft账号后，你会在 游戏 – 好友 处发现一个名为Geyser局域网游戏。

点击进入即可。

方法二 手动安装

配置Termux

Termux 换源

在Termux中执行以下命令：

1
pkg install vim

以安装vim

然后在Termux中执行以下命令：

1
export EDITOR=vim

把vim设为默认编辑器

输入 apt edit-sources 换源，将其内容全部删除，更换为下面的：

1
deb https://mirrors.ustc.edu.cn/termux/apt/termux-main stable main

vim使用方法请参照页首的「阅前须知」。

Termux 同步并更新

在Termux中执行以下命令：

1
apt-get update -y && apt-get upgrade -y

以获取换源后最新的软件包以及更新最新软件包。

安装相应指令

在Termux中执行以下命令：

1
pkg install wget

以安装所需指令。

安装Java环境

在Termux中执行以下指令：

1
pkg install openjdk-17

安装完毕后，输入java -version查看版本号，以确认java已安装成功。

Geyser相关

Geyser简介

1
2
3
4
5
6
7
Geyser使基岩版客户端可加入Java版服务器。

Geyser并不能进行独立运行。Geyser的正常运作需要依附于Java版服务器进行工作。 Geyser是具有两个不同代码库的两个不同游戏之间的协议转换器，因此Geyser并不属于一个独立的服务端。而是类似于一个转发数据的核心存在。

Geyser像一个翻译官那样工作，将传入和传出的数据包翻译为客户端和服务端（服务器） 都能理解的格式。这样说来，它将基岩版的客户端行为通过NukkitX 协议库进行解析，然后翻译成令Java版服务端能够解析的行为，从而达到基岩版玩家加入Java版服务器的目的。同样的，当你的服务器安装Geyser之后，服务器内的插件大多数也能让基岩版用户正常使用。

简而言之，Geyser就是一个满足您的基岩版进入Java版服务器需求的工具。

—— 摘自Geyser MineWiki

Geyser下载

在Termux中输入以下命令：

1
wget https://ci.opencollab.dev/job/GeyserMC/job/Geyser/job/master/lastSuccessfulBuild/artifact/bootstrap/standalone/build/libs/Geyser-Standalone.jar -O geyser.jar

以下载最新版Geyser

修改Geyser配置文件 config.yml

在Termux中执行以下指令：

1
java -jar geyser.jar

以启动 Geyser 并生成配置文件。

待启动完成，显示「>」后，按 CTRL+C 结束 / 输入 geyser stop结束 Geyser 运行。

于Termux中输入 ls 显示Termux中的所有文件，可见已生成 Geyser 配置文件 config.yml

输入 vim config.yml 进行编辑。
vim使用方法请参照页首的「阅前须知」。

config.yml

编辑界面如图所示。

bedrock 部分不用去修改，这是基岩端的配置，建议默认。

我们需要修改的是 remote 部分的配置（可以用界面上的 ↑ ↓ 来移动光标）。

config.yml

address 部分用于填写目标Java版服务器的地址 「不带端口」

port 部分用于填写目标Java版服务器的端口 「默认为25565」

auth-type 部分用于填写目标服务器的登录状态 「正版验证（online），离线验证（offline）」

其余可以默认（如果你没有别的需求的话

如果你的目标服务器应用了正版验证，请参考 理解配置-Geyser Wiki 。本教程不多赘述。

愉快地开始玩 Minecraft ！

现在，连接之前的准备已经完成！

请打开你下载的基岩版Minecraft，登录XBox账号后点击「游戏」 —— 「服务器」 —— 「添加服务器」

服务器名称随意，服务器地址请填写 localhost ，端口默认。

打开Minecraft并登录你的Microsoft账号后，你会在 游戏 – 好友 处发现一个名为Geyser的局域网游戏。

点击进入即可。

现在，你就可以开始畅游于 Minecraft 中了！

*注：如果你需要在移动数据下进入服务器，请打开 「设置」 —— 「档案」 —— 「使用移动数据」，将开关打开。

End.