本帖最后由 pXiaoD 于 2022-1-27 11:46 编辑
这里不是Geyser问题询问贴，你的任何提问在这里都不会得到解决。此教程已过期，请参阅 https://www.mcbbs.net/thread-1269562-1-1.html
● 何为Geyser？
玩家与服务器交互的中间商是一个个数据包，而Geyser是一个 数据包翻译软件，通过数据包翻译，可以将Java版的数据包翻译成基岩版客户端可识别的新的数据包，从而使得基岩版玩家也可以加入Java版服务器。
* 你知道吗？
1.Geyser是 CubeCraft 服务器所赞助的项目，而CubeCraft服务器本身并没有使用Geyser。（来自官方Discord频道）
2.Geyser的部分代码是来自 Cloudburst Nukkit 和 DragonProxy 两个项目。这两个项目的团队也在 GeyserMC 团队中。
* 本人开设的一个Geyser非官方QQ交流群：
1050991989（先看教程再加群，不看教程直接加群的可能会被请出来）
● 我有问题/意见怎么办?
你可以加入Geyser官方的 Discord服务器，如果发现bug以及错误请到其GitHub的 issues 区反馈，而不是这里。在这里的任何提问/QQ群里的提问均不会被本人解答。
详情：https://www.github.com/GeyserMC/Geyser。如果您真的一点英语都不会，可以选择机翻，本人不会就这个页面如何使用做出任何解答服务。
● Geyser不可以干什么？
Geyser不能实现基岩版本身就不支持或者无法读取的东西，例如：彩色Boss血量条。当然，Java版的Forge、Farbic的各种 Mod、材质、模型等等，Geyser都不支持。
由于Java与基岩版一些特性、判断机制、实体碰撞的不同，还会产生许多奇奇怪怪的问题，例如：玩家移动会显得较为奇怪、末影龙无法对其进行远程攻击等。因此，请勿将Geyser使用在诸如Hypixel、Mineplex这样的拥有强力反作弊判断机制的服务器上，否则你的账号将可能被封禁。
Geyser不能实现的东西还有很多，请不要指望一个由一批热爱MC的开发者在业余时间编写的项目有多么强大。
● Geyser的三个版本
Geyser拥有三个版本，分别为 独立端版、插件版和Mod版。Geyser只是一个数据包翻译软件而不是开服软件，因此即使是 独立端版，你也依然要开启/选择对应的 Java版服务器；即使是 插件版/Mod版，你有时也要需要更改 Geyser的配置文件 来为其指定对应的 Java版服务器，例如：Hypixel。
独立端版是 独立运营的，只需将其放置在任意位置，然后双击点击它即可启动。
插件版依赖于所安装的服务器运营，只需要启动所安装的服务器即可启动。
Mod版依赖于Farbic运营。
插件版的优势是：如果插件版Geyser所指定的 Java版服务器，正是其所被安装的服务器，那么Geyser就可以读取相关信息，你也就可以使用一些额外的功能了。
● 准备：游戏版本号问题
Geyser一般只会支持最新的 基岩版客户端和Java版版本号的服务器。如果指定的 Java版版本号不是当前最新版本，那么Geyser将会无法为其提供数据包翻译。如果指定的服务器正是你的，你可以安装 ViaVersion 插件以解决。这款插件可以使得高版本客户端加入低版本服务器。
对于独立端版用户，可以使用指令 /geyser version 查看支持的版本号信息；对于插件版用户，可以在服务器控制台发送指令 /geyser version 查看支持的版本号信息。
* 你知道吗？
有一种情况可能会例外，在Minecraft更新之后，Geyser会有一段时间去做新版本更新，这时，最新版本的基岩版客户端和Java版版本号的服务器反而不能适用。
● 准备：Java问题
请保证你已安装最新的 Java16。如果在玩家进服时出现带有 RakNet 的报错信息，请务必考虑自己的 Java版本 问题了。
● 开始：下载Geyser
官方的构建可以在：https://ci.nukkitx.com/job/GeyserMC/job/Geyser/下载。其中，master是主分支；以feature开头的一般是新功能测试分支；以fix开头的一般是某漏洞、问题的修复，这些测试和修复分支一般很快就会被合并到主分支，不推荐使用。
Mod版下载（仅支持Farbic）：
https://ci.nukkitx.com/job/GeyserMC/job/Geyser-Fabric/job/java-1.16/lastSuccessfulBuild/artifact/build/libs/Geyser-Fabric-1.0-SNAPSHOT.jar。
大部分的Geyser官方和民间的更新都是以 合并请求 形式进行，这过程进展较慢，需要各种测试与审核。许多重要的新功能或修复，如果着急使用，可以到：https://github.com/GeyserMC/Geyser/actions下载，注意需要登录 GitHub 账号。
除了官方的Geyser，一些民间自制的 Geyser分支也可以使用。例如：https://github.com/bundabrg/Geyser。此分支对于官方Geyser有许多额外的新功能与修复，更有Geyser拓展功能，值得一试。
●●●Geyser的Farbic版本不在本贴介绍范围之内，从此开始的内容不包括Geyser-Farbic版本。●●●
● 开始：启用Geyser
插件版本放入Java版服务端的 plugins 文件夹后可直接伴随着Java服务器的开启而运行。插件版只能在 最新的Java版版本号的服务端上才能稳定使用。
独立版可以直接点击 所下载的.jar文件而直接启动，你也可以提供编写脚本来运行它。以下各个系统名称之后所给的是示例脚本文件名称。
Windows：run.bat@echo off
java -Xms1024M -jar Geyser.jar
pause
然后直接双击你所创建的run.bat即可运行。
MacOS：run.command
#!/bin/bash
cd "$( dirname "$0" )"
java -Xms1024M -jar Geyser.jar
打开终端，输入chmod a+x(不要按return!)，然后将run.command文件拖放到终端中。
按下键盘上的返回键，Geyser就会启动。Geyser将生成所有需要的文件。
Linux：run.sh
#!/bin/sh
cd "$( dirname "$0" )"
java -Xms1024M -jar Geyser.jar
打开ssh连接，运行chmod +x ~(dir)/run.sh，其中dir是Geyser.jar所在的目录，然后发送./run.sh。
● 开始：配置Geyser的config.yml
启动 Geyser 之后，会自动生成 config.yml 文件。你应特别注意下面 被加粗 的内容。本文件是包含Geyser各个第三方fork的选项，不代表官方版就包含相关选项可供配置。
# --------------------------------
# Geyser 配置文件
#
# 一个连接Minecraft: 基岩版本 和 Minecraft: Java版本的桥梁.
#
# GitHub: https://github.com/GeyserMC/Geyser
# Discord: https://discord.geysermc.org/
# --------------------------------
bedrock:
# 连接监听的IP地址.
# 一般情况下，你没有理由要修改这里.
address: 0.0.0.0
# 连接监听的端口，即Geyser开启的基岩版代理服的端口.
port: 19132
# 一些服务商为了保护你的Java版服务器，通常会使得你的Java版服务器端口总是改变，并且基岩版也被迫要求与其同步.
# 这个选项可以帮助您很好解决这个问题，每次开启服务器时，我们将自动的将基岩版代理服端口设置成和Java版服务器一致的端口.
# 仅限插件版使用.
clone-remote-port: false
# 基岩版客户端上显示的服务器MOTD信息. 如果将 "passthrough-motd" 设置为true，则本选项无效.
motd1: "GeyserMC"
motd2: "Another GeyserMC forced host."
# 基岩版客户端上显示的服务器名称.
server-name: "Geyser"
remote:
# Java版服务器的IP
# 如果独立版上使用 "auto", 则会被自动设置为 127.0.0.1,
# 如果插件版使用，Geyser会为您寻找最合适的IP.
address: 127.0.0.1
# Java版服务器的端口
# 如果插件版使用 "auto", 则Geyser自动将其设置为Java版服务器对应的端口.
port: 25565
# 登录类型. 可以设置为 offline(离线模式), online(正版验证模式), 或者 floodgate (查看https://github.com/GeyserMC/Geyser/wiki/Floodgate).
auth-type: offline
# Floodgate 使用加密技术以确保授权信息的安全.
# 这里设置为 Floodgate 所生成的公钥文件 (Bungee 或者 CraftBukkit)
# 如果你不使用 Floodgate , 请无视这里.
floodgate-key-file: public-key.pem
## 对于基岩版玩家 , Xbox/MCPE 用户名是 Java 服务器识别的重要登录信息
## 这里允许你调整一些自动登录信息，如果你有勇气将自己的Mojang账号放在这里.
#userAuths:
# bluerkelp2: # MCPE/Xbox 用户名
# email: [email protected] # Mojang 账号邮箱地址
# password: "this isn't really my password"
#
# herpderp40300499303040503030300500293858393589:
# email: [email protected]
# password: dooooo
# 如果你的服务器有太多的指令，基岩版客户端在接受这些指令(即你在聊天框打出了/符号)时会卡住.
# 你可以关闭这个选项以解决这个问题.
command-suggestions: true
# 是否将基岩版代理服MOTD信息替换为Java版服务器的MOTD信息.
passthrough-motd: false
# 是否将基岩版代理服协议信息替换为Java版服务器的协议信息 (例如 BungeeCord [X.X], Paper 1.X) - 只有在使用自定义协议名字时才会生效!
# 该信息也可以在一些具有人数查询功能的网站上查看，例如 MCSrvStatus. <mcsrvstat.us>
passthrough-protocol-name: false
# 是否将基岩版代理服人数信息替换为Java版服务器的人数信息.
passthrough-player-counts: false
# 是否启用老版的上述替换功能. 除非你的基岩版代理服显示的相关信息确实有问题，否则请不要开启这个选项.
# 该选项对独立版无效.
legacy-ping-passthrough: false
# 设置检测对应Java版相关信息的频率.
# 如果你遇到了 BrokenPipe 错误，请增长这个选项的值.
ping-passthrough-interval: 3
# 基岩版代理服玩家上限.
max-players: 60
# 是否在控制台输出DEBUG信息.
debug-mode: false
# 线程池大小.
general-thread-pool: 32
# 是否显示第三方披风. 目前支持:
# OptiFine 披风, LabyMod 披风, 5Zig 披风 和 Minecraft 自带的披风.
allow-third-party-capes: true
# 是否显示第三方 deadmau5 ears. 目前支持:
# Minecraft 自带的披风.
allow-third-party-ears: false
# 是否显示一个虚拟的战斗冷却条，Java版在1.8版本之后使用的新的战斗系统，而基岩版并没有采用这个战斗系统.
show-cooldown: false
# 设置Geyser默认语言，该选项目前会根据你的客户端语言自动调配，因此无需调整.
# default-locale: en_us
# Configures if chunk caching should be enabled or not. This keeps an individual
# record of each block the client loads in. While this feature does allow for a few
# things such as block break animations to show up in creative mode and among others,
# it is HIGHLY recommended you disable this on a production environment as it can eat
# up a lot of RAM. However, when using the Spigot version of Geyser, support for features
# or implementations this allows is automatically enabled without the additional caching as
# Geyser has direct access to the server itself.
cache-chunks: false
# 设定多少天一次缓存服务器内的图像信息，这样就不需要每次都从互联网上下载它们了.
# 如果设置为0，则关闭这个功能. (默认: 0)
cache-images: 0
# 是否显示自定义材质的头颅，该选项在原生Geyser中可能不存在.
allow-custom-skulls: true
# 基岩版玩家无法在地狱纬度的127格以上高度放置方块 -
# 如果启用这个选项，那么Geyser将会故意的将地狱纬度翻译为末地纬度.
# 不过Geyser会自动调整天空的颜色以使得被翻译为末地的地狱更像地狱，这是目前唯一解决该客户端限制的办法.
above-bedrock-nether-building: true
# 如果Geyser安装了资源包，则是否强制要求玩家在加入服务器时下载该资源包.
# 如果设置为false，则玩家可以选择不下载该资源包而直接加入服务器.
force-resource-packs: true
# 是否允许基岩版玩家可以在服务器中获得Xbox成就.
# 这将使得基岩版玩家无法作弊，例如/gamemode和/give的指令将不能被使用.
xbox-achievements-enabled: false
# 是否要求基岩版玩必须登录Xbox账号的情况下才能加入服务器.
# 对于一些中国用户，登录Xbox账号可能比较困难，因此设置了该一选项，该选项可能在原生Geyser中不存在.
# 警告: 这个选项的关闭将会导致安全性问题，请谨慎选择.
xbox-authentication-enabled: false
# bStats 是知名的用户统计工具.
# 开启这个选项将可以使得Geyser团队知道有多少人在使用、多少玩家在受益
# 以及使用Geyser的系统等，你可以通过下面的链接来更好了解它.
# https://bstats.org/plugin/server-implementation/GeyserMC
metrics:
# 是否开启.
enabled: true
# 服务器的UUID信息，请不要修改!
uuid: 0
# 高级选项 - 除非你确实需要，否则请不要轻易修改下列选项!
# Geyser 会在每次收到计分板数据包时自动更新客户端上计分板的信息..
# 但是同时处理大量的计分板数据将会使得Geyser产生大量的资源占用.
# 这个选项可以设置计分板更新的频率，这样就可以设定计分板每秒钟可以变化的次数.
scoreboard-packet-threshold: 20
# 是否允许来自 ProxyPass 和 Waterdog 的连接，后者是基岩版的类似BC的群组服务端.
# 查询 https://www.spigotmc.org/wiki/firewall-guide/ 以获得帮助 - 使用 UDP 而不是 TCP.
enable-proxy-connections: false
# 超过1402可能会产生一些问题.
# 1400 是默认的值.
# mtu: 1400
config-version: 5
● 开始：Geyser所生成的各个文件夹
extensions —— 放置Geyser的各个拓展，原生Geyser可能不包含此文件夹
locates —— 放置Geyser的语言文件
logs —— 放置Geyser的日志信息
packs —— 放置资源包
● 开始：Geyser的各个指令
/geyser help —— 查看Geyser指令的帮助信息
/geyser ? —— 同上
/geyser dump —— 生成服务器的相关debug信息（使用后会给予一个链接，类似timing报告，在向开发者们反馈问题时通常会要求提供）
/geyser list —— 查看正在使用Geyser连接的基岩版玩家列表
/geyser offhand —— 将一个物品放置到你的副手上
/geyser reload —— 重启Geyser
/geyser shutdown —— 关闭Geyser
/geyser statistics —— 查看使用Geyser连接的基岩版玩家的信息
/geyser version —— 查看正在使用的Geyser版本
上述指令对应的权限是 geyser.command.子指令，例如geyser.command.version。
● 补充：常见问题与错误
Q：像红石这样的是以哪个版本机制为准？
A：当然Java版。
Q：如果是BC群组服，则Geyser用哪个？
A：当然是装BC版到BC端里面，各个子服不需要再装Geyser。
Q：Mod支持吗？
A：你说呢？真要支持我估计你几万美刀也搞不来这个。
Q：进不去服务器，提示"无法连接至世界"！
A：在确保Geyser正常开启后，请：看看Java版服务器是否能进。如果能进，再使用类似Nukkit的服务端开启一下，检查对应的端口是否真的开启！检查你的防火墙！注意基岩版是UDP协议！端口问题是属于服务商管，这种完全不属于Geyser的问题就不要在这里瞎问了。
Q：开服有报错！玩家进不去！
A：如果是java.net.BindException: Address already in use: bind，则是你的这个端口已被使用。如果是java.lang.AssertionError: Expected AES to be available，升级你的Java！
Q：玩家一进服就是虚空，然后退出来了！
A：如果是带有No future的一行报错，则是无法连接到对应Java版服务器。如果不是，检查Geyser的登录类型是否与所连Java版服务器一致，正版服当然要用online模式了！
Q：提示"Outdated server!I am still on xxx!"！
A：看完教程了吗？你的Java版服务器版本号太低了。
Q：提示"过期的Geyser代理"！
A：基岩版版本号太低。
Q：玩家一进BC就崩！
A：BC端config.yml和各个子服spigot.yml的ip-forward都有开。
Q：Login failed:invalid开头报错
A：spigot正版验证没关。
● 何为Geyser？
玩家与服务器交互的中间商是一个个数据包，而Geyser是一个 数据包翻译软件，通过数据包翻译，可以将Java版的数据包翻译成基岩版客户端可识别的新的数据包，从而使得基岩版玩家也可以加入Java版服务器。
* 你知道吗？
1.Geyser是 CubeCraft 服务器所赞助的项目，而CubeCraft服务器本身并没有使用Geyser。（来自官方Discord频道）
2.Geyser的部分代码是来自 Cloudburst Nukkit 和 DragonProxy 两个项目。这两个项目的团队也在 GeyserMC 团队中。
* 本人开设的一个Geyser非官方QQ交流群：
1050991989（先看教程再加群，不看教程直接加群的可能会被请出来）
● 我有问题/意见怎么办?
你可以加入Geyser官方的 Discord服务器，如果发现bug以及错误请到其GitHub的 issues 区反馈，而不是这里。在这里的任何提问/QQ群里的提问均不会被本人解答。
详情：https://www.github.com/GeyserMC/Geyser。如果您真的一点英语都不会，可以选择机翻，本人不会就这个页面如何使用做出任何解答服务。
● Geyser不可以干什么？
Geyser不能实现基岩版本身就不支持或者无法读取的东西，例如：彩色Boss血量条。当然，Java版的Forge、Farbic的各种 Mod、材质、模型等等，Geyser都不支持。
由于Java与基岩版一些特性、判断机制、实体碰撞的不同，还会产生许多奇奇怪怪的问题，例如：玩家移动会显得较为奇怪、末影龙无法对其进行远程攻击等。因此，请勿将Geyser使用在诸如Hypixel、Mineplex这样的拥有强力反作弊判断机制的服务器上，否则你的账号将可能被封禁。
Geyser不能实现的东西还有很多，请不要指望一个由一批热爱MC的开发者在业余时间编写的项目有多么强大。
● Geyser的三个版本
Geyser拥有三个版本，分别为 独立端版、插件版和Mod版。Geyser只是一个数据包翻译软件而不是开服软件，因此即使是 独立端版，你也依然要开启/选择对应的 Java版服务器；即使是 插件版/Mod版，你有时也要需要更改 Geyser的配置文件 来为其指定对应的 Java版服务器，例如：Hypixel。
独立端版是 独立运营的，只需将其放置在任意位置，然后双击点击它即可启动。
插件版依赖于所安装的服务器运营，只需要启动所安装的服务器即可启动。
Mod版依赖于Farbic运营。
插件版的优势是：如果插件版Geyser所指定的 Java版服务器，正是其所被安装的服务器，那么Geyser就可以读取相关信息，你也就可以使用一些额外的功能了。
● 准备：游戏版本号问题
Geyser一般只会支持最新的 基岩版客户端和Java版版本号的服务器。如果指定的 Java版版本号不是当前最新版本，那么Geyser将会无法为其提供数据包翻译。如果指定的服务器正是你的，你可以安装 ViaVersion 插件以解决。这款插件可以使得高版本客户端加入低版本服务器。
对于独立端版用户，可以使用指令 /geyser version 查看支持的版本号信息；对于插件版用户，可以在服务器控制台发送指令 /geyser version 查看支持的版本号信息。
* 你知道吗？
有一种情况可能会例外，在Minecraft更新之后，Geyser会有一段时间去做新版本更新，这时，最新版本的基岩版客户端和Java版版本号的服务器反而不能适用。
● 准备：Java问题
请保证你已安装最新的 Java16。如果在玩家进服时出现带有 RakNet 的报错信息，请务必考虑自己的 Java版本 问题了。
● 开始：下载Geyser
官方的构建可以在：https://ci.nukkitx.com/job/GeyserMC/job/Geyser/下载。其中，master是主分支；以feature开头的一般是新功能测试分支；以fix开头的一般是某漏洞、问题的修复，这些测试和修复分支一般很快就会被合并到主分支，不推荐使用。
Mod版下载（仅支持Farbic）：
https://ci.nukkitx.com/job/GeyserMC/job/Geyser-Fabric/job/java-1.16/lastSuccessfulBuild/artifact/build/libs/Geyser-Fabric-1.0-SNAPSHOT.jar。
大部分的Geyser官方和民间的更新都是以 合并请求 形式进行，这过程进展较慢，需要各种测试与审核。许多重要的新功能或修复，如果着急使用，可以到：https://github.com/GeyserMC/Geyser/actions下载，注意需要登录 GitHub 账号。
除了官方的Geyser，一些民间自制的 Geyser分支也可以使用。例如：https://github.com/bundabrg/Geyser。此分支对于官方Geyser有许多额外的新功能与修复，更有Geyser拓展功能，值得一试。
●●●Geyser的Farbic版本不在本贴介绍范围之内，从此开始的内容不包括Geyser-Farbic版本。●●●
● 开始：启用Geyser
插件版本放入Java版服务端的 plugins 文件夹后可直接伴随着Java服务器的开启而运行。插件版只能在 最新的Java版版本号的服务端上才能稳定使用。
独立版可以直接点击 所下载的.jar文件而直接启动，你也可以提供编写脚本来运行它。以下各个系统名称之后所给的是示例脚本文件名称。
Windows：run.bat@echo off
java -Xms1024M -jar Geyser.jar
pause
然后直接双击你所创建的run.bat即可运行。
MacOS：run.command
#!/bin/bash
cd "$( dirname "$0" )"
java -Xms1024M -jar Geyser.jar
打开终端，输入chmod a+x(不要按return!)，然后将run.command文件拖放到终端中。
按下键盘上的返回键，Geyser就会启动。Geyser将生成所有需要的文件。
Linux：run.sh
#!/bin/sh
cd "$( dirname "$0" )"
java -Xms1024M -jar Geyser.jar
打开ssh连接，运行chmod +x ~(dir)/run.sh，其中dir是Geyser.jar所在的目录，然后发送./run.sh。
● 开始：配置Geyser的config.yml
启动 Geyser 之后，会自动生成 config.yml 文件。你应特别注意下面 被加粗 的内容。本文件是包含Geyser各个第三方fork的选项，不代表官方版就包含相关选项可供配置。
# --------------------------------
# Geyser 配置文件
#
# 一个连接Minecraft: 基岩版本 和 Minecraft: Java版本的桥梁.
#
# GitHub: https://github.com/GeyserMC/Geyser
# Discord: https://discord.geysermc.org/
# --------------------------------
bedrock:
# 连接监听的IP地址.
# 一般情况下，你没有理由要修改这里.
address: 0.0.0.0
# 连接监听的端口，即Geyser开启的基岩版代理服的端口.
port: 19132
# 一些服务商为了保护你的Java版服务器，通常会使得你的Java版服务器端口总是改变，并且基岩版也被迫要求与其同步.
# 这个选项可以帮助您很好解决这个问题，每次开启服务器时，我们将自动的将基岩版代理服端口设置成和Java版服务器一致的端口.
# 仅限插件版使用.
clone-remote-port: false
# 基岩版客户端上显示的服务器MOTD信息. 如果将 "passthrough-motd" 设置为true，则本选项无效.
motd1: "GeyserMC"
motd2: "Another GeyserMC forced host."
# 基岩版客户端上显示的服务器名称.
server-name: "Geyser"
remote:
# Java版服务器的IP
# 如果独立版上使用 "auto", 则会被自动设置为 127.0.0.1,
# 如果插件版使用，Geyser会为您寻找最合适的IP.
address: 127.0.0.1
# Java版服务器的端口
# 如果插件版使用 "auto", 则Geyser自动将其设置为Java版服务器对应的端口.
port: 25565
# 登录类型. 可以设置为 offline(离线模式), online(正版验证模式), 或者 floodgate (查看https://github.com/GeyserMC/Geyser/wiki/Floodgate).
auth-type: offline
# Floodgate 使用加密技术以确保授权信息的安全.
# 这里设置为 Floodgate 所生成的公钥文件 (Bungee 或者 CraftBukkit)
# 如果你不使用 Floodgate , 请无视这里.
floodgate-key-file: public-key.pem
## 对于基岩版玩家 , Xbox/MCPE 用户名是 Java 服务器识别的重要登录信息
## 这里允许你调整一些自动登录信息，如果你有勇气将自己的Mojang账号放在这里.
#userAuths:
#bluerkelp2: # MCPE/Xbox 用户名
# email: [email protected] # Mojang 账号邮箱地址
# password: "this isn't really my password"
#
#herpderp40300499303040503030300500293858393589:
# email: [email protected]
# password: dooooo
# 如果你的服务器有太多的指令，基岩版客户端在接受这些指令(即你在聊天框打出了/符号)时会卡住.
# 你可以关闭这个选项以解决这个问题.
command-suggestions: true
# 是否将基岩版代理服MOTD信息替换为Java版服务器的MOTD信息.
passthrough-motd: false
# 是否将基岩版代理服协议信息替换为Java版服务器的协议信息 (例如 BungeeCord [X.X], Paper 1.X) - 只有在使用自定义协议名字时才会生效!
# 该信息也可以在一些具有人数查询功能的网站上查看，例如 MCSrvStatus. <mcsrvstat.us>
passthrough-protocol-name: false
# 是否将基岩版代理服人数信息替换为Java版服务器的人数信息.
passthrough-player-counts: false
# 是否启用老版的上述替换功能. 除非你的基岩版代理服显示的相关信息确实有问题，否则请不要开启这个选项.
# 该选项对独立版无效.
legacy-ping-passthrough: false
# 设置检测对应Java版相关信息的频率.
# 如果你遇到了 BrokenPipe 错误，请增长这个选项的值.
ping-passthrough-interval: 3
# 基岩版代理服玩家上限.
max-players: 60
# 是否在控制台输出DEBUG信息.
debug-mode: false
# 线程池大小.
general-thread-pool: 32
# 是否显示第三方披风. 目前支持:
# OptiFine 披风, LabyMod 披风, 5Zig 披风 和 Minecraft 自带的披风.
allow-third-party-capes: true
# 是否显示第三方 deadmau5 ears. 目前支持:
# Minecraft 自带的披风.
allow-third-party-ears: false
# 是否显示一个虚拟的战斗冷却条，Java版在1.8版本之后使用的新的战斗系统，而基岩版并没有采用这个战斗系统.
show-cooldown: false
# 设置Geyser默认语言，该选项目前会根据你的客户端语言自动调配，因此无需调整.
# default-locale: en_us
# Configures if chunk caching should be enabled or not. This keeps an individual
# record of each block the client loads in. While this feature does allow for a few
# things such as block break animations to show up in creative mode and among others,
# it is HIGHLY recommended you disable this on a production environment as it can eat
# up a lot of RAM. However, when using the Spigot version of Geyser, support for features
# or implementations this allows is automatically enabled without the additional caching as
# Geyser has direct access to the server itself.
cache-chunks: false
# 设定多少天一次缓存服务器内的图像信息，这样就不需要每次都从互联网上下载它们了.
# 如果设置为0，则关闭这个功能. (默认: 0)
cache-images: 0
# 是否显示自定义材质的头颅，该选项在原生Geyser中可能不存在.
allow-custom-skulls: true
# 基岩版玩家无法在地狱纬度的127格以上高度放置方块 -
# 如果启用这个选项，那么Geyser将会故意的将地狱纬度翻译为末地纬度.
# 不过Geyser会自动调整天空的颜色以使得被翻译为末地的地狱更像地狱，这是目前唯一解决该客户端限制的办法.
above-bedrock-nether-building: true
# 如果Geyser安装了资源包，则是否强制要求玩家在加入服务器时下载该资源包.
# 如果设置为false，则玩家可以选择不下载该资源包而直接加入服务器.
force-resource-packs: true
# 是否允许基岩版玩家可以在服务器中获得Xbox成就.
# 这将使得基岩版玩家无法作弊，例如/gamemode和/give的指令将不能被使用.
xbox-achievements-enabled: false
# 是否要求基岩版玩必须登录Xbox账号的情况下才能加入服务器.
# 对于一些中国用户，登录Xbox账号可能比较困难，因此设置了该一选项，该选项可能在原生Geyser中不存在.
# 警告: 这个选项的关闭将会导致安全性问题，请谨慎选择.
xbox-authentication-enabled: false
# bStats 是知名的用户统计工具.
# 开启这个选项将可以使得Geyser团队知道有多少人在使用、多少玩家在受益
# 以及使用Geyser的系统等，你可以通过下面的链接来更好了解它.
# https://bstats.org/plugin/server-implementation/GeyserMC
metrics:
# 是否开启.
enabled: true
# 服务器的UUID信息，请不要修改!
uuid: 0
# 高级选项 - 除非你确实需要，否则请不要轻易修改下列选项!
# Geyser 会在每次收到计分板数据包时自动更新客户端上计分板的信息..
# 但是同时处理大量的计分板数据将会使得Geyser产生大量的资源占用.
# 这个选项可以设置计分板更新的频率，这样就可以设定计分板每秒钟可以变化的次数.
scoreboard-packet-threshold: 20
# 是否允许来自 ProxyPass 和 Waterdog 的连接，后者是基岩版的类似BC的群组服务端.
# 查询 https://www.spigotmc.org/wiki/firewall-guide/ 以获得帮助 - 使用 UDP 而不是 TCP.
enable-proxy-connections: false
# 超过1402可能会产生一些问题.
# 1400 是默认的值.
# mtu: 1400
config-version: 5
● 开始：Geyser所生成的各个文件夹
extensions —— 放置Geyser的各个拓展，原生Geyser可能不包含此文件夹
locates ——放置Geyser的语言文件
logs —— 放置Geyser的日志信息
packs —— 放置资源包
● 开始：Geyser的各个指令
/geyser help —— 查看Geyser指令的帮助信息
/geyser ? —— 同上
/geyser dump —— 生成服务器的相关debug信息（使用后会给予一个链接，类似timing报告，在向开发者们反馈问题时通常会要求提供）
/geyser list —— 查看正在使用Geyser连接的基岩版玩家列表
/geyser offhand —— 将一个物品放置到你的副手上
/geyser reload —— 重启Geyser
/geyser shutdown —— 关闭Geyser
/geyser statistics —— 查看使用Geyser连接的基岩版玩家的信息
/geyser version —— 查看正在使用的Geyser版本
上述指令对应的权限是 geyser.command.子指令，例如geyser.command.version。
● 补充：常见问题与错误
Q：像红石这样的是以哪个版本机制为准？
A：当然Java版。
Q：如果是BC群组服，则Geyser用哪个？
A：当然是装BC版到BC端里面，各个子服不需要再装Geyser。
Q：Mod支持吗？
A：你说呢？真要支持我估计你几万美刀也搞不来这个。
Q：进不去服务器，提示"无法连接至世界"！
A：在确保Geyser正常开启后，请：看看Java版服务器是否能进。如果能进，再使用类似Nukkit的服务端开启一下，检查对应的端口是否真的开启！检查你的防火墙！注意基岩版是UDP协议！端口问题是属于服务商管，这种完全不属于Geyser的问题就不要在这里瞎问了。
Q：开服有报错！玩家进不去！
A：如果是java.net.BindException: Address already in use: bind，则是你的这个端口已被使用。如果是java.lang.AssertionError: Expected AES to be available，升级你的Java！
Q：玩家一进服就是虚空，然后退出来了！
A：如果是带有No future的一行报错，则是无法连接到对应Java版服务器。如果不是，检查Geyser的登录类型是否与所连Java版服务器一致，正版服当然要用online模式了！
Q：提示"Outdated server!I am still on xxx!"！
A：看完教程了吗？你的Java版服务器版本号太低了。
Q：提示"过期的Geyser代理"！
A：基岩版版本号太低。
Q：玩家一进BC就崩！
A：BC端config.yml和各个子服spigot.yml的ip-forward都有开。
Q：Login failed:invalid开头报错
A：spigot正版验证没关。
这里不是Geyser问题询问贴，你的任何提问在这里都不会得到解决。此教程已过期，请参阅 https://www.mcbbs.net/thread-1269562-1-1.html
● 何为Geyser？
玩家与服务器交互的中间商是一个个数据包，而Geyser是一个 数据包翻译软件，通过数据包翻译，可以将Java版的数据包翻译成基岩版客户端可识别的新的数据包，从而使得基岩版玩家也可以加入Java版服务器。
* 你知道吗？
1.Geyser是 CubeCraft 服务器所赞助的项目，而CubeCraft服务器本身并没有使用Geyser。（来自官方Discord频道）
2.Geyser的部分代码是来自 Cloudburst Nukkit 和 DragonProxy 两个项目。这两个项目的团队也在 GeyserMC 团队中。
* 本人开设的一个Geyser非官方QQ交流群：
1050991989（先看教程再加群，不看教程直接加群的可能会被请出来）
● 我有问题/意见怎么办?
你可以加入Geyser官方的 Discord服务器，如果发现bug以及错误请到其GitHub的 issues 区反馈，而不是这里。在这里的任何提问/QQ群里的提问均不会被本人解答。
详情：https://www.github.com/GeyserMC/Geyser。如果您真的一点英语都不会，可以选择机翻，本人不会就这个页面如何使用做出任何解答服务。
● Geyser不可以干什么？
Geyser不能实现基岩版本身就不支持或者无法读取的东西，例如：彩色Boss血量条。当然，Java版的Forge、Farbic的各种 Mod、材质、模型等等，Geyser都不支持。
由于Java与基岩版一些特性、判断机制、实体碰撞的不同，还会产生许多奇奇怪怪的问题，例如：玩家移动会显得较为奇怪、末影龙无法对其进行远程攻击等。因此，请勿将Geyser使用在诸如Hypixel、Mineplex这样的拥有强力反作弊判断机制的服务器上，否则你的账号将可能被封禁。
Geyser不能实现的东西还有很多，请不要指望一个由一批热爱MC的开发者在业余时间编写的项目有多么强大。
● Geyser的三个版本
Geyser拥有三个版本，分别为 独立端版、插件版和Mod版。Geyser只是一个数据包翻译软件而不是开服软件，因此即使是 独立端版，你也依然要开启/选择对应的 Java版服务器；即使是 插件版/Mod版，你有时也要需要更改 Geyser的配置文件 来为其指定对应的 Java版服务器，例如：Hypixel。
独立端版是 独立运营的，只需将其放置在任意位置，然后双击点击它即可启动。
插件版依赖于所安装的服务器运营，只需要启动所安装的服务器即可启动。
Mod版依赖于Farbic运营。
插件版的优势是：如果插件版Geyser所指定的 Java版服务器，正是其所被安装的服务器，那么Geyser就可以读取相关信息，你也就可以使用一些额外的功能了。
● 准备：游戏版本号问题
Geyser一般只会支持最新的 基岩版客户端和Java版版本号的服务器。如果指定的 Java版版本号不是当前最新版本，那么Geyser将会无法为其提供数据包翻译。如果指定的服务器正是你的，你可以安装 ViaVersion 插件以解决。这款插件可以使得高版本客户端加入低版本服务器。
对于独立端版用户，可以使用指令 /geyser version 查看支持的版本号信息；对于插件版用户，可以在服务器控制台发送指令 /geyser version 查看支持的版本号信息。
* 你知道吗？
有一种情况可能会例外，在Minecraft更新之后，Geyser会有一段时间去做新版本更新，这时，最新版本的基岩版客户端和Java版版本号的服务器反而不能适用。
● 准备：Java问题
请保证你已安装最新的 Java16。如果在玩家进服时出现带有 RakNet 的报错信息，请务必考虑自己的 Java版本 问题了。
● 开始：下载Geyser
官方的构建可以在：https://ci.nukkitx.com/job/GeyserMC/job/Geyser/下载。其中，master是主分支；以feature开头的一般是新功能测试分支；以fix开头的一般是某漏洞、问题的修复，这些测试和修复分支一般很快就会被合并到主分支，不推荐使用。
Mod版下载（仅支持Farbic）：
https://ci.nukkitx.com/job/GeyserMC/job/Geyser-Fabric/job/java-1.16/lastSuccessfulBuild/artifact/build/libs/Geyser-Fabric-1.0-SNAPSHOT.jar。
大部分的Geyser官方和民间的更新都是以 合并请求 形式进行，这过程进展较慢，需要各种测试与审核。许多重要的新功能或修复，如果着急使用，可以到：https://github.com/GeyserMC/Geyser/actions下载，注意需要登录 GitHub 账号。
除了官方的Geyser，一些民间自制的 Geyser分支也可以使用。例如：https://github.com/bundabrg/Geyser。此分支对于官方Geyser有许多额外的新功能与修复，更有Geyser拓展功能，值得一试。
●●●Geyser的Farbic版本不在本贴介绍范围之内，从此开始的内容不包括Geyser-Farbic版本。●●●
● 开始：启用Geyser
插件版本放入Java版服务端的 plugins 文件夹后可直接伴随着Java服务器的开启而运行。插件版只能在 最新的Java版版本号的服务端上才能稳定使用。
独立版可以直接点击 所下载的.jar文件而直接启动，你也可以提供编写脚本来运行它。以下各个系统名称之后所给的是示例脚本文件名称。
Windows：run.bat@echo off
java -Xms1024M -jar Geyser.jar
pause
然后直接双击你所创建的run.bat即可运行。
MacOS：run.command
#!/bin/bash
cd "$( dirname "$0" )"
java -Xms1024M -jar Geyser.jar
打开终端，输入chmod a+x(不要按return!)，然后将run.command文件拖放到终端中。
按下键盘上的返回键，Geyser就会启动。Geyser将生成所有需要的文件。
Linux：run.sh
#!/bin/sh
cd "$( dirname "$0" )"
java -Xms1024M -jar Geyser.jar
打开ssh连接，运行chmod +x ~(dir)/run.sh，其中dir是Geyser.jar所在的目录，然后发送./run.sh。
● 开始：配置Geyser的config.yml
启动 Geyser 之后，会自动生成 config.yml 文件。你应特别注意下面 被加粗 的内容。本文件是包含Geyser各个第三方fork的选项，不代表官方版就包含相关选项可供配置。
# --------------------------------
# Geyser 配置文件
#
# 一个连接Minecraft: 基岩版本 和 Minecraft: Java版本的桥梁.
#
# GitHub: https://github.com/GeyserMC/Geyser
# Discord: https://discord.geysermc.org/
# --------------------------------
bedrock:
# 连接监听的IP地址.
# 一般情况下，你没有理由要修改这里.
address: 0.0.0.0
# 连接监听的端口，即Geyser开启的基岩版代理服的端口.
port: 19132
# 一些服务商为了保护你的Java版服务器，通常会使得你的Java版服务器端口总是改变，并且基岩版也被迫要求与其同步.
# 这个选项可以帮助您很好解决这个问题，每次开启服务器时，我们将自动的将基岩版代理服端口设置成和Java版服务器一致的端口.
# 仅限插件版使用.
clone-remote-port: false
# 基岩版客户端上显示的服务器MOTD信息. 如果将 "passthrough-motd" 设置为true，则本选项无效.
motd1: "GeyserMC"
motd2: "Another GeyserMC forced host."
# 基岩版客户端上显示的服务器名称.
server-name: "Geyser"
remote:
# Java版服务器的IP
# 如果独立版上使用 "auto", 则会被自动设置为 127.0.0.1,
# 如果插件版使用，Geyser会为您寻找最合适的IP.
address: 127.0.0.1
# Java版服务器的端口
# 如果插件版使用 "auto", 则Geyser自动将其设置为Java版服务器对应的端口.
port: 25565
# 登录类型. 可以设置为 offline(离线模式), online(正版验证模式), 或者 floodgate (查看https://github.com/GeyserMC/Geyser/wiki/Floodgate).
auth-type: offline
# Floodgate 使用加密技术以确保授权信息的安全.
# 这里设置为 Floodgate 所生成的公钥文件 (Bungee 或者 CraftBukkit)
# 如果你不使用 Floodgate , 请无视这里.
floodgate-key-file: public-key.pem
## 对于基岩版玩家 , Xbox/MCPE 用户名是 Java 服务器识别的重要登录信息
## 这里允许你调整一些自动登录信息，如果你有勇气将自己的Mojang账号放在这里.
#userAuths:
# bluerkelp2: # MCPE/Xbox 用户名
# email: [email protected] # Mojang 账号邮箱地址
# password: "this isn't really my password"
#
# herpderp40300499303040503030300500293858393589:
# email: [email protected]
# password: dooooo
# 如果你的服务器有太多的指令，基岩版客户端在接受这些指令(即你在聊天框打出了/符号)时会卡住.
# 你可以关闭这个选项以解决这个问题.
command-suggestions: true
# 是否将基岩版代理服MOTD信息替换为Java版服务器的MOTD信息.
passthrough-motd: false
# 是否将基岩版代理服协议信息替换为Java版服务器的协议信息 (例如 BungeeCord [X.X], Paper 1.X) - 只有在使用自定义协议名字时才会生效!
# 该信息也可以在一些具有人数查询功能的网站上查看，例如 MCSrvStatus. <mcsrvstat.us>
passthrough-protocol-name: false
# 是否将基岩版代理服人数信息替换为Java版服务器的人数信息.
passthrough-player-counts: false
# 是否启用老版的上述替换功能. 除非你的基岩版代理服显示的相关信息确实有问题，否则请不要开启这个选项.
# 该选项对独立版无效.
legacy-ping-passthrough: false
# 设置检测对应Java版相关信息的频率.
# 如果你遇到了 BrokenPipe 错误，请增长这个选项的值.
ping-passthrough-interval: 3
# 基岩版代理服玩家上限.
max-players: 60
# 是否在控制台输出DEBUG信息.
debug-mode: false
# 线程池大小.
general-thread-pool: 32
# 是否显示第三方披风. 目前支持:
# OptiFine 披风, LabyMod 披风, 5Zig 披风 和 Minecraft 自带的披风.
allow-third-party-capes: true
# 是否显示第三方 deadmau5 ears. 目前支持:
# Minecraft 自带的披风.
allow-third-party-ears: false
# 是否显示一个虚拟的战斗冷却条，Java版在1.8版本之后使用的新的战斗系统，而基岩版并没有采用这个战斗系统.
show-cooldown: false
# 设置Geyser默认语言，该选项目前会根据你的客户端语言自动调配，因此无需调整.
# default-locale: en_us
# Configures if chunk caching should be enabled or not. This keeps an individual
# record of each block the client loads in. While this feature does allow for a few
# things such as block break animations to show up in creative mode and among others,
# it is HIGHLY recommended you disable this on a production environment as it can eat
# up a lot of RAM. However, when using the Spigot version of Geyser, support for features
# or implementations this allows is automatically enabled without the additional caching as
# Geyser has direct access to the server itself.
cache-chunks: false
# 设定多少天一次缓存服务器内的图像信息，这样就不需要每次都从互联网上下载它们了.
# 如果设置为0，则关闭这个功能. (默认: 0)
cache-images: 0
# 是否显示自定义材质的头颅，该选项在原生Geyser中可能不存在.
allow-custom-skulls: true
# 基岩版玩家无法在地狱纬度的127格以上高度放置方块 -
# 如果启用这个选项，那么Geyser将会故意的将地狱纬度翻译为末地纬度.
# 不过Geyser会自动调整天空的颜色以使得被翻译为末地的地狱更像地狱，这是目前唯一解决该客户端限制的办法.
above-bedrock-nether-building: true
# 如果Geyser安装了资源包，则是否强制要求玩家在加入服务器时下载该资源包.
# 如果设置为false，则玩家可以选择不下载该资源包而直接加入服务器.
force-resource-packs: true
# 是否允许基岩版玩家可以在服务器中获得Xbox成就.
# 这将使得基岩版玩家无法作弊，例如/gamemode和/give的指令将不能被使用.
xbox-achievements-enabled: false
# 是否要求基岩版玩必须登录Xbox账号的情况下才能加入服务器.
# 对于一些中国用户，登录Xbox账号可能比较困难，因此设置了该一选项，该选项可能在原生Geyser中不存在.
# 警告: 这个选项的关闭将会导致安全性问题，请谨慎选择.
xbox-authentication-enabled: false
# bStats 是知名的用户统计工具.
# 开启这个选项将可以使得Geyser团队知道有多少人在使用、多少玩家在受益
# 以及使用Geyser的系统等，你可以通过下面的链接来更好了解它.
# https://bstats.org/plugin/server-implementation/GeyserMC
metrics:
# 是否开启.
enabled: true
# 服务器的UUID信息，请不要修改!
uuid: 0
# 高级选项 - 除非你确实需要，否则请不要轻易修改下列选项!
# Geyser 会在每次收到计分板数据包时自动更新客户端上计分板的信息..
# 但是同时处理大量的计分板数据将会使得Geyser产生大量的资源占用.
# 这个选项可以设置计分板更新的频率，这样就可以设定计分板每秒钟可以变化的次数.
scoreboard-packet-threshold: 20
# 是否允许来自 ProxyPass 和 Waterdog 的连接，后者是基岩版的类似BC的群组服务端.
# 查询 https://www.spigotmc.org/wiki/firewall-guide/ 以获得帮助 - 使用 UDP 而不是 TCP.
enable-proxy-connections: false
# 超过1402可能会产生一些问题.
# 1400 是默认的值.
# mtu: 1400
config-version: 5
● 开始：Geyser所生成的各个文件夹
extensions —— 放置Geyser的各个拓展，原生Geyser可能不包含此文件夹
locates —— 放置Geyser的语言文件
logs —— 放置Geyser的日志信息
packs —— 放置资源包
● 开始：Geyser的各个指令
/geyser help —— 查看Geyser指令的帮助信息
/geyser ? —— 同上
/geyser dump —— 生成服务器的相关debug信息（使用后会给予一个链接，类似timing报告，在向开发者们反馈问题时通常会要求提供）
/geyser list —— 查看正在使用Geyser连接的基岩版玩家列表
/geyser offhand —— 将一个物品放置到你的副手上
/geyser reload —— 重启Geyser
/geyser shutdown —— 关闭Geyser
/geyser statistics —— 查看使用Geyser连接的基岩版玩家的信息
/geyser version —— 查看正在使用的Geyser版本
上述指令对应的权限是 geyser.command.子指令，例如geyser.command.version。
● 补充：常见问题与错误
Q：像红石这样的是以哪个版本机制为准？
A：当然Java版。
Q：如果是BC群组服，则Geyser用哪个？
A：当然是装BC版到BC端里面，各个子服不需要再装Geyser。
Q：Mod支持吗？
A：你说呢？真要支持我估计你几万美刀也搞不来这个。
Q：进不去服务器，提示"无法连接至世界"！
A：在确保Geyser正常开启后，请：看看Java版服务器是否能进。如果能进，再使用类似Nukkit的服务端开启一下，检查对应的端口是否真的开启！检查你的防火墙！注意基岩版是UDP协议！端口问题是属于服务商管，这种完全不属于Geyser的问题就不要在这里瞎问了。
Q：开服有报错！玩家进不去！
A：如果是java.net.BindException: Address already in use: bind，则是你的这个端口已被使用。如果是java.lang.AssertionError: Expected AES to be available，升级你的Java！
Q：玩家一进服就是虚空，然后退出来了！
A：如果是带有No future的一行报错，则是无法连接到对应Java版服务器。如果不是，检查Geyser的登录类型是否与所连Java版服务器一致，正版服当然要用online模式了！
Q：提示"Outdated server!I am still on xxx!"！
A：看完教程了吗？你的Java版服务器版本号太低了。
Q：提示"过期的Geyser代理"！
A：基岩版版本号太低。
Q：玩家一进BC就崩！
A：BC端config.yml和各个子服spigot.yml的ip-forward都有开。
Q：Login failed:invalid开头报错
A：spigot正版验证没关。
2021.12 数据，可能有更多内容
这里不是Geyser问题询问贴，你的任何提问在这里都不会得到解决。● 何为Geyser？
玩家与服务器交互的中间商是一个个数据包，而Geyser是一个 数据包翻译软件，通过数据包翻译，可以将Java版的数据包翻译成基岩版客户端可识别的新的数据包，从而使得基岩版玩家也可以加入Java版服务器。
* 你知道吗？
1.Geyser是 CubeCraft 服务器所赞助的项目，而CubeCraft服务器本身并没有使用Geyser。（来自官方Discord频道）
2.Geyser的部分代码是来自 Cloudburst Nukkit 和 DragonProxy 两个项目。这两个项目的团队也在 GeyserMC 团队中。
* 本人开设的一个Geyser非官方QQ交流群：
1050991989（先看教程再加群，不看教程直接加群的可能会被请出来）
● 我有问题/意见怎么办?
你可以加入Geyser官方的 Discord服务器，如果发现bug以及错误请到其GitHub的 issues 区反馈，而不是这里。在这里的任何提问/QQ群里的提问均不会被本人解答。
详情：https://www.github.com/GeyserMC/Geyser。如果您真的一点英语都不会，可以选择机翻，本人不会就这个页面如何使用做出任何解答服务。
● Geyser不可以干什么？
Geyser不能实现基岩版本身就不支持或者无法读取的东西，例如：彩色Boss血量条。当然，Java版的Forge、Farbic的各种 Mod、材质、模型等等，Geyser都不支持。
由于Java与基岩版一些特性、判断机制、实体碰撞的不同，还会产生许多奇奇怪怪的问题，例如：玩家移动会显得较为奇怪、末影龙无法对其进行远程攻击等。因此，请勿将Geyser使用在诸如Hypixel、Mineplex这样的拥有强力反作弊判断机制的服务器上，否则你的账号将可能被封禁。
Geyser不能实现的东西还有很多，请不要指望一个由一批热爱MC的开发者在业余时间编写的项目有多么强大。
● Geyser的三个版本
Geyser拥有三个版本，分别为 独立端版、插件版和Mod版。Geyser只是一个数据包翻译软件而不是开服软件，因此即使是 独立端版，你也依然要开启/选择对应的 Java版服务器；即使是 插件版/Mod版，你有时也要需要更改 Geyser的配置文件 来为其指定对应的 Java版服务器，例如：Hypixel。
独立端版是 独立运营的，只需将其放置在任意位置，然后双击点击它即可启动。
插件版依赖于所安装的服务器运营，只需要启动所安装的服务器即可启动。
Mod版依赖于Farbic运营。
插件版的优势是：如果插件版Geyser所指定的 Java版服务器，正是其所被安装的服务器，那么Geyser就可以读取相关信息，你也就可以使用一些额外的功能了。
● 准备：游戏版本号问题
Geyser一般只会支持最新的 基岩版客户端和Java版版本号的服务器。如果指定的 Java版版本号不是当前最新版本，那么Geyser将会无法为其提供数据包翻译。如果指定的服务器正是你的，你可以安装 ViaVersion 插件以解决。这款插件可以使得高版本客户端加入低版本服务器。
对于独立端版用户，可以使用指令 /geyser version 查看支持的版本号信息；对于插件版用户，可以在服务器控制台发送指令 /geyser version 查看支持的版本号信息。
* 你知道吗？
有一种情况可能会例外，在Minecraft更新之后，Geyser会有一段时间去做新版本更新，这时，最新版本的基岩版客户端和Java版版本号的服务器反而不能适用。
● 准备：Java问题
请保证你已安装最新的 Java16。如果在玩家进服时出现带有 RakNet 的报错信息，请务必考虑自己的 Java版本 问题了。
● 开始：下载Geyser
官方的构建可以在：https://ci.nukkitx.com/job/GeyserMC/job/Geyser/下载。其中，master是主分支；以feature开头的一般是新功能测试分支；以fix开头的一般是某漏洞、问题的修复，这些测试和修复分支一般很快就会被合并到主分支，不推荐使用。
Mod版下载（仅支持Farbic）：
https://ci.nukkitx.com/job/GeyserMC/job/Geyser-Fabric/job/java-1.16/lastSuccessfulBuild/artifact/build/libs/Geyser-Fabric-1.0-SNAPSHOT.jar。
大部分的Geyser官方和民间的更新都是以 合并请求 形式进行，这过程进展较慢，需要各种测试与审核。许多重要的新功能或修复，如果着急使用，可以到：https://github.com/GeyserMC/Geyser/actions下载，注意需要登录 GitHub 账号。
除了官方的Geyser，一些民间自制的 Geyser分支也可以使用。例如：https://github.com/bundabrg/Geyser。此分支对于官方Geyser有许多额外的新功能与修复，更有Geyser拓展功能，值得一试。
●●●Geyser的Farbic版本不在本贴介绍范围之内，从此开始的内容不包括Geyser-Farbic版本。●●●
● 开始：启用Geyser
插件版本放入Java版服务端的 plugins 文件夹后可直接伴随着Java服务器的开启而运行。插件版只能在 最新的Java版版本号的服务端上才能稳定使用。
独立版可以直接点击 所下载的.jar文件而直接启动，你也可以提供编写脚本来运行它。以下各个系统名称之后所给的是示例脚本文件名称。
Windows：run.bat@echo off
java -Xms1024M -jar Geyser.jar
pause
然后直接双击你所创建的run.bat即可运行。
MacOS：run.command
#!/bin/bash
cd "$( dirname "$0" )"
java -Xms1024M -jar Geyser.jar
打开终端，输入chmod a+x(不要按return!)，然后将run.command文件拖放到终端中。
按下键盘上的返回键，Geyser就会启动。Geyser将生成所有需要的文件。
Linux：run.sh
#!/bin/sh
cd "$( dirname "$0" )"
java -Xms1024M -jar Geyser.jar
打开ssh连接，运行chmod +x ~(dir)/run.sh，其中dir是Geyser.jar所在的目录，然后发送./run.sh。
● 开始：配置Geyser的config.yml
启动 Geyser 之后，会自动生成 config.yml 文件。你应特别注意下面 被加粗 的内容。本文件是包含Geyser各个第三方fork的选项，不代表官方版就包含相关选项可供配置。
# --------------------------------
# Geyser 配置文件
#
# 一个连接Minecraft: 基岩版本 和 Minecraft: Java版本的桥梁.
#
# GitHub: https://github.com/GeyserMC/Geyser
# Discord: https://discord.geysermc.org/
# --------------------------------
bedrock:
# 连接监听的IP地址.
# 一般情况下，你没有理由要修改这里.
address: 0.0.0.0
# 连接监听的端口，即Geyser开启的基岩版代理服的端口.
port: 19132
# 一些服务商为了保护你的Java版服务器，通常会使得你的Java版服务器端口总是改变，并且基岩版也被迫要求与其同步.
# 这个选项可以帮助您很好解决这个问题，每次开启服务器时，我们将自动的将基岩版代理服端口设置成和Java版服务器一致的端口.
# 仅限插件版使用.
clone-remote-port: false
# 基岩版客户端上显示的服务器MOTD信息. 如果将 "passthrough-motd" 设置为true，则本选项无效.
motd1: "GeyserMC"
motd2: "Another GeyserMC forced host."
# 基岩版客户端上显示的服务器名称.
server-name: "Geyser"
remote:
# Java版服务器的IP
# 如果独立版上使用 "auto", 则会被自动设置为 127.0.0.1,
# 如果插件版使用，Geyser会为您寻找最合适的IP.
address: 127.0.0.1
# Java版服务器的端口
# 如果插件版使用 "auto", 则Geyser自动将其设置为Java版服务器对应的端口.
port: 25565
# 登录类型. 可以设置为 offline(离线模式), online(正版验证模式), 或者 floodgate (查看https://github.com/GeyserMC/Geyser/wiki/Floodgate).
auth-type: offline
# Floodgate 使用加密技术以确保授权信息的安全.
# 这里设置为 Floodgate 所生成的公钥文件 (Bungee 或者 CraftBukkit)
# 如果你不使用 Floodgate , 请无视这里.
floodgate-key-file: public-key.pem
## 对于基岩版玩家 , Xbox/MCPE 用户名是 Java 服务器识别的重要登录信息
## 这里允许你调整一些自动登录信息，如果你有勇气将自己的Mojang账号放在这里.
#userAuths:
#bluerkelp2: # MCPE/Xbox 用户名
# email: [email protected] # Mojang 账号邮箱地址
# password: "this isn't really my password"
#
#herpderp40300499303040503030300500293858393589:
# email: [email protected]
# password: dooooo
# 如果你的服务器有太多的指令，基岩版客户端在接受这些指令(即你在聊天框打出了/符号)时会卡住.
# 你可以关闭这个选项以解决这个问题.
command-suggestions: true
# 是否将基岩版代理服MOTD信息替换为Java版服务器的MOTD信息.
passthrough-motd: false
# 是否将基岩版代理服协议信息替换为Java版服务器的协议信息 (例如 BungeeCord [X.X], Paper 1.X) - 只有在使用自定义协议名字时才会生效!
# 该信息也可以在一些具有人数查询功能的网站上查看，例如 MCSrvStatus. <mcsrvstat.us>
passthrough-protocol-name: false
# 是否将基岩版代理服人数信息替换为Java版服务器的人数信息.
passthrough-player-counts: false
# 是否启用老版的上述替换功能. 除非你的基岩版代理服显示的相关信息确实有问题，否则请不要开启这个选项.
# 该选项对独立版无效.
legacy-ping-passthrough: false
# 设置检测对应Java版相关信息的频率.
# 如果你遇到了 BrokenPipe 错误，请增长这个选项的值.
ping-passthrough-interval: 3
# 基岩版代理服玩家上限.
max-players: 60
# 是否在控制台输出DEBUG信息.
debug-mode: false
# 线程池大小.
general-thread-pool: 32
# 是否显示第三方披风. 目前支持:
# OptiFine 披风, LabyMod 披风, 5Zig 披风 和 Minecraft 自带的披风.
allow-third-party-capes: true
# 是否显示第三方 deadmau5 ears. 目前支持:
# Minecraft 自带的披风.
allow-third-party-ears: false
# 是否显示一个虚拟的战斗冷却条，Java版在1.8版本之后使用的新的战斗系统，而基岩版并没有采用这个战斗系统.
show-cooldown: false
# 设置Geyser默认语言，该选项目前会根据你的客户端语言自动调配，因此无需调整.
# default-locale: en_us
# Configures if chunk caching should be enabled or not. This keeps an individual
# record of each block the client loads in. While this feature does allow for a few
# things such as block break animations to show up in creative mode and among others,
# it is HIGHLY recommended you disable this on a production environment as it can eat
# up a lot of RAM. However, when using the Spigot version of Geyser, support for features
# or implementations this allows is automatically enabled without the additional caching as
# Geyser has direct access to the server itself.
cache-chunks: false
# 设定多少天一次缓存服务器内的图像信息，这样就不需要每次都从互联网上下载它们了.
# 如果设置为0，则关闭这个功能. (默认: 0)
cache-images: 0
# 是否显示自定义材质的头颅，该选项在原生Geyser中可能不存在.
allow-custom-skulls: true
# 基岩版玩家无法在地狱纬度的127格以上高度放置方块 -
# 如果启用这个选项，那么Geyser将会故意的将地狱纬度翻译为末地纬度.
# 不过Geyser会自动调整天空的颜色以使得被翻译为末地的地狱更像地狱，这是目前唯一解决该客户端限制的办法.
above-bedrock-nether-building: true
# 如果Geyser安装了资源包，则是否强制要求玩家在加入服务器时下载该资源包.
# 如果设置为false，则玩家可以选择不下载该资源包而直接加入服务器.
force-resource-packs: true
# 是否允许基岩版玩家可以在服务器中获得Xbox成就.
# 这将使得基岩版玩家无法作弊，例如/gamemode和/give的指令将不能被使用.
xbox-achievements-enabled: false
# 是否要求基岩版玩必须登录Xbox账号的情况下才能加入服务器.
# 对于一些中国用户，登录Xbox账号可能比较困难，因此设置了该一选项，该选项可能在原生Geyser中不存在.
# 警告: 这个选项的关闭将会导致安全性问题，请谨慎选择.
xbox-authentication-enabled: false
# bStats 是知名的用户统计工具.
# 开启这个选项将可以使得Geyser团队知道有多少人在使用、多少玩家在受益
# 以及使用Geyser的系统等，你可以通过下面的链接来更好了解它.
# https://bstats.org/plugin/server-implementation/GeyserMC
metrics:
# 是否开启.
enabled: true
# 服务器的UUID信息，请不要修改!
uuid: 0
# 高级选项 - 除非你确实需要，否则请不要轻易修改下列选项!
# Geyser 会在每次收到计分板数据包时自动更新客户端上计分板的信息..
# 但是同时处理大量的计分板数据将会使得Geyser产生大量的资源占用.
# 这个选项可以设置计分板更新的频率，这样就可以设定计分板每秒钟可以变化的次数.
scoreboard-packet-threshold: 20
# 是否允许来自 ProxyPass 和 Waterdog 的连接，后者是基岩版的类似BC的群组服务端.
# 查询 https://www.spigotmc.org/wiki/firewall-guide/ 以获得帮助 - 使用 UDP 而不是 TCP.
enable-proxy-connections: false
# 超过1402可能会产生一些问题.
# 1400 是默认的值.
# mtu: 1400
config-version: 5
● 开始：Geyser所生成的各个文件夹
extensions —— 放置Geyser的各个拓展，原生Geyser可能不包含此文件夹
locates ——放置Geyser的语言文件
logs —— 放置Geyser的日志信息
packs —— 放置资源包
● 开始：Geyser的各个指令
/geyser help —— 查看Geyser指令的帮助信息
/geyser ? —— 同上
/geyser dump —— 生成服务器的相关debug信息（使用后会给予一个链接，类似timing报告，在向开发者们反馈问题时通常会要求提供）
/geyser list —— 查看正在使用Geyser连接的基岩版玩家列表
/geyser offhand —— 将一个物品放置到你的副手上
/geyser reload —— 重启Geyser
/geyser shutdown —— 关闭Geyser
/geyser statistics —— 查看使用Geyser连接的基岩版玩家的信息
/geyser version —— 查看正在使用的Geyser版本
上述指令对应的权限是 geyser.command.子指令，例如geyser.command.version。
● 补充：常见问题与错误
Q：像红石这样的是以哪个版本机制为准？
A：当然Java版。
Q：如果是BC群组服，则Geyser用哪个？
A：当然是装BC版到BC端里面，各个子服不需要再装Geyser。
Q：Mod支持吗？
A：你说呢？真要支持我估计你几万美刀也搞不来这个。
Q：进不去服务器，提示"无法连接至世界"！
A：在确保Geyser正常开启后，请：看看Java版服务器是否能进。如果能进，再使用类似Nukkit的服务端开启一下，检查对应的端口是否真的开启！检查你的防火墙！注意基岩版是UDP协议！端口问题是属于服务商管，这种完全不属于Geyser的问题就不要在这里瞎问了。
Q：开服有报错！玩家进不去！
A：如果是java.net.BindException: Address already in use: bind，则是你的这个端口已被使用。如果是java.lang.AssertionError: Expected AES to be available，升级你的Java！
Q：玩家一进服就是虚空，然后退出来了！
A：如果是带有No future的一行报错，则是无法连接到对应Java版服务器。如果不是，检查Geyser的登录类型是否与所连Java版服务器一致，正版服当然要用online模式了！
Q：提示"Outdated server!I am still on xxx!"！
A：看完教程了吗？你的Java版服务器版本号太低了。
Q：提示"过期的Geyser代理"！
A：基岩版版本号太低。
Q：玩家一进BC就崩！
A：BC端config.yml和各个子服spigot.yml的ip-forward都有开。
Q：Login failed:invalid开头报错
A：spigot正版验证没关。
爱了爱了 支持一下
问一下怎么关闭Xbox登录，xbox-achievements-enabled: false，这一项是正常的。然后这一项配置文件里没有xbox-authentication-enabled: false
本帖最后由 PQguanfang 于 2020-12-28 14:50 编辑
那是我自己用的里面有，官方的就没有，帖子已做补充。
Huai_yu 发表于 2020-12-28 14:35
问一下怎么关闭Xbox登录，xbox-achievements-enabled: false，这一项是正常的。然后这一项配置文件里没有xb ...
那是我自己用的里面有，官方的就没有，帖子已做补充。
PQguanfang 发表于 2020-12-28 14:49
那是我自己用的里面有，官方的就没有，帖子已做补充。
所以想问问怎么关闭 开是开起来了 但是连接是显示要求用XBox登录
Huai_yu 发表于 2020-12-28 15:34
所以想问问怎么关闭 开是开起来了 但是连接是显示要求用XBox登录
没办法关闭，都说了官方的没有
[quote]
[/quote]如果是手机端连不进来怎么办呢
PQguanfang 发表于 2020-12-28 14:49
那是我自己用的里面有，官方的就没有，帖子已做补充。
那么您用的那个版本可以发一下么
电脑版可以正常登录游戏, 使用Geyser后手机版可以正常进入游戏, 但是会弹出需要正版账号或是微软账号登陆, 正常登录后才可以玩, 我把登陆模式改成offline后geyser似乎未正确加载, 因为该端口并未开启,(使用的版本是Geyser-bukkit插件版本), 不管是设置为offline或是floodgate都无法正常开启端口
很好超级好
有些地方还是不兼容，加油
所以，官方版的Geyser和第三方构建的Geyser，该怎么选？
官网说只能1.16.4和1.16.5，我1.16.3也可以用
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-12 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-13 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-14 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-15 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-0 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-1 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-2 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-3 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-4 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-5 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-6 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-7 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-8 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-9 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-10 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-11 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-12 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-13 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-14 它会覆盖而不是删除旧组
- 14:03:56 [信息] [Geyser-BungeeCord] 忽略组 tm-sb-15 它会覆盖而不是删除旧组
不知道是什么原因
有提到插件和mod版
那么我用fabric开服务器，fabric加了一个支持插件的
Cardboard Mod
https://www.mcmod.cn/class/3267.html
这个mod可以让你的fabric服务端兼容大部分Bukkit插件
那么我该安装哪一个呢
那么我用fabric开服务器，fabric加了一个支持插件的
Cardboard Mod
https://www.mcmod.cn/class/3267.html
这个mod可以让你的fabric服务端兼容大部分Bukkit插件
那么我该安装哪一个呢
看起来不错
如果Java版和基岩版的玩家重名会怎么办？
谢谢楼主分享教程
间歇泉进去的玩家用是连接超时而pc的玩家没事儿怎么解决
啊，教程帖有人写了啊！[那我可以咕咕咕了！好耶]
问题大多都是无用UDP端口真的太累了
Geyser莫名的有点卡不知道为什么qwq
尴尬，最新的手机版进不了
用间歇泉进的基岩版玩家 注册和登录IP都是本地
不开启注册限制感觉不太好 开启了基岩版玩家又注册不了
不开启注册限制感觉不太好 开启了基岩版玩家又注册不了
独立端版进入服务器显示java.lang.IllgalStateException:Cannot reply to EncryptionRequestPacket without profile and access token
666666666666666
Login failed:Authentic service unavailable这个怎么解决？
dalao yyds
geyser下游数据包错误怎么办，无法翻译数据包
geyser启动乱码怎么回事
[01:28:23 WARN]: [Geyser-Spigot] Downstream packet error! com.google.gson.stream.MalformedJsonException: Use JsonReader.setLenient(true) to accept malformed JSON at line 1 column 1 path $
咋回事
咋回事
[Geyser-Spigot] 忽略组 tm-sb-0 它会覆盖而不是删除旧组这玩意儿能不能取消
[19:18:31 WARN]: 非法的本地下载和加载请求: zh_cn
然后玩家进入信息 /say的信息之类的 都不能正常显示
然后玩家进入信息 /say的信息之类的 都不能正常显示
有一说一官方discord群也不一定能得到解答，作者并不一定每时每刻都在的，即使在也不一定能看到
本帖最后由 十多个法院 于 2021-11-15 23:23 编辑
可以试试支持spigot的
2114039705 发表于 2021-5-16 08:32
有提到插件和mod版
那么我用fabric开服务器，fabric加了一个支持插件的
Cardboard Mod
可以试试支持spigot的
666666666666666
[15:44:40 ERROR] 无法获取本地附件缓存 Unrecognized token 'Read': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false')
at [Source: (String)"Read timed out"; line: 1, column: 5]
[15:44:40 WARN] 非法的本地下载和加载请求: zh_cn
这怎么搞
at [Source: (String)"Read timed out"; line: 1, column: 5]
[15:44:40 WARN] 非法的本地下载和加载请求: zh_cn
这怎么搞
无法获取本地附件缓存 Unrecognized token 'Read': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false') at [Source: (String)"Read timed out"; line: 1, column: 5]是什么情况啊,求解答
本帖最后由 荣豪Rocosteve 于 2022-7-29 11:34 编辑
geyser报错 非法的本地下载和加载请求: zh_cn
可以试试这个 https://github.com/GeyserMC/Geys ... ecomment-1185543655
反正咱这边是成功了
geyser报错 非法的本地下载和加载请求: zh_cn
可以试试这个 https://github.com/GeyserMC/Geys ... ecomment-1185543655
反正咱这边是成功了
请问怎么开启基岩版玩家的白名单
Q：Mod支持吗？
A：你说呢？真要支持我估计你几万美刀也搞不来这个。
这个笑死我了
6666666666666
1.19.3fabric在加载geyser—fabric时要求安装fabric是怎么回事
111111111111111111111111111111111111111111.
提示Your username contains illegal characters怎么搞，我用的xbox而且id都会英文没问题
大佬，我用XBOX登入的服务器，第一次显示版本过低，解决了。
第二次显示非法用户名
Internal Exceptionijawa.lang.tllegal5tateException: Irvalid characters in username
我基岩版ID是 NEW of world，有什么办法吗？
第二次显示非法用户名
Internal Exceptionijawa.lang.tllegal5tateException: Irvalid characters in username
我基岩版ID是 NEW of world，有什么办法吗？
很有用的教程，感谢楼主分享