●序章、何为Geyser
首先给大家两个网址：
Geyser官网：https://geysermc.org
项目开发：https://github.com/GeyserMC/Geyser
也希望大家给一颗star给他们，如果有开发能力的话，就多多提交pr，感觉Geyser团队就两三个人在负责编写，很辛苦.
图0:基岩版的粘液科技？
曾经有人这么评价：万物基于发包。Geyser就是通过在基岩版客户端上模拟出Java版客户端，通过不同的转换，使得对应的Java版服务器可以检测并与这名实际上是基岩版的玩家进行数据交换。从而进一步实现基岩版客户端游玩Java版服务器。
Geyser像一个翻译官那样工作，将传入和传出的数据包翻译为客户端和服务端（服务器） 都能理解的格式。这样说来，它模拟了Minecraft:Java版本客户端，因此服务器实际上认为您是从Java版本加入的。无论是什么服务器以及它安装了什么插件，您都可以将其与Geyser连接（只要服务器支持最新的Minecraft版本，即1.16.2）。——摘自Geyser 官方Wiki，译者：PQguanfang
简而言之，Geyser就是一个满足您的基岩版进入Java版服务器梦想的工具！
Geyser是一个连接我的世界基岩版和Java版服务器的桥梁，它实际上并不会开启一个真正的双通服务器。如果您对双通服务器感兴趣，何不如去看一下ProtocolSupportPocketEdition（简称：PSPE） 呢？
●第一章、如何让Geyser工作
要想让Geyser满足您的基岩版进入Java版服务器的梦想，您需要一台已经安装Java8的设备。如果是安卓手机，您可以还需要一个可以启动Geyser的工具。一般的手机开服器应该能承担此任务。
经过我的测试，代理服大约会消耗400M的RAM，请确保您的设备有足够的性能。代理服占用带宽与一个Java版插件服接近，在特殊情况下甚至会更多，请确保您有足够的带宽。
*Step.1 寻找目标Java版服务器
首先，您需要有一个目标Java版服务器。该目标Java版服务器可以不在与Geyser代理服同一服务器上，但是它必须支持最新的Java版客户端进入。截止本文最后一次更新，最新的Java版客户端是1.16.2。如果您的目标Java版服务器不能支持最新的Java版本加入，那么您将无法顺利用Geyser进入该Java版服，因为最新地Geyser只会模拟最新Java版客户端。
截止本文最后一次更新，Geyser所开设代理服支持的基岩版版本号为v.1.16.20。
当然，如果这个目标Java版服是您自己所有，那么您可以安装ViaVersion插件。不过，过旧的版本在代理时可能还是会出问题，因为这将经过2层转换。第一层是ViaVersion本身要使得高版本Java版可以加入服务器，第二层是Geyser要使得基岩版也可以加入该服务器。本人只推荐1.12.2服务器使用ViaVersion，其他版本不大推荐。因为可能会在基岩版这边有区块加载错误等问题，不划算。
*Step.2 安装Java
请前往Java官网，切换到英文，为您的设备下载最新版本的Java8。Geyser在旧版本Java上无法正常工作。
*Step.3 下载Geyser
经过第一步，选取好您的目标Java版服并保证其能在最新Java版客户端下载以后，您需要在Geyser的官方构建页面进行下载。值得注意下的是Geyser分为两个版本：
第一个版本：我们称之为独立端版。该版本如同开启一个Spigot服务器那样。但是它绝对不是一个Spigot服务器，上文已说明Geyser不能帮你实现双通服务器。使用该版本后Geyser会单独开启一个基岩版服务器。您可以在此服务器的配置文件中修改目标Java版服的信息。基岩版玩家加入此由Geyser开启的代理服后，会立即开始数据转换，模拟出玩家在此Java版服时游玩的情况并发送给基岩版客户端。这样一来，基岩版玩家就顺利地体验到了这个Java版服。
第二个版本：我们称之为插件版。插件版分为Spigot版本/BungeCord版本/Sponge版本。经过实测，Spigot版本不仅在Spigot上，还可以在Paper等Spigot系服务端顺利使用，并且在1.8及其以上版本都可以被顺利加载。其余服务端版本暂未进行实装测试。插件版与代理端版几乎一样，只是你不再需要单独开设一个服务端了。Geyser将会以一个服务端插件形式为基岩版提供代理，最新版本Geyser插件版在部分服务端核心上已经会自动读取相关数据，为服主自动配置其文件。但是，您仍然可以自行修改Geyser需要代理的Java版服务器！
构建服务器地址：https://ci.nukkitx.com/job/Geyser/。
图1：Geyser的官方构建页面
进入该页面您将会发现一个表格。其中：
*master是Geyser的主分支。其中Geyser.jar是独立端版，其余Geyser后带有一个服务端核心名称的为插件版。如Geyser-Spigot.jar
*以feature开头的分支为新功能测试分支，它们往往在不久之后就会被合并到主分支。除非您对所测试的内容非常感兴趣，否则不建议您直接使用它们！
*resources是测试Geyser加载材质包的分支
*其他表格中的分支均是测试分支，非常不建议使用。并且其他测试分支基本都已经被合并到主分支，不需要过多的关注了
●第二章：Geyser存在的问题
●符号的多少表示该问题的严重性，如果已变成[X]，说明该问题已在最新的主分支上得到了更新。
以下问题只会在基岩版玩家这边得到体现。
由于Geyser本身导致的：
●●●●●区块更新方块有问题，例如树苗长大无法看见，地狱床爆炸看不见
[X]观察者模式后的玩家会有僵尸化现象
●●玩家掉入虚空不会掉血，而是以摔死原因死亡，并且有概率不会摔死
[X]黄色的生命加成效果在基岩版客户端不会显示
[X]基岩版玩家无法真正的在告示牌上打字
[X]玩家卡非1格高的方块
玩家会在非1格高的方块上无限鬼畜，只能想办法把这个方块挖掉才能继续移动，包括楼梯、藤蔓、所有半砖、末影传送门、地毯等。虽然这里打了X，但是最新版仍然会有偶然情况下卡这些方块
[X]玩家会卡头顶上的方块
如果玩家头顶上有方块，那么玩家在按跳跃键或者疾跑时会自动卡到头顶上的那个方块
[X]生物群系的颜色不显示
生物群系独有的一些颜色特征不会正常显示，例如沼泽的水、寒地的草方块等
[X]药水效果不显示
基岩版玩家无法查看到自己正在遭受的药水效果
[X]玩家在末地退服后无法再次重新进服
玩家在末地退服后再次重新加入服务器后会无限闪退，在地狱退服有时候也会有这个问题
[X]基岩版玩家无法看到其他玩家的皮肤
基岩版玩家无法看到其他玩家的皮肤
[X]各种UI页面无法打开
[X]合成页面无法打开
[X]创造背包是空的
[X]没有音效
玩家本应触发的各种音效无法得到支持，例如挖方块、僵尸咆哮等
[X]没有粒子效果
玩家本应触发的各种粒子效果无法得到支持，例如跳跃到水、挖方块等
[X]方块类实体不支持
玩家无法看到各种方块类实体，如木牌、箱子、潜影盒等
[X]部分实体转换有问题
部分实体可能不会在基岩版这边显示，如穿盔甲的小僵尸，但是普通的小僵尸是正常的。
[X]手持物品无法放回
玩家有时在背包中点击物品后会出现浮空情况并且无法放回，只能选择丢弃再重捡
[X]基岩版玩家无法钓鱼
[X]玩家背包的Lore可能会消失
玩家背包里面的物品含有Lore可能消失，该问题在创造模式下问题非常明显
[X]海洋区块可能不显示或者转换异常
但可在合并请求中得到修复
由于基岩版、Java版客户端不同而导致的：
●●●●容易被服务器搭配的反作弊系统误判
由于代理特性，基岩版玩家容易被服务器搭载的反作弊插件和核心自带的反飞行检测误判，该问题应该是无解问题
●●PVP、PVE问题
基岩版玩家PVP、PVE时候常常打不出伤害，这是因为1.9的PVP新机制，你可以安装相关插件解决
插件地址：https://dev.bukkit.org/projects/ ... ooldown-no-off-hand
●第三章、启动一个Geyser服务器
经过第一章的步骤，您应准备好了要代理的Java版服务器并下载了自己需要的一个Geyser版本。接下来，要想启动它，您还需要准备以下几个东西。
*安装Java8
要使得Geyser能够正常工作，您的设备必须安装了最新的Java8！
独立端版：
*直接启动
对于Windows系统用户：
独立端版的Geyser.jar文件可以直接点击并启动，但无法设置启动参数。
*编写启动文件
一旦你已经安装并放置Geyser在它自己的文件夹中，你将需要创建一个启动脚本，这和你启动一个Bukkit服务器是类似的。
对于Windows系统用户：
新建一个新的文本文件，然后给它命名为run.bat。使用一个文本编辑器软件打开这个文件（最好是Notepad++） ，然后输入下述的文本：
java -Xms512M -jar Geyser.jar
双击run.bat文件，然后Geyser就会运作。Geyser将会生成所有它需要的文件。
对于macOS系统用户：
新建一个名为run.command的文本文件，然后使用一个类似TextEdit或者TextMate的文本编辑器软件打开它。输入下述文本在run.command文件中。
#!/bin/bash cd "$( dirname "$0" )" java -Xms512M -jar Geyser.jar
打开Terminal，然后发送chmod a+x（不要按回车键） ，并将run.command文件拖到Terminal中。按键盘上的回车键，Geyser就会启动。Geyser将生成所有需要的文件。
对于Linux系统用户：
方法1.在放完Geyser本身的jar文件后，直接ssh连接，发送指令java -jar 文件名.jar即可启动。
方法2.创建一个名为run.sh的文件，并使用文本编辑器将其打开。在run.sh文件中输入以下文本：
#!/bin/sh BINDIR=$(dirname "$(readlink -fn "$0")") cd "$BINDIR" java -jar Geyser.jar
在默认的终端应用程序中，通过运行chmod+x~（dir）/run.sh（其中dir是Geyser所在文件夹的名称）或更改文件权限，使文件可执行；
打开默认的终端应用程序，输入chmod+x~/（dir）/run.sh以运行间Geyser。Geyser将生成所有需要的文件。
按照上述方法并双击打开启动文件，即可顺利开服。默认情况下，Geyser代理的是本地25565端口上的Java版服务器，本地使用基岩版19132端口即可加入。并且对于基岩版代理服也开启了正版验证。
*Step.3 检查
说明：如果您顺利启动了它，并且在您的基岩版客户端可以检测到这个代理服的存在，那么您将可以直接跳转到下一章。否则，请仔细阅读下述内容。
在启动过程中，您可能会遇到一些问题，以下即是一些常见问题的解决方案，仅供参考。如果行不通，请到论坛的你问我答板块另行开贴。如果没有问题，请直接跳转到下一章。
首先，确保您已安装最新版Java8，并请注意基岩版服务器使用UDP协议而不是TCP协议，因此如果您需要开启如果一个Geyser代理服，则必须将对应的端口切换使用TCP协议，且必须相应地更新你的DNS。
其次，确保代理服的验证模式与服务器的验证模式一致。如果服务器开启了正版验证，而您的Geyser代理服的配置文件中却设置的是离线模式登入，那么，简单地说，它是行不通的。如果所连接Java服务器开启了正版验证，则Geyser的配置文件中也必须开启正版验证。因为该服务器需要一个有效的Minecraft:Java版本的正版帐户，如果您没有使用Geyser登录到该帐户，那么您将无法加入服务器。如果您的配置文件设置正确，并且您仍然遇到此问题，则可能是您的登陆无效（如密码错误）。
最新版本Geyser已经会自动为Windows设备开启环回豁免。若为旧版本Geyser，如果您是家用机局域网/本地开Geyser代理服且无法进入，那么很有可能是由于没有取消环回限制而导致的问题。默认情况下，Microsoft应用程序对其用于本地连接的所有应用程序都有此限制。您可以在管理员模式下的Windows PowerShell中键入以下命令来提升它：
CheckNetIsolation LoopbackExempt -a -n="Microsoft.MinecraftUWP_8wekyb3d8bbwe"
如果您完成了Geyser的搭建并启动，您的Geyser所在文件夹应包含下图中的所有东西（Geyser-old是我的老版本测试，无视）。
●第四章、搭配Geyser代理服
无论是代理端版还是插件版，它们都会自动生成一个config.yml文件。您需要配置它才能真正实现基岩版进入Java版服。别担心，它配置起来很简单！
*Step.1 找到config.yml文件
如果您使用的是代理端版，那么config.yml会在与Geyser代理端版本文件的同一个文件夹出现。如果没有，则说明Geyser的启动出现了问题。
如果您使用的是插件版，那么config.yml会在您的服务器根目录下的plugins/Geyser-您的服务端核心名称（如Geyser-Bukkit）文件夹下出现。如果没有，则说明您的服务器没有成功加载Geyser插件版。
其中插件版会在已开启的Java版本服务器上再开启一个代理服，端口以config.yml中配置的为准，不取决于所搭载的Java版服务器。亲测在某些面板服务商上，Geyser是可以强占端口的。比如你的服务商只给你面板服分配了30000端口，那么如果你的Geyser配置文件中设置代理服是19132端口，那么19132端口也会被占用。取决于服务商面板是否带有端口分配限制的功能。
已知：部分Multicraft面板可以，翼龙不行。并且Geyser代理端版是不能在Multicraft面板服上使用的。
Step.2 修改这个配置文件
一般情况下您需要修改Geyser代理模式为离线模式，将配置文件中的auth-type改为offline即可。
一般情况下您需要修改Geyser代理服务器的IP和端口。
一般情况下您需要修改Geyser所开代理服的motd信息。并且motd1用户在本地/局域网时在基岩版客户端中好友菜单一栏所看见的，motd2是您将Geyser挂在已连接公网的设备上并且玩家由服务器一栏中加入时看到的。
如果服务器指令过多，可以考虑把command-suggestions选项关闭。
如果是Windows开服，则还需要对config.yml转码：
打开config.yml，用记事本，然后点击另存为，底下编码选择UFT-8，点击保存后文件夹会出现新文件config.yml.txt。
将已有config.yml删除，config.yml.txt重命名为config.yml。如果是Windows10或者WindowsServer2019等新版本Windows，则在这些操作之前，点击文件夹页面上方的查看，将显示文件后缀名打勾。
以下是配置文件信息，自行根据需要修改：
# --------------------------------
# Geyser 配置文件
#
# A bridge between Minecraft: Bedrock Edition and Minecraft: Java Edition.
#
# GitHub: https://github.com/GeyserMC/Geyser
# Discord: https://discord.geysermc.org/
# --------------------------------
bedrock:
# 填写基岩版代理服所开启的IP，不建议修改
address: 0.0.0.0
# 填写基岩版代理服所开启的端口
port: 19132
# 填写基岩版代理服的Motd信息，一般来说motd1是局域网时候显示，motd2是互联网时候显示，如果你是VPS上面用，改motd2就可以了
motd1: "GeyserMC"
motd2: "Another GeyserMC forced host."
remote:
# 填写基岩版代理服所代理的Java版服务器的IP（不需要在本机，你就是填Hypixel的IP都没问题）
address: 127.0.0.1
# 填写基岩版代理服所代理的Java版服务器的端口
port: 25565
# 登录类型。可以设置为 offline（离线模式） , online（正版验证）, 或者 floodgate（请查阅
https://github.com/GeyserMC/Geyser/wiki/Floodgate）.
auth-type: online
# Floodgate uses encryption to ensure use from authorised sources.
# This should point to the public key generated by Floodgate (Bungee or CraftBukkit)
# You can ignore this when not using Floodgate.
floodgate-key-file: public-key.pem
## 基岩版用户在登录这些被代理的Java版服务器时，会以他们的Xbox账户/手机版用户名作为Java版服务器的登录依据
## 这允许自动配置/登录到远程Java服务器
## 如果你有很大的勇气/愚笨，想把你的Mojang正版账户放置在
## 一个config.yml中
#userAuths:
# bluerkelp2: # 手机版/Xbox账户用户名
# email: [email protected] # Mojang账户邮箱/密码
# password: "this isn't really my password"
#
# herpderp40300499303040503030300500293858393589:
# email: [email protected]
# password: dooooo
# 当基岩版客户端在聊天框发送“/”时，便会展示服务器所有的命令，过多的命令会导致客户端卡住
# 你可以关闭它来解决这个问题
command-suggestions: false
# 代理服的MOTD和玩家数量继承所代理的Java版服务器
ping-passthrough: false
# 代理服最多玩家数量
max-players: 100
# debug消息是否能够在控制台显示
debug-mode: false
# 线程池大小
general-thread-pool: 32
# 下面的2个选项为是否直接投射到对应Java版服务器的MOTD和在线人数
# 下面这里填写的是false，Geyser开启的代理服的MOTD信息将是上面motd1/motd2选项设置好的
passthrough-motd: false
# 下面这里填写的是false，Geyser开启的代理服的在线人数将是基岩版玩家的人数，不包含Java版
passthrough-player-counts: false
# 仅限Geyser插件版使用，如果在开启上面2个选项后仍没有效果，请再启用下面这个选项，否则请不要动它！
legacy-ping-passthrough: false
# 检测频率，多久MOTD和在线人数会更新一次
ping-passthrough-interval: 3
# 是否允许显示第三方披风
# 目前支持：OptiFine capes，LabyMod capes，5Zig capes和MinecraftCapes
allow-third-party-capes: true
# 是否允许显示第三方deadmau5 ears
# 目前支持：MinecraftCapes
allow-third-party-ears: false
# 是否显示PVP战斗冷却，基岩版客户端不自带它，但是Java版1.9及其更高版本是自带它的，如果不启用，基岩版玩家在PVP时会很难受！
show-cooldown: true
# 选择语言，下面设置的是简体中文
default-locale: zh_cn
# 区块快照保存，群组服必须开启，其他自行考虑
chunk-cache: true
# 基岩版的地狱最高格数是128，超过这个格数方块就不会被显示
# 但是Java版不是，Java版超过128仍可以继续建筑，如果你想要让基岩版玩家也可以看到地狱世界超过128高度的方块
# 那么，请启用它。启用后，Geyser将会把地狱纬度数据包翻译成末地纬度数据包
above-bedrock-nether-building: false
# bStats is a stat tracker that is entirely anonymous and tracks only basic information
# about Geyser, such as how many people are online, how many servers are using Geyser,
# what OS is being used, etc. You can learn more about bStats here: https://bstats.org/.
# https://bstats.org/plugin/server-implementation/GeyserMC
metrics:
# If metrics should be enabled
enabled: true
# UUID of server, don't change!
uuid: generateduuid
注意事项：由于基岩版玩家是可以使用空格的，所以你的服务器可能需要更换登陆插件，否则带有空格的基岩版玩家无法加入服务器。
如果完成上述操作，玩家一进服就提示红色报错，请考虑你是否安装了最新的Java8。如果玩家一进服有提示No future information，请检查您是否真的认真完成上述操作。
●第五章、Floodgate
Floodgate是一个允许我的世界:基岩版账户登陆我的世界:Java版服务器而不需要一个我的世界:Java版账户的一个集合化的插件。这是一个很像Geyser的东西。但是不同于Geyser，Floodgate只能被像一个插件那样安装，并且只能够专门地用于它所安装的服务器上。——摘自Geyser官方Wiki，译者PQguanfang
简单来说，Floodgate就是一个允许插件版Geyser所开设的代理服中，没有Java正版账户的基岩版玩家，通过config.yml中已经设定好的Java正版账户来登陆一个已经开启正版验证的Java版服务器。
如何设置它呢？
首先注意：Floodgate要求你使用Geyser插件版下载的jar文件来使得它能够工作。这些版本可以像服务端插件那样被安装，但是无论你是否将Geyser作为插件那样安装，你都必须始终拥有Floodgate的jar文件。
Floodgate现在只能在Bukkit和BungeeCord上工作，并且它们只能在这里被使用Maven来手动编译。一旦编译，将平台的jar文件放置在你的服务器的plugins文件夹，然后启动它。一旦启动，一个名为public-key.pem的文件将会被生成。千万不要将这个Key分享给其他人！这个Key允许基岩版帐户绕过Java版本的身份验证，如果有人知道它，他们可能会对你的服务器造成严重破坏。
找到public-key.pem后，将其复制到Geyser的根目录中，或者如果您使用的是Geyser的插件版本，则复制到plugins文件夹中的Geyser文件夹中（或者对于海绵端，config/Geyser）。一定要复制它，不要只是移动它。Floodgate和Geyser都需要这个文件。
在Geyser的config.yml中，将auth-type设置为floodgate，然后重新启动Geyser。现在，基岩版客户端应该能够在没有Java版本帐户的情况下加入Java版服务器：D。
已完工
|
